README

A Simple, single file Benchmark Script For PHP.

1. Contents

• 1. Contents
• 2. Requirements
• 3. Installation
• 4. Usage
  • 4.1. Usage: Run Single Code
  • 4.2. Usage: Run Multiple Codes
  • 4.3. Usage: Getting Results as an Array
  • 4.4. Usage: Displaying Analyzed Results
  • 4.5. Usage: Getting Analyzed Results as an Array
• 5. Examples
• 6. LICENSE

2. Requirements

• PHP 8.1 or later
• (Optional) git
• (Optional) Composer

3. Installation

There're several options:

• Option 1: Copy or download Benchmark.php to your environment

  and require the code in your PHP, instead of vendor/autoload.php.

  This is the most simple way.

• Option 2: Clone this repository to your envenronment

  git clone https://github.com/macocci7/PHP-Benchmark.git

• Option 3: Download Zip from GitHub Repository

  Click [Code] button and Click [Download Zip].

  Then, extract zip and copy src/Benchmark.php to your environment.

• Option 4: Use Composer

  composer require macocci7/php-benchmark

4. Usage

4.1. Usage: Running Single Code

• PHP:

  <?php
  
  require_once __DIR__ . '/../vendor/autoload.php';
  
  use Macocci7\PhpBenchmark\Benchmark;
  
  Benchmark::code(
      name: 'str_starts_with()',
      callback: fn () => str_starts_with('GPSAltitude', 'GPS'),
      iteration: 10000
  );

• Result:

  1: str_starts_with() => Time: 0.004081 sec  Avg: 0.0000004081 sec
  

4.2. Usage: Running Multiple Codes

• PHP:

  Benchmark::codes(
      callbacks: [
          'str_starts_with()' => fn () => str_starts_with('GPSAltitude', 'GPS'),
          'strpos()' => fn () => strpos('GPSAltitude', 'GPS'),
          'strpbrk()' => fn () => strpbrk('GPSAltitude', 'GPS'),
          'strncmp()' => fn () => 0 === strncmp('GPSAltitude', 'GPS', 3),
          'strstr()' => fn () => strstr('GPSAltitude', 'GPS'),
          'preg_match()' => fn () => preg_match('/^GPS/', 'GPSAltitude'),
          'strcmp() + substr()' => fn () => 0 === strcmp(substr('GPSAltitude', 0, 3), 'GPS'),
          'substr_compare()' => fn () => 0 === substr_compare('GPSAltitude', 'GPS', 0, 3),
      ],
      iteration: 10000,   // default: 1
      sortOrder: "",  // without sorting (default)
      //sortOrder: "asc",     // by time
      //sortOrder: "desc",
  );

• Result:

  1:   str_starts_with() => Time: 0.004008 sec  Avg: 0.0000004008 sec
  2:            strpos() => Time: 0.004001 sec  Avg: 0.0000004001 sec
  3:           strpbrk() => Time: 0.004089 sec  Avg: 0.0000004089 sec
  4:           strncmp() => Time: 0.004177 sec  Avg: 0.0000004177 sec
  5:            strstr() => Time: 0.004057 sec  Avg: 0.0000004057 sec
  6:        preg_match() => Time: 0.004803 sec  Avg: 0.0000004803 sec
  7: strcmp() + substr() => Time: 0.005728 sec  Avg: 0.0000005728 sec
  8:    substr_compare() => Time: 0.004395 sec  Avg: 0.0000004395 sec
  

4.3 Usage: Getting Results as an Array

• PHP:

  var_dump(Benchmark::getResults(
      callbacks: [
          'str_starts_with()' => fn () => str_starts_with('GPSAltitude', 'GPS'),
          'strpos()' => fn () => strpos('GPSAltitude', 'GPS'),
      ],
      iteration: 10000,
  ));

• Result:

  array(2) {
      'str_starts_with()' =>
      array(2) {
          'time' =>
          double(0.003453969955444336)
          'average' =>
          double(3.453969955444336E-7)
      }
      'strpos()' =>
      array(2) {
          'time' =>
          double(0.0038220882415771484)
          'average' =>
          double(3.8220882415771484E-7)
      }
  }
  

4.4 Usage: Displaying Analyzed Results

• PHP:

  Benchmark::analyze(
      callbacks: [
          'str_starts_with()' => fn () => str_starts_with('GPSAltitude', 'GPS'),
          'strpos()' => fn () => strpos('GPSAltitude', 'GPS'),
          'strpbrk()' => fn () => strpbrk('GPSAltitude', 'GPS'),
      ],
      iteration: 10000,
  );

• Result:

  Analyzed Results:
  - Fastest: strpos() (0.003490 sec)
  - Slowest: str_starts_with() (0.003707 sec)
  - Details:
    No.             Name        R2F       R2S   Time          Average   
    -+-------------------+----------+---------+-------------+-----------------
    1: str_starts_with() =>     1.06      1.00  0.003707 sec  0.0000003707 sec  
    2:          strpos() =>     1.00      0.94  0.003490 sec  0.0000003490 sec  
    3:         strpbrk() =>     1.01      0.95  0.003532 sec  0.0000003532 sec  
  

• R2F: represents the ratio to the fastest time.

• R2S: R2F represents the ratio to the slowest time.

4.5 Usage: Getting Analyzed Results as an Array

• PHP:

  var_dump(Benchmark::getAnalyzedResults(
      callbacks: [
          'str_starts_with()' => fn () => str_starts_with('GPSAltitude', 'GPS'),
          'strpos()' => fn () => strpos('GPSAltitude', 'GPS'),
          'strpbrk()' => fn () => strpbrk('GPSAltitude', 'GPS'),
      ],
      iteration: 10000,
  ));

• Result:

  array(3) {
      'fastest' =>
      array(1) {
          'str_starts_with()' =>
          array(2) {
          'time' =>
          double(0.0034110546112060547)
          'average' =>
          double(3.411054611206055E-7)
          }
      }
      'slowest' =>
      array(1) {
          'strpos()' =>
          array(2) {
          'time' =>
          double(0.0037479400634765625)
          'average' =>
          double(3.7479400634765627E-7)
          }
      }
      'details' =>
      array(3) {
          'str_starts_with()' =>
          array(4) {
          'time' =>
          double(0.0034110546112060547)
          'average' =>
          double(3.411054611206055E-7)
          'relative_to_fastest' =>
          double(1)
          'relative_to_slowest' =>
          double(0.9101145038167939)
          }
          'strpos()' =>
          array(4) {
          'time' =>
          double(0.0037479400634765625)
          'average' =>
          double(3.7479400634765627E-7)
          'relative_to_fastest' =>
          double(1.0987628433633885)
          'relative_to_slowest' =>
          double(1)
          }
          'strpbrk()' =>
          array(4) {
          'time' =>
          double(0.0036809444427490234)
          'average' =>
          double(3.6809444427490236E-7)
          'relative_to_fastest' =>
          double(1.0791221080589921)
          'relative_to_slowest' =>
          double(0.9821246819338423)
          }
      }
  }
  

5. Examples

• RunSingleCode.php >> results in RunSingleCode.txt
• RunMultipleCodes.php >> results in RunMultipleCodes.txt
• GetResultsAsAnArray.php >> results in GetResultsAsAnArray.txt
• DisplayAnalyzedResults.php >> results in DisplayAnalyzedResults.txt
• GetAnalyzedResultsAsAnArray.php >> results in GetAnalyzedResultsAsAnArray.txt

6. LICENSE

MIT

Copyright 2024-2025 macocci7.