本文是以PHP7作为基础,讲解如何从零开始创建一个PHP扩展。本文主要讲解创建一个扩展的基本步骤都有哪些。示例中,我们将实现如下功能:
<?php echo say(); ?>
输出内容:
$ php ./test.php $ hello word
在扩展中实现一个say方法,调用say方法后,输出 hello word。
第一步:生成代码
PHP为我们提供了生成基本代码的工具 ext_skel。这个工具在PHP源代码的./ext目录下。
$ cd php_src/ext/ $ ./ext_skel --extname=say
extname参数的值就是扩展名称。执行ext_skel命令后,这样在当前目录下会生成一个与扩展名一样的目录。
第二步,修改config.m4配置文件
config.m4的作用就是配合phpize工具生成configure文件。configure文件是用于环境检测的。检测扩展编译运行所需的环境是否满足。现在我们开始修改config.m4文件。
$ cd ./say $ 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.c文件。实现say方法。
找到PHP_FUNCTION(confirm_say_compiled),在其上面增加如下代码:
PHP_FUNCTION(say) { zend_string *strg; strg = strpprintf(0, "hello word"); RETURN_STR(strg); }
找到 PHP_FE(confirm_say_compiled, 在上面增加如下代码:
PHP_FE(say, NULL)
修改后的代码如下:
const zend_function_entry say_functions[] = { PHP_FE(say, NULL) /* For testing, remove later. */ PHP_FE(confirm_say_compiled, NULL) /* For testing, remove later. */ PHP_FE_END /* Must be the last line in say_functions[] */ }; /* }}} */
第四步,编译安装
编译扩展的步骤如下:
$ phpize $ ./configure $ make && make install
修改php.ini文件,增加如下代码:
[say] extension = say.so
然后执行,php -m 命令。在输出的内容中,你会看到say字样。
第五步,调用测试
自己写一个脚本,调用say方法。看输出的内容是否符合预期。
文章推荐
交流社区
技术交流
原文链接:PHP7扩展开发之hello word,转载请注明来源!
附件源码下载后打不开,提示压缩破损
刚测试,可以正常解压。又上传了一个zip格式的,你可以试试。
多谢,应该是我解压软件的问题,已经解决了
say.c文件在哪来有呢?
你用ext_skel工具,自动生成say.c
哈哈
PHP 7.0.14 ,执行./configure的时候,报错,最后四行是:checking for re2c... re2cchecking for re2c version... 0.14.2 (ok)checking for gawk... gawk./configure: line 4237: syntax error near unexpected token `;;'./configure: line 4237: ` ;;'
第一个php扩展,hello word 不变的主题啊
想请教需要开发扩展的场景多吗,都有哪些
1、一些基础功能,性能成为瓶颈的时候,可以使用扩展实现。如,解析xml文件2、需要调用一些lib库,才能实现的功能。一般需要扩展实现。
666
很不错,文章真是言简意赅,一遍就over!
大神,什么时候有时间把 PHP7扩展 其他给补充完整呢?
之前在知加上学习,知加已经好久不能用了
很好 谢谢分享
我怎么找不到源码在哪下载啊?