自己动手用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]#./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("abc.so");
?>

 

在浏览器里运行该文件会出现错误信息，可以在错误信息里得到这个号码，请根据自己情况根据这个号码与你的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("haosoft_php_module.so");
// 调用函数
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这两个文件里的内容，以及有参数、有返回值函数的定义及使用。