快速开发一个PHP扩展(SO组件)教程

五郎.

本文通过非常快速的方式讲解了如何制作一个PHP 5.2 环境的扩展（PHP Extension），希望能够在图文的方式下让想快速学习的朋友了解一下制作过程。
需求：比如开发一个叫做 lanhaicode 的扩展，扩展里就一个函数 lanhai_test()，输入一个字符串，函数返回：Your input string: xxxxx。
要求：了解C/C++编程，熟悉PHP编程
环境：下载一份php对应版本的源码，我这里是 php-5.2.17，先正常安装php，假设我们的php安装在 /usr/local/php 目录，源码在 /root/soft/php/php-5.2.17/，现在开始！
php-5.2.17下载地址：
http://blog.lrenwang.com/down/soft/php-5.2.17.tar.bz2
解压： tar -vxjf php-5......tar.bz2

步骤一：生成扩展框架

cd /root/soft/php/php-5.2.17/ext
./ext_skel --extname=lanhaicode
cd /root/soft/php/php-5.2.17/ext/lanhaicode
vi config.m4

打开文件后去掉 dnl ，获得下面的信息：

PHP_ARG_ENABLE(lanhaicode, whether to enable lanhaicode support,
[ --enable-lanhaicode Enable lanhaicode support])

保存退出.
第二步：编写代码

vi php_lanhaicode.h

找到：PHP_FUNCTION(confirm_lanhaicode_compiled); 新增一行：

PHP_FUNCTION(lanhai_test);

保存退出。

vi lanhaicode.c

数组里增加我们的函数，找到 zend_function_entry lanhaicode_functions[]，增加：

PHP_FE(lanhaicode, NULL)


再到 lanhaicode.c 文件最后面增加如下代码：

PHP_FUNCTION(lanhai_test)
{
char *arg = NULL;
int arg_len, len;
char *strg;
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &arg, &arg_len) == FAILURE) {
return;
}
len = spprintf(&strg, 0, "Your input string: %s\n", arg);
RETURN_STRINGL(strg, len, 0);
}

保存退出。
第三步：编译安装

cd /root/soft/php/php-5.2.17/ext/lanhaicode
/usr/local/php/bin/phpize
./configure --with-php-config=/usr/local/php/bin/php-config
make
make test
make install


（如果不知phpize所在位置，使用命令find / -name "phpize" 进行搜索。如果没有搜索到，请先安装php-devel，命令：yum -y install php-devel）

./configure过程中出现如下错误:
checking for gcc... no
checking for cc... no
checking for cc... no
checking for cl... no
configure: error: no acceptable C compiler found in $PATH
See `config.log' for more details.
解决办法：安装GCC软件套件，执行命令：
yum install -y gcc

现在看看是不是有个 /usr/local/php/lib/php/extensions/no-debug-non-zts-20060613/lanhaicode.so
编辑php.ini，把扩展加入进去：

vi /usr/local/php/lib/php.ini

在[PHP]模块下增加：
extension = lanhaicode.so
保存退出。
注意：如果你不存在扩展文件目录，或者安装报错，那么可以自行建立这个目录，然后把扩展拷贝到目录下，然后记得把 php.ini 文件中的 extension_dir 修改为该目录：
extension_dir = "/usr/local/php/lib/php/extensions/no-debug-non-zts-20060613/"
第四步：检查安装结果
现在看看模块加载了没有：
/usr/local/php/bin/php -m，应该会打印出：
[PHP Modules]
...
lanhaicode
...
[Zend Modules]

然后重启apache，输出 phpinfo() ，应该能够看到：
lanhaicode
lanhaicode support enabled
看看函数是否存在并且调用，在web目录下建立：lanhaicode.php

<?php
echo "<pre>";
print_r(get_loaded_extensions());
print_r(get_extension_funcs('lanhaicode'));
echo lanhai_test('My first php extension');
echo "</pre>";
?>