php如何將snappy整合到xhprof

物件介紹
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.2444 /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, 新增如下行：

 ...
 #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.sosnappy相關的函數是否被成功編譯了進去，如下, _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_init

9. 在php腳本裡就可以使用xhprof_compress()和xhrof_uncompress()了