对象介绍
xhprof:php的性能分析工具，由facebook开发的php扩展，能够记录php脚本运行过程中的函数/类方法的调用链，以及每次调用消耗的时间，内存使用量等数据；
snappy:google开发的字符串压缩/解压缩工具，优点是压缩速度快。
目标
在xhprof扩展里提供两个PHP函数xhprof_compress($str)和xhprof_uncompress($str)，实现压缩和解压缩的功能。
具体过程
1. 下载xhprof源码到 php-5.6.24/ext/xhprof
2. 按照正常方式./configure, make，确保xhprof.so工作正常
3. 下载snappy源码到php-5.6.24/ext/xhprof/snappy
4. 编辑文件php-5.6.24/ext/xhprof/php_xhprof.h, 添加如下行：
...
PHP_FUNCTION(xhprof_compress);
PHP_FUNCTION(xhprof_uncompress);
...
5. 编辑文件php-5.6.24/ext/xhprof/xhprof.c, 添加如下行：
Zend_API 深入_PHP_内核
下载
”扩展PHP“说起来容易做起来难。PHP已经进化成一个日趋成熟的源码包几十兆大小的工具。要骇客如此复杂的一个系统，不得不学习和思考。构建本章内容时，我们最终选择了“在实战中学习”的方式。这不是最科学也不是最专业的方式，但是此方式最有趣，也得出了最好的最终结果。下面的部分，你将先快速的学习到，如何获得最基本的扩展，且这些扩展立即就可运行。然后你将学习到 Zend 的高级 API 功能，这种方式将不得
立即学习“PHP免费学习笔记（深入）”；
...
#include "snappy/snappy-c.h"
...
zend_function_entry xhprof_functions[] = {
...
PHP_FE(xhprof_compress, NULL)
PHP_FE(xhprof_uncompress, NULL)
...
};
PHP_FUNCTION(xhprof_compress)
{
zval *data;
char *output;
size_t output_len;
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC,
"z", &data) == FAILURE) {
RETURN_FALSE;
}
if (Z_TYPE_P(data) != IS_STRING) {
zend_error(E_WARNING,
"snappy_compress : expects parameter to be string.");
RETURN_FALSE;
}
output_len = snappy_max_compressed_length(Z_STRLEN_P(data));
output = (char *)emalloc(output_len);
if (!output) {
zend_error(E_WARNING, "snappy_compress : memory error");
RETURN_FALSE;
}
if (snappy_compress(Z_STRVAL_P(data), Z_STRLEN_P(data),
output, &output_len) == SNAPPY_OK) {
#if ZEND_MODULE_API_NO >= 20141001
RETVAL_STRINGL(output, output_len);
#else
RETVAL_STRINGL(output, output_len, 1);
#endif
} else {
RETVAL_FALSE;
}
efree(output);
}
PHP_FUNCTION(xhprof_uncompress)
{
zval *data;
char *output = NULL;
size_t output_len;
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC,
"z", &data) == FAILURE) {
RETURN_FALSE;
}
if (Z_TYPE_P(data) != IS_STRING) {
zend_error(E_WARNING,
"snappy_uncompress : expects parameter to be string.");
RETURN_FALSE;
}
if (snappy_uncompressed_length(Z_STRVAL_P(data), Z_STRLEN_P(data),
&output_len) != SNAPPY_OK) {
zend_error(E_WARNING, "snappy_uncompress : output length error");
RETURN_FALSE;
}
output = (char *)emalloc(output_len);
if (!output) {
zend_error(E_WARNING, "snappy_uncompress : memory error");
RETURN_FALSE;
}
if (snappy_uncompress(Z_STRVAL_P(data), Z_STRLEN_P(data),
output, &output_len) == SNAPPY_OK) {
#if ZEND_MODULE_API_NO >= 20141001
RETVAL_STRINGL(output, output_len);
#else
RETVAL_STRINGL(output, output_len, 1);
#endif
} else {
zend_error(E_WARNING, "snappy_uncompress : data error");
RETVAL_FALSE;
}
efree(output);
}
...以上代码非原著，取自snappy的PHP扩展：php-ext-snappy
6. 编辑config.m4文件指定snappy的编译方式
完整的config.m4代码如下，将直接将snappy编辑进xhprof.so。更好的方式应该是先检查当前主机有没有安装snappy，如果有的话指定链接库路径，就不需要将snappy相关函数编译进xhprof.so里面了。
PHP_ARG_ENABLE(xhprof, whether to enable xhprof support, [ --enable-xhprof Enable xhprof support]) dnl compiler C++: PHP_REQUIRE_CXX() dnl snappy SNAPPY_MAJOR="1" SNAPPY_MINOR="1" SNAPPY_PATCHLEVEL="3" AC_PROG_CXX AC_LANG([C++]) AC_C_BIGENDIAN AC_CHECK_HEADERS([stdint.h stddef.h sys/mman.h sys/resource.h windows.h byteswap.h sys/byteswap. h sys/endian.h sys/time.h]) AC_CHECK_FUNC([mmap]) AC_MSG_CHECKING([if the compiler supports __builtin_expect]) AC_TRY_COMPILE(, [ return __builtin_expect(1, 1) ? 1 : 0 ], [ snappy_have_builtin_expect=yes AC_MSG_RESULT([yes]) ], [ snappy_have_builtin_expect=no AC_MSG_RESULT([no]) ]) if test x$snappy_have_builtin_expect = xyes ; then AC_DEFINE([HAVE_BUILTIN_EXPECT], [1], [Define to 1 if the compiler supports __builtin_expect.]) fi AC_MSG_CHECKING([if the compiler supports __builtin_ctzll]) AC_TRY_COMPILE(, [ return (__builtin_ctzll(0x100000000LL) == 32) ? 1 : 0 ], [ snappy_have_builtin_ctz=yes AC_MSG_RESULT([yes]) ], [ snappy_have_builtin_ctz=no AC_MSG_RESULT([no]) ]) if test x$snappy_have_builtin_ctz = xyes ; then AC_DEFINE([HAVE_BUILTIN_CTZ], [1], [Define to 1 if the compiler supports __builtin_ctz and friends.]) fi if test "$ac_cv_header_stdint_h" = "yes"; then AC_SUBST([ac_cv_have_stdint_h], [1]) else AC_SUBST([ac_cv_have_stdint_h], [0]) fi if test "$ac_cv_header_stddef_h" = "yes"; then AC_SUBST([ac_cv_have_stddef_h], [1]) else AC_SUBST([ac_cv_have_stddef_h], [0]) fi if test "$ac_cv_header_sys_uio_h" = "yes"; then AC_SUBST([ac_cv_have_sys_uio_h], [1]) else AC_SUBST([ac_cv_have_sys_uio_h], [0]) fi AC_SUBST([SNAPPY_MAJOR]) AC_SUBST([SNAPPY_MINOR]) AC_SUBST([SNAPPY_PATCHLEVEL]) AC_CONFIG_FILES([snappy/snappy-stubs-public.h]) AC_OUTPUT dnl Check for stdc++ LIBNAME=stdc++ AC_MSG_CHECKING([for stdc++]) AC_LANG_SAVE AC_LANG_CPLUSPLUS AC_TRY_COMPILE( [ #include <string> using namespace std; ],[ string dummy; ],[ AC_MSG_RESULT(yes) PHP_ADD_LIBRARY($LIBNAME, , XHPROF_SHARED_LIBADD) ],[ AC_MSG_ERROR([wrong stdc++ library not found]) ]) AC_LANG_RESTORE PHP_SUBST(XHPROF_SHARED_LIBADD) dnl Sources SNAPPY_SOURCES="snappy/snappy-c.cc snappy/snappy.cc snappy/snappy-stubs-internal.cc snappy/ snappy-sinksource.cc" if test "$PHP_XHPROF" != "no"; then PHP_NEW_EXTENSION(xhprof, xhprof.c $SNAPPY_SOURCES, $ext_shared) fi
以上代码非原著，取自snappy的PHP扩展：php-ext-snappy
7. 重新执行phpize后，执行make,生成新的xhprof.so
8. 执行命令nm xhprof.so查看snappy相关的函数是否被成功编译了进去，如下, _snappy_compress,_snappy_uncompress等的内存地址均为非空，说明都编译进了xhprof.so中。
➜ xhprof nm modules/xhprof.so
0000000000008a98 s GCC_except_table10
0000000000008ad8 s GCC_except_table11
0000000000008b24 s GCC_except_table12
0000000000008b70 s GCC_except_table13
0000000000008bb0 s GCC_except_table14
0000000000008bfc s GCC_except_table16
0000000000008c48 s GCC_except_table18
0000000000008cbc s GCC_except_table19
0000000000008d4c s GCC_except_table23
00000000000088f4 s GCC_except_table5
0000000000008934 s GCC_except_table7
0000000000008a0c s GCC_except_table8
0000000000008a4c s GCC_except_table9
...
0000000000002510 T _restore_cpu_affinity
0000000000003f00 T _snappy_compress
0000000000003f60 T _snappy_max_compressed_length
0000000000003f70 T _snappy_uncompress
0000000000003fe0 T _snappy_uncompressed_length
0000000000004000 T _snappy_validate_compressed_buffer
...
U _zend_register_long_constant
U _zend_unregister_ini_entries
00000000000013a0 T _zif_xhprof_compress
0000000000001090 T _zif_xhprof_disable
0000000000001350 T _zif_xhprof_dump
0000000000001040 T _zif_xhprof_enable
0000000000001200 T _zif_xhprof_sample_disable
00000000000011e0 T _zif_xhprof_sample_enable
0000000000001470 T _zif_xhprof_uncompress
0000000000001700 T _zm_activate_xhprof
0000000000001720 T _zm_deactivate_xhprof
0000000000001960 T _zm_info_xhprof
0000000000001660 T _zm_shutdown_xhprof
0000000000001560 T _zm_startup_xhprof
0000000000001f00 t _zval_dump
U _zval_used_for_init9. 在php脚本里就可以使用xhprof_compress()和xhrof_uncompress()了
