gukai/php7-forp

A PHP profiler written in C. dtrace is a lightweight PHP extension which provides the full call stack of your script, with CPU and memory usage, in a plain PHP Array or JSON output.

This package's canonical repository appears to be gone and the package has been frozen as a result.

Maintainers

Details

github.com/Shies/PHP7-forp

Homepage

Source

Issues

Installs: 265

Dependents: 0

Suggesters: 0

Security: 0

Stars: 131

Watchers: 5

Forks: 12

Language:C

dev-master 2021-09-09 12:06 UTC

Requires

  • php: >=5.3

MIT 55b1be7d6515e84acd45a8ac1ba07f77c111fb61

  • ____Shies <2kshies.woop@gmail.com>

phpprofilerqualitybenchmark

This package is auto-updated.

Last update: 2023-01-22 16:13:06 UTC

README

dtrace分析器是一个轻量级的PHP扩展提供脚本的调用堆栈,CPU和内存使用.

总结的特性 :

  • PHP7编译时要使用(--enable-dtrace)
  • PHP7使用时需要设置环境变量(export USE_ZEND_DTRACE=1)
  • 每个函数的时间和分配内存的测量
  • CPU使用率
  • 函数调用的文件和行号
  • 输出为谷歌的跟踪事件格式
  • 字幕功能
  • 分组函数
  • 函数别名（对匿名函数有用）

forp是非侵入性的,它提供了PHP注释来完成工作.

简单例子

Example :

<?php
// 启用分析器
forp_start();

// 这里, 我想要去分析这个函数
function foo()
{
    echo "Hello world !\n";
};

foo();

// 停止分析器
forp_end();

// 获取一个堆栈数组
$profileStack = forp_dump();

print_r($profileStack);

Result :

Hello world !
Array
(
    [utime] => 125
    [stime] => 18
    [stack] => Array
        (
            [0] => Array
                (
                    [file] => /Users/gukai/debug/dtrace/ext/forp/examples/hello.php
                    [function] => {main}
                    [usec] => 99
                    [pusec] => 13
                    [bytes] => 48
                    [level] => 0
                )

            [1] => Array
                (
                    [file] => /Users/gukai/debug/dtrace/ext/forp/examples/hello.php
                    [function] => foo
                    [lineno] => 11
                    [usec] => 42
                    [pusec] => 0
                    [bytes] => 48
                    [level] => 1
                    [parent] => 0
                )

        )

)

例如与注释

Example :

<?php
// 启用分析器
forp_start();

/**
 * 这里，我们要介绍的PHP代码
 * 注释
 *
 * @ProfileGroup("Test")
 * @ProfileCaption("Foo #1")
 * @ProfileAlias("foo")
 */
function fooWithAnnotations($bar)
{
    return 'Foo ' . $bar;
}

echo "foo = " . fooWithAnnotations("bar") . "\n";

// 停止分析器
forp_end();

// 获取一个堆栈数组
$profileStack = forp_dump();

echo "forp stack = \n";
print_r($profileStack);

Result :

foo = Foo bar
forp stack =
Array
(
    [utime] => 269
    [stime] => 24
    [stack] => Array
        (
            [0] => Array
                (
                    [file] => /Users/gukai/debug/dtrace/ext/forp/forp.php
                    [function] => {main}
                    [usec] => 247
                    [pusec] => 15
                    [bytes] => 48
                    [level] => 0
                )

            [1] => Array
                (
                    [file] => /Users/gukai/debug/dtrace/ext/forp/forp.php
                    [function] => foo
                    [lineno] => 18
                    [groups] => Array
                        (
                            [0] => Test
                        )

                    [caption] => Foo bar
                    [usec] => 28
                    [pusec] => 145
                    [bytes] => 80
                    [level] => 1
                    [parent] => 0
                )

        )

)

php.ini 选项

  • forp.max_nesting_level : 默认 50
  • forp.no_internals : 默认 0

forp PHP API

  • forp_start(flags*) : 开始forp收集器
  • forp_end() : 停止forp收集器
  • forp_dump() : 返回堆栈为平面数组
  • forp_print() : 显示forp栈 (SAPI CLI)

forp_start() 标记

  • FORP_FLAG_CPU : 激活时间收集
  • FORP_FLAG_MEMORY : 激活内存使用的收集
  • FORP_FLAG_CPU : 获取cpu使用率
  • FORP_FLAG_CAPTION : 启用文字处理程序
  • FORP_FLAG_ALIAS : 启用别名处理程序
  • FORP_FLAG_GROUPS : 启用组处理程序
  • FORP_FLAG_HIGHLIGHT : 启用HTML高亮显示

forp_dump()

forp_dump() 提供了一个数组组成 :

  • global fields : utime, stime ...
  • stack : 一个扁平的堆栈条目PHP数组.

Global fields :

  • utime : 用户函数调用CPU使用
  • stime : 系统调用CPU使用

一个堆栈条目 :

  • file : 文件名
  • lineno : 所在行号
  • class : 类名
  • function : 方法名
  • groups : 关联组列表
  • caption : 函数的说明
  • usec : 函数的时间(没有剖析开销)
  • pusec : 内部分析时间(没有执行功能)
  • bytes : 内存使用情况的功能
  • level : 从forp_start调用深度水平
  • parent : 父指数(数字)

forp_json()

在标准输出上直接打印堆栈为JSON字符串。 这是最快的方法来发送JSON兼容的客户端堆栈.

看forp_dump()它的结构.

forp_json_google_tracer()

forp_json_google_tracer($filepath) 输出为谷歌的跟踪事件格式.

Usage :

// 启用分析器
forp_start();

my_complex_function();

// 停止分析器
forp_end();

// 获取Json和保存它到文件里
forp_json_google_tracer("/tmp/output.json");

然后, 打开谷歌浏览器输入 chrome://tracing/. 载入输出文件并观看结果.

Example output with an existing Drupal website

forp_inspect()

forp_inspect('symbol', $symbol) 将输出的详细表示在forp_dump()结果变量.

Usage :

$var = array(0 => "my", "strkey" => "inspected", 3 => "array");
forp_inspect('var', $var);
print_r(forp_dump());

Result :

Array
(
    [utime] => 0
    [stime] => 0
    [inspect] => Array
        (
            [var] => Array
                (
                    [type] => array
                    [size] => 3
                    [value] => Array
                        (
                            [0] => Array
                                (
                                    [type] => string
                                    [value] => my
                                )

                            [strkey] => Array
                                (
                                    [type] => string
                                    [value] => inspected
                                )

                            [3] => Array
                                (
                                    [type] => string
                                    [value] => array
                                )

                        )

                )

        )

)

可用的注释

  • @ProfileGroup

设置属于函数的组.

/**
 * @ProfileGroup("data loading","rendering")
 */
function exec($query) {
    /* ... */
}
  • @ProfileCaption

向函数添加说明。标题字符串可能包含引用(# < param num >)的功能参数.

/**
 * @ProfileCaption("Find row for pk #1")
 */
public function findByPk($pk) {
    /* ... */
}
  • @ProfileAlias

给函数赋予别名。对匿名函数有用

/**
 * @ProfileAlias("MyAnonymousFunction")
 */
$fn = function() {
    /* ... */
}
  • @ProfileHighlight

在函数生成的周围高亮输出.

/**
 * @ProfileHighlight("1")
 */
function render($datas) {
    /* ... */
}

安装要求

要求

php5-dev

apt-get install php5-dev

安装composer

要求必须在项目composer.json PHP分析器

"require-dev" : {
  "gukai/php7-forp" : "dev-master"
},
"repositories" : [
  {
     "type" : "git",
     "url"  : "git@github.com:Shies/dtrace.git"
  }
]

run Composer install

php composer.phar install

compile

cd vendor/gukai/dtrace/ext/forp
export USE_ZEND_DTRACE=1
phpize
./configure
make && make install

在你的php.ini里启用forp

extension=forp.so

或选择"老式的"安装

OR dev-master
```sh
git clone https://github.com/Shies/dtrace
cd dtrace/ext/forp

compile

export USE_ZEND_DTRACE=1
phpize
./configure
make && make install

并且在你的php.ini里启用forp

extension=forp.so

测试平台

MacOS

MacOS Sierra/10.12.3 (unix)

Nginx/1.12.0 (web)

PHP 5.6.30 (cli) (built: May 10 2017 19:52:30)

MacOS

MacOS Sierra/10.12.3 (unix)

Nginx/1.12.0 (web)

PHP 7.0.7 (cli) (built: May 17 2017 19:52:30)

贡献者

Anthony Terrien, Ioan Chiriac, Alexis Okuwa, TOMHTML, 2KShies