开发一个PHP扩展入门

本文通过非常快速的方式讲解了如何制作一个PHP 5.2 环境的扩展（PHP Extension），希望能够在图文的方式下让想快速学习的朋友了解一下制作过程。

需求：比如开发一个叫做 heiyeluren 的扩展，扩展里就一个函数 heiyeluren_test()，输入一个字符串，函数返回：Your input string: xxxxx。
要求：了解C/C++编程，熟悉PHP编程
环境：下载一份php对应版本的源码，我这里是 php-5.2.6，先正常安装php，假设我们的php安装在 /usr/local/php 目录，源码在 /root/soft/php/php-5.2.6/，现在开始！

步骤一：生成扩展框架

cd /root/soft/php/php-5.2.6/ext
./ext_skel --extname=heiyeluren
cd /root/soft/php/php-5.2.6/ext/heiyeluren
vi config.m4
打开文件后去掉 dnl ，获得下面的信息：
PHP_ARG_ENABLE(heiyeluren, whether to enable heiyeluren support,
[ --enable-heiyeluren Enable heiyeluren support])

博主ddcoder注：博主用的是PHP 5.5.27，此处有三行，和文中稍有不同
保存退出.

第二步：编写代码

vi php_heiyeluren.h
找到：PHP_FUNCTION(confirm_heiyeluren_compiled); ，新增一行：
PHP_FUNCTION(heiyeluren_test);
保存退出。

vi heiyeluren.c
数组里增加我们的函数，找到 zend_function_entry heiyeluren_functions[]，增加：
PHP_FE(heiyeluren, NULL)

再到 heiyeluren.c 文件最后面增加如下代码：
PHP_FUNCTION(heiyeluren_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.6/ext/heiyeluren
/usr/local/php/bin/phpize
./configure --with-php-config=/usr/local/php/bin/php-config
make
make test
make install
现在看看是不是有个 /usr/local/php/lib/php/extensions/no-debug-non-zts-20060613/heiyeluren.so
编辑php.ini，把扩展加入进去：
vi /usr/local/php/lib/php.ini
在[PHP]模块下增加：
extension = heiyeluren.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]
...
heiyeluren
...
[Zend Modules]

然后重启apache，输出 phpinfo() ，应该能够看到：
heiyeluren
heiyeluren support enabled

看看函数是否存在并且调用，在web目录下建立：heiyeluren.php
<?php
echo "<pre>";
print_r(get_loaded_extensions());
print_r(get_extension_funcs('heiyeluren'));
echo heiyeluren_test('My first php extension');
echo "</pre>";
?>
访问apache，应该能够看到：
Array
(
...
[33] => heiyeluren
)
Array
(
[0] => confirm_heiyeluren_compiled
[1] => heiyeluren_test
)
Your input string: heiyeluren

扩展制作成功！

更深入内容请参考这里：
http://blog.csdn.net/taft/archive/2006/02/10/596291.aspx
http://www.laruence.com/2009/04/28/719.html

PHP Extensions Made Eldrich
http://www.snailinaturtleneck.com/blog/2011/08/11/php-extensions-made-eldrich-installing-php/
http://www.snailinaturtleneck.com/blog/2011/08/11/php-extensions-made-eldrich-hello-world/
http://www.snailinaturtleneck.com/blog/2011/08/11/php-extensions-made-eldrich-php-variables/
http://www.snailinaturtleneck.com/blog/2011/08/11/php-extensions-made-eldrich-classes/

zend.com
http://devzone.zend.com/303/extension-writing-part-i-introduction-to-php-and-zend/
http://devzone.zend.com/317/extension-writing-part-ii-parameters-arrays-and-zvals/
http://devzone.zend.com/446/extension-writing-part-iii-resources/

 

原文地址：http://blog.linuxphp.org/archives/1564/

 

博主注：这一篇是一篇无错的教程，跟着上面的步骤做下来，可以写出一个最简单的扩展，已通过验证！