系统环境CentOS release 6.5 (Final)
PHP版本php-5.6.27
扩展开发需要有php环境及php的源代码,我的PHP安装目录/home/zhangxiaomin/study/php5627/,源码目录/home/zhangxiaomin/study/php-5.6.27,
ln -s /home/zhangxiaomin/study/php5627/bin/php /home/zhangxiaomin/bin/php5.6 做一个软连接用php5.6代替/home/zhangxiaomin/study/php5627/bin/php
在源码目录ext下新建myext目录,本次开发的扩展所有代码都放在该目录下[/home/zhangxiaomin/study/php-5.6.27/ext/myext],你需要记住这3个目录,后续我们会频繁用到。如果你是刚开始学习扩展,我建议你弄一个和我一样的目录,虽然这看起来有点傻,但是它可以最好的保证你顺利的编译完成,等你熟悉了整个流程之后,你可以按照自己的习惯规划自己的扩展目录,如果你就想自己安排目录,也没有问题,记得在整个的扩展开发过程中,替换掉所有的目录路径,换成你自己的。
首先通过一个简单的项目,让你快速构建自己的一个扩展,有一个直观的感受,然后我们再一步步抽丝剥茧深入其中的每一个知识点,在这个过程中,你很多不太理解,没有关系,你可以先照着做。
创建config.m4文件,该文件告诉 UNIX 构建系统哪些扩展 configure 选项是支持的,你需要哪些扩展库,以及哪些源文件要编译成它的一部分。具体参见http://www.php.net/manual/zh/internals2.buildsys.configunix.php
1 PHP_ARG_ENABLE(myext, whether to enable Myext support, 2 [ --enable-myext Enable Myext support]) 3 if test "$PHP_MYEXT" = "yes"; then 4 PHP_SUBST(MYEXT_SHARED_LIBADD) 5 PHP_NEW_EXTENSION(myext, myext.c, $ext_shared) 6 fi
上面PHP_ARG_ENABLE函数有三个参数,第一个参数是我们的扩展名(不用加引号),第二个参数是当我们运行./configure脚本时显示的内容,最后一个参数则是我们在调用./configure --help时显示的帮助信息。
3行表示当你编译php时如果加上--enable-myext则加载本扩展
4行是固定语法,大写扩展名_SHARED_LIBADD[MYEXT_SHARED_LIBADD]
5行 PHP_NEW_EXTENSION(myext, myext.c, $ext_shared) 第一个参数是扩展名,第二个参数则是扩展的C代码文件,多个文件用空格隔开,比如myext.c myext2.c myext3.c ,第三个参数是固定语法,加上就可以了。
创建php_myext.h文件
1 #ifndef PHP_MYEXT_H //常规用法,解决重复require 2 #define PHP_MYEXT_H 3 #define PHP_MYEXT_VERSION "1.0" //定义版本常量 4 #define PHP_MYEXT_EXTNAME "myext" //定义扩展常量 5 6 PHP_FUNCTION(myext_hello);//函数申明,所有在myext.c文件定义的函数,都会在这个文件里有一个申明 7 8 extern zend_module_entry myext_module_entry;//申明模块注册变量,在myext.c定义 9 #define phpext_myext_ptr &myext_module_entry 10 11 #endif
创建myext.c
1 #ifdef HAVE_CONFIG_H 2 #include "config.h" 3 #endif 4 #include "php.h"//有了这个才能进行扩展开发,Zend的底层类库 5 #include "php_myext.h"//我们自己定义的头文件 6 7 /*{{{ 8 * 9 * */ 10 static zend_function_entry myext_functions[] = { 11 PHP_FE(myext_hello, NULL)//每个函数一行,第一个参数与PHP_FUNCTION(name)的name一样 12 {NULL, NULL, NULL}//固定语法 13 }; 14 /*}}}*/ 15 16 /*{{{定义扩展模块相关 17 * */ 18 zend_module_entry myext_module_entry = { 19 #if ZEND_MODULE_API_NO >= 20010901 20 STANDARD_MODULE_HEADER, 21 #endif 22 "myext",//扩展名称 23 myext_functions,//zend_function_entry myext_functions 定义好的函数扩展变量 24 NULL,//MINIT_FUNCTION 25 NULL,//MSHUTDOWN_FUNCTION 26 NULL,//RINIT_FUNCTION 27 NULL,//RSHUTDOWN_FUNCTION 28 NULL,//MINFO_FUNCTION 29 #if ZEND_MODULE_API_NO >= 20010901 30 PHP_MYEXT_VERSION, 31 #endif 32 STANDARD_MODULE_PROPERTIES 33 }; 34 /*}}}*/ 35 36 /*{{{ 37 *没有这个就不能在php.ini里面动态加载so 38 * */ 39 #ifdef COMPILE_DL_MYEXT 40 ZEND_GET_MODULE(myext) 41 #endif 42 /*}}}*/ 43 44 PHP_FUNCTION(myext_hello) 45 { 46 php_printf("hello you are success"); 47 }
现在在你的myext目录下,应该有三个文件,config.m4 myext.c php_myext.h 接着我们开始编译扩展。
1,/home/zhangxiaomin/study/php5627/bin/phpize 用phpize的工具帮助我们生成各种配置模板文件
2,/home/zhangxiaomin/study/php-5.6.27/ext/myext/configure --with-php-config=/home/zhangxiaomin/study/php5627/bin/php-config 生成makefile文件
3,make
4,make test
5,make install 如果不是少了类库少了权限执行路径不对的话,你应该能顺利看到这句话 Installing shared extensions: /home/zhangxiaomin/study/php5627/lib/php/extensions/debug-zts-20131226/ 这就表示我们的扩展库已经编译完成了,接着需要把编译生成的myext.so的库加到php.ini中去
6,cp -rpf /home/zhangxiaomin/study/php-5.6.27/php.ini-development /home/zhangxiaomin/study/php5627/lib/php.ini 复制一份php.ini文件
7,编辑/home/zhangxiaomin/study/php5627/lib/php.ini文件
1 ;搜索extension_dir做以下修改 2 extension_dir = "/home/zhangxiaomin/study/php5627/lib/php/extensions/debug-zts-20131226/" 3 4 ;在文件末尾添加以下部分 5 [myext] 6 extension=myext.so
8,php5.6 -m | grep myext 检测扩展是否成功安装,如果你看到了myext,那恭喜你。
9,在/home/zhangxiaomin/study/php-5.6.27/ext/myext/目录下新建一个test.php的文件,用来运行我们编写的扩展的函数。
1 <?php 2 myext_hello();
10,php5.6 test.php //hello you are success
至此我们的扩展安装完成了,尽管它看起来很简单,也没有实际作用,只有一个myext_hello的函数,但是我们已经把扩展开发的流程和框架搭建起来了,我们可以在这个基础上增加各种我们想要的功能。