Scripts for benchmarking various PHP implementations when running open source software.
Hack PHP Shell
Switch branches/tags
Nothing to show
Latest commit e783511 Jul 28, 2017 @kevand900 kevand900 committed with mofarrell Adding a command line option to specify a remote Siege client. (#83)
Please note you must set up privileged SSH connection between the Server and Client.
It is also necessary to modify IP tables to allow INPUT and OUTPUT between Server and Client.
Remote Client is specified by --remote-siege=<user>@<host>, and is to be paried with --i-am-not-benchmarking.


The goal is to provide a benchmark suite, testing something representative of real-world situations. This suite also includes some unrealistic microbenchmarks - comparing the results of these is fairly pointless, however they can still be useful to profile, to find optimization opportunities that may carry over to a real site.

This script configures and runs nginx, siege, and PHP5/PHP7/HHVM over FastCGI, over a TCP socket. Configuration is as close to identical as possible.

The script will run 300 warmup requests, then as many requests as possible in 1 minute. Statistics are only collected for the second set of data.


We don't have anything to share yet - we want to standardize and document how the interpreters are built/installed first.


As a regular user:

composer.phar install # see
hhvm perf.php --wordpress --php5=/path/to/bin/php-cgi # also works with php7
hhvm perf.php --wordpress --php=/path/to/bin/php-fpm # also works with php7
hhvm perf.php --wordpress --hhvm=/path/to/hhvm

Running with --hhvm gives some additional server-side statistics. It is usual for HHVM to report more requests than siege - some frameworks do call-back requests to the current webserver.

❗️ If you run with a debug build you may hit timeouts and other issues.

Batch Usage

If you want to run multiple combinations:

composer.phar install # see
hhvm batch-run.php < batch-run.json > batch-run-out.json

See batch-run.json.example to get an idea of how to create batch-run.json.


On Ubuntu you can run scripts/ This should provision your machine with everything you need to begin running the benchmarks.

This installs:

  • composer
  • nginx
  • siege (versions 2.x, or 3.1.x or 4.0.3)
  • unzip
  • A mysql server on
  • hhvm

I've been using the current versions available from yum on Centos 6.3. HHVM is required as this is written in Hack.

Siege 3.0.x is not supported; as of writing, all 3.0.x releases have bugs that make it unable to correctly make the benchmark requests. 4.0.0, 4.0.1, 4.0.2 all automatically request resources on pages, and should not be used for benchmarking.

The Targets


Unrealistic microbenchmarks. We do not care about these results - they're only here to give a simple, quick target to test that the script works correctly.

'hello, world' is useful for profiling request handling.


  • Data comes from installing the demo-data-creator plugin (included) on a fresh install of WordPress, and clicking 'generate data' in the admin panel a bunch of times.

  • DISABLE_WP_CRON is set to true to disable the auto-update and other requests to and

    • auto-updating is not suitable for a like-to-like benchmark system like this
    • WP_CRON increases noise, as it makes the benchmark results include the time taken by external sites
    • serious deployments should trigger the WP_CRON jobs via cron or similar:
      • an administrator should be aware of all production changes, especially code version changes
      • scheduled maintainance should not make an unfortunate end-user request take significantly more time
  • URLs file is based on traffic to - request ratios are:

    100: even spread over long tail of posts 50: WP front page. This number is an estimate - we get ~ 90 to /, ~ 1 to /blog/. Assuming most wordpress sites don't have our magic front page, so taking a value roughly in the middle. 40: RSS feed 5: Some popular post 5: Some other popular post 3: Some other not quite as popular post

The long tail was generated with:

  for ($i = 0; $i <= 52; ++$i) {
  printf("http://localhost:__HTTP_PORT__/?p=%d\n", mt_rand(1,52));

Ordering of the URLs file is courtesy of the unix 'shuf' command.

Drupal 7

Aims to be realistic. Demo data is from devel-generate, provided by the devel module. Default values were used, except:

  • Users were spread over the last year, rather than the last week
  • New main menus and navigation menus were created
  • New articles and pages were created, with up to 30 comments per content, spread over the last year instead of the last week

As well as the database dump, the static files generated by the above process (user images, images embedded in content) have also been included.

Drupal 8

As above, aims to be realistic. Demo data is from the devel_generate module and default values were used, except:

  • Users spread over the last year
  • One new menu was created and the navigation menu replaced with 15 items each
  • New articles and pages, up to 30 comments per node, spread over the last year

The structure is similar to the Drupal 7 target, except for:

  • The settings.php.gz has been replaced by a settings.tar.gz which includes a settings.php, services.yml, and setup.php file.
  • The setup.php file is used to pre-populate the Twig template cache so that Repo Authoritative mode can be used.
  • A Drupal 8-compatible version of Drush 8 is included with a matching vendor directory. This is used to run the above setup script.


The upstream installation script provides an option to create demonstration data - this was used to create the database dump included here.

There are two unrealistic microbenchmarks:

  • just the login page - the page with the username/password form. Added to confirm a reported issue.
  • just the logged-in home page. Added to be a little more realistic than rendering the form, however we have no idea what a realistic request distribution would look like


Unrealistic microbenchmark: just the 'You have arrived' page from an empty installation.

Laravel 4 and 5 are both available.


  • Data is official Magento sample data, however because of its original size we have replaced all images with a compressed HHVM logo and removed all mp3 files.
  • After importing sample data we use the Magento console installer to do the installation for us.
  • URLs are a variety of different pages:
    • Homepage
    • Category page
    • CMS page
    • Quicksearch
    • Advanced search
    • Simple product
    • Product with options
    • Product reviews


The main page is the Barack Obama page from Wikipedia; this is based on the Wikimedia Foundation using it as a benchmark, and finding it fairly representative of Wikipedia. A few other pages (HHVM, talk, edit) are also loaded to provide a slightly more rounded workload.



perf.php can keep the suite running indefinitely:

hhvm perf.php --i-am-not-benchmarking --no-time-limit --wordpress --hhvm=$HHVM_BIN

You can then attach 'perf' or another profiler to the running HHVM or php-cgi process, once the 'benchmarking' phase has started.

There is also a script to run perf for you at the apropriate moment:

hhvm perf.php --i-am-not-benchmarking --wordpress --hhvm=$HHVM_BIN --exec-after-warmup="./scripts/ -e cycles"

This will record 25 seconds of samples. To see where most time is spent you can dive into the data using perf, or use the perf rollup script as follows:

sudo perf script -F comm,ip,sym | hhvm -vEval.EnableHipHopSyntax=true <HHVM SRC>/hphp/tools/perf-rollup.php

In order to have all the symbols from the the translation cache you may need to change the owner of /tmp/ to root.


TC-print will use data from perf to determine the hotest functions and translations. Run the benchmark as follows:

hhvm perf.php --i-am-not-benchmarking --wordpress --hhvm=$HHVM_BIN --exec-after-warmup="./scripts/ -e cycles" --tcprint

In order to have all the symbols from the the translation cache you may need to change the owner of /tmp/ to root.

We process the perf data before passing it along to tc-print sudo perf script -f -F hw:comm,event,ip,sym | /hphp/tools/ >

tc-print is only built if the appropriate disassembly tools are available. On x86 this is LibXed. Consider building hhvm using:

cmake . -DLibXed_INCLUDE_DIR=<path to xed include> -DLibXed_LIBRARY=<path to libxed.a>

Use tc-print with the generated hphp/tools/tc-print/tc-print -c /tmp//conf.hdf -p


Please see for details.