自己动手用C扩展PHP（一）

2004

　　首先，我们应该选择如何去构建我们的扩展模块，有三种方式：
　　
　　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]#./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[256];
　　    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）我们将在下一篇文章讲解它的意思。
　　
　　[ext]# 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文件，接下来，连接：
　　
　　[ext]# 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文件。然后我们要建立一个目录：
　　
　　[ext]# 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移动到刚刚的目录里去：
　　
　　[ext]# 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源代码包根目录，执行：
　　
　　[php-5.0.6]#./buildconf --force
[php-5.0.6]#./configure --enable-haosoft_php_module ... 也许你还有其他选项
[php-5.0.6]#make
[php-5.0.6]#make install
[php-5.0.6]#sh /etc/init.d/httpd restart ... 这里是重启 apache
　　
　　本示例在我PHP 5.0.6上编译通过。下一章我们再详细分析haosoft_php_module.h和haosoft_php_module.c这两个文件里的内容，以及有参数、有返回&#20540;函数的定义及使用。