Introduction

PHP7-forp分析器是一个轻量级的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/bilibili/debug/PHP7-forp/ext/forp/examples/hello.php
                    [function] => {main}
                    [usec] => 99
                    [pusec] => 13
                    [bytes] => 48
                    [level] => 0
                )

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

        )

)

注释的示例

Example :

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

/**
 * 这里, 我想要去分析这个函数
 * 与注释
 *
 * @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/bilibili/debug/PHP7-forp/ext/forp/forp.php
                    [function] => {main}
                    [usec] => 247
                    [pusec] => 15
                    [bytes] => 48
                    [level] => 0
                )

            [1] => Array
                (
                    [file] => /Users/bilibili/debug/PHP7-forp/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/. 载入输出文件并观看结果.

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

需要在您的项目中PHP7-forp composer.json

"require-dev":       {
  "gukai/php7-forp" : "dev-master"
},
"repositories" : [
  {
     "type" : "git",
     "url"  : "[email protected]:Shies/PHP7-forp.git"
  }
]

run Composer install

php composer.phar install

compile

cd vendor/Shies/PHP7-forp/ext/forp
export USE_ZEND_DTRACE=1
phpize
./configure
make && make install

在你的php.ini里启用forp

extension=forp.so

或选择 "old school" 安装

OR dev-master
```sh
git clone https://github.com/Shies/PHP7-forp
cd PHP7-forp/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, _____Shies

misuoka / php7-forp Goto Github PK

php7-forp's Introduction

Introduction

一个简单的列子

注释的示例

php.ini 选项

forp PHP API

forp_start() 标记

forp_dump()

forp_json()

forp_json_google_tracer()

forp_inspect()

可用的注释

安装必须

必须

安装composer

或选择 "old school" 安装

测试平台

MacOS

MacOS

贡献者

php7-forp's People

Contributors

Watchers

Recommend Projects

Recommend Topics

Recommend Org