2004 发表于 2015-8-28 14:04:18

自己动手用C扩展PHP(一)

  首先,我们应该选择如何去构建我们的扩展模块,有三种方式:
  
  1、External Modules:外部模块,也就是编译成共享库,用dl()函数动态加载。
  
  好处:
  (1)不需要重新编译PHP
(2)PHP体积小,因为不需要编译进PHP
  
  缺点:
  (1)每次*.php脚本执行都需要用dl()去加载,效率较低
(2)每次都要调用dl()
  
  2、Built-in Modules:编译进PHP
  
  好处:
  (1)不需要动态加载,模块在php脚本里面可以直接使用。
(2)不需要将模块编译成.so共享库,因为直接编译进PHP。
  
  缺点:
  (1)对模块的改变都需要重新编译PHP
(2)因为编译进PHP,所以PHP二进制文件较大,而且多占点内存
  
  3、The Zend Engine:Zend核心里实现(略……有兴趣的话可以看Zend API)
  
  Note:本人推荐用第2种方式,直接编译进PHP,但是在下面示例里,我们编译成外部模块,因为,外部模块不需要重新编译PHP,所以在测试阶段先编译成共享库,然后用dl()加载(不过记得在php.ini里将安全模式设为Off),测试完后再用第2种方式重新编译进PHP。
  
  一、首先下载PHP源代码,解压。然后我们开始构建代码结构,可以利用PHP源代码包ext目录里提供的ext_skel程序去生成我们需要的结构。
  
  #./ext_skel --extname=haosoft_php_module
  
  这样会在ext下生成一个haosoft_php_module目录。目录里有config.m4、haosoft_php_module.h和haosoft_php_module.c等几个文件。
  
  二、haosoft_php_module.h为模块的头文件(熟悉C语言的应该了解),用VI打开,删除其中的一行:
  
  PHP_FUNCTION(confirm_MyExt_compiled);
  
  改为:
  
  PHP_FUNCTION(haosoft_test);
  
  说明:PHP_FUNCTION()是一个Zend Macro,作用是声名一个C函数,使他在PHP脚本里可用。参数是函数的名字,我们这里的示例函数为haosoft_test。
  
  三、haosoft_php_module.c为主文件,里面包含了实现,VI打开,我们删除掉
  
  PHP_FUNCTION(confirm_MyExt_compiled)
{
    char *arg = NULL;
    int arg_len, len;
    char string;
      if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &arg, &arg_len) == FAILURE)
    {
      return;
    }
      len = sprintf(string, "Congratulations! You have successfully modified ext/%.78s/config.m4. Module %.78s is now compiled into PHP.", "haosoft_php_module",arg);
  
      RETURN_STRINGL(string, len, 1);
}
  
  增加:
  
  PHP_FUNCTION(haosoft_test)
{
    zend_printf("This is my php module !");
}
  
  四、现在,我们开始编译我们的模块,因为要编译成so,我们选择手工编译。
  
  进入ext目录:
  
  开始编译,编译成*.o对象文件,注意这个"-DCOMPILE_DL_HAOSOFT_PHP_MODULE",在haosoft_php_module.c里你可以找到下面的语句:
  
  #ifdef COMPILE_DL_HAOSOFT_PHP_MODULE
ZEND_GET_MODULE(haosoft_php_module)
#endif
  
  HAOSOFT_PHP_MODULE是大写模块名,你可以换成其他名,但是必须保证这个预处理常量与上面的语句里一致,至于上面语句的ZEND_GET_MODULE(haosoft_php_module)我们将在下一篇文章讲解它的意思。
  
  # cc -fpic -DCOMPILE_DL_HAOSOFT_PHP_MODULE=1 -I/usr/local/include -I. -I../main -I.. -I../TSRM -I../Zend -c -o haosoft_php_module/haosoft_php_module.o haosoft_php_module/haosoft_php_module.c
  
  执行完之后会在目录下生成一个haosoft_php_module.o文件,接下来,连接:
  
  # cc -shared -L/usr/local/lib -rdynamic -o haosoft_php_module/haosoft_php_module.so haosoft_php_module/haosoft_php_module.o
  
  这样会在目录下生成了我们需要的haosoft_php_module.so文件。然后我们要建立一个目录:
  
  # mkdir -p /usr/local/php/lib/php/extensions/no-debug-non-zts-20041030
  
  上面的20041030的号码是Zend内部模块API号码,如果你不知道的话,你先建立一个php文件test.php:
  
  <?php
dl(&quot;abc.so&quot;);
?>
  
  在浏览器里运行该文件会出现错误信息,可以在错误信息里得到这个号码,请根据自己情况根据这个号码与你的PHP安装目录更改路径。建立完目录后接下来,我们把haosoft_php_module.so移动到刚刚的目录里去:
  
  # mv haosoft_php_module/haosoft_php_module.so /usr/local/php/lib/php/extensions/no-debug-non-zts-20041030
  
  OK!我们可以测试刚建立的模块了,目前模块里只有一个haosoft_test()的无参数方法。建立PHP文件test.php:
  
  <?php
// 加载刚建立的模块
dl(&quot;haosoft_php_module.so&quot;);
// 调用函数
haosoft_test();
?>
  
  执行。 看到显示“This is my module !”了吗?
  
  五、好了,模块编译并测试无误后,我们可以将他编译进PHP了,回到PHP源代码包根目录,执行:
  
  #./buildconf --force
#./configure --enable-haosoft_php_module ... 也许你还有其他选项
#make
#make install
#sh /etc/init.d/httpd restart ... 这里是重启 apache
  
  本示例在我PHP 5.0.6上编译通过。下一章我们再详细分析haosoft_php_module.h和haosoft_php_module.c这两个文件里的内容,以及有参数、有返回值函数的定义及使用。
页: [1]
查看完整版本: 自己动手用C扩展PHP(一)