php profiler

Profiler can run in the following modes

• sampling (stops program every n microseconds and analyzes current stack)
• func (hooks into every function call)
• opcode (hooks into every opcode)

mode can be set through prof.mode ini setting or PROF_MODE env var

Sampling

// a.php
function foo()
{
    for ($i = 0; $i < 10_000_000; $i++) {
    }
}

foo();

php -d prof.mode=sampling a.php

output

total time: 0.076188s

total samples: 70
╭──────────┬───────────╮
│ function │ hits      │
├──────────┼───────────┤
│ foo      │ 70 (100%) │
╰──────────┴───────────╯

Output modes:

• console
• callgrind (will generate callgrind.out file)
• pprof (will generate cpu.pprof file)

can be set throgh prof.output_mode ini setting or PROF_OUTPUT_MODE env var

Additional params

• sampling interval (prof.sampling_interval ini setting or PROF_SAMPLING_INTERVAL env var, default value is 1000 microseconds)
• sampling limit (prof.sampling_limit ini setting or PROF_SAMPLING_LIMIT env var, default value is 20, only in console output mode), show only top n functions
• sampling threshold (prof.sampling_threshold ini setting or PROF_SAMPLING_THRESHOLD env var, default value is 1), show only functions with > n calls

Func

// a.php
function foo()
{
    usleep(1000);
}

foo();

php -d prof.mode=func a.php

output

total time: 0.002287s

╭──────────┬───────────┬───────────┬────────┬───────╮
│ function │ wall      │ cpu       │ memory │ calls │
├──────────┼───────────┼───────────┼────────┼───────┤
│ foo      │ 0.001129s │ 0.000043s │ 448 b  │ 1     │
╰──────────┴───────────┴───────────┴────────┴───────╯

Additional params

• func limit (prof.func_limit ini setting or PROF_FUNC_LIMIT env var, default value is 50), show only top n functions by wall time
• func threshold (prof.func_threshold ini setting or PROF_FUNC_THRESHOLD env var, default value is 0.000001 seconds), show only functions with wall time > n

Opcode

// a.php
function foo()
{
    usleep(1000);
}

foo();

php -d prof.mode=opcode a.php

output

total time: 0.002542s

╭──────────────┬───────────╮
│ opcode       │ time      │
├──────────────┼───────────┤
│ /app/t.php:4 │ 0.001115s │
│ /app/t.php:5 │ 0.000009s │
│ /app/t.php:7 │ 0.000003s │
╰──────────────┴───────────╯

Additional params

• opcode threshold (prof.opcode_threshold ini setting or PROF_OPCODE_THRESHOLD env var, default value is 0), show only opcodes with time > n

Limitations

• for now profiler works only in cli mode

Requirements

• zlib

Installation

phpize
./configure
make
make install

Testing

make test