本文开发环境为php7,从零开始创建一个PHP扩展,实现一个自定义函数say_hi,调用此函数返回Hello World。开始开发前请先安装php7及下载一份php7源码
一 生成代码
PHP提供了生成基本代码的工具 ext_skel,这个工具在PHP源代码的./ext目录下$ cd php_src/ext/
$ ./ext_skel --extname=say_hi
extname参数的值就是扩展名称,执行ext_skel命令后,会在当前目录下会生成一个与扩展名一样的目录。
二 修改config.m4配置文件
config.m4的作用是配合phpize工具生成configure文件(onfigure文件是用于检测扩展编译运行所需的环境是否满足),现在开始修改config.m4文件$ cd ./say_hi
$ vim ./config.m4
config.m4文件有这样一段文字dnl If your extension references something external, use with:
dnl PHP_ARG_WITH(say, for say support,
dnl Make sure that the comment is aligned:
dnl [ --with-say Include say support])
dnl Otherwise use enable:
dnl PHP_ARG_ENABLE(say, whether to enable say support,
dnl Make sure that the comment is aligned:
dnl [ --enable-say Enable say support])
其中,dnl 是注释符号,上面的代码意思是如果你所编写的扩展依赖其它的扩展或者lib库,需要去掉PHP_ARG_WITH相关代码的注释。否则,去掉 PHP_ARG_ENABLE 相关代码段的注释。我们编写的扩展不需要依赖其他的扩展和lib库。因此,我们去掉PHP_ARG_ENABLE前面的注释。去掉注释后的代码如下:dnl If your extension references something external, use with:
dnl PHP_ARG_WITH(say, for say support,
dnl Make sure that the comment is aligned:
dnl [ --with-say Include say support])
dnl Otherwise use enable:
PHP_ARG_ENABLE(say, whether to enable say support,
Make sure that the comment is aligned:
[ --enable-say Enable say support])
三 实现扩展方法
修改say_hi.c文件来实现say_hi方法,找到PHP_FUNCTION(confirm_say_hi_compiled),在其上面增加如下代码:PHP_FUNCTION(say_hi)
{
zend_string *strg;
strg = strpprintf(0, "Hello World");
RETURN_STR(strg);
}
找到 PHP_FE(confirm_say_hi_compiled,NULL), 在上面增加如下代码:PHP_FE(say_hi, NULL)
修改后的代码如下:const zend_function_entry say_functions[] = {
PHP_FE(say_hi, NULL)
PHP_FE(confirm_say_hi_compiled, NULL) /* For testing, remove later. */
PHP_FE_END /* Must be the last line in say_functions[] */
};
/* }}} */
四 编译安装写好的扩展
$ phpize
$ ./configure
$ make && make install
修改php.ini文件,增加如下代码:extension = say_hi.so
然后执行php -m命令查看已安装扩展,在输出的内容中如果有say_hi则说明安装成功
五 测试
写一个脚本test.php,假如放在home目录,内容如下:<?php
echo say_hi();
然后执行:php ~/test.php
输出Hello World,扩展编写成功