php扩展开发-快速上手

Posted 2020-08-22

系统环境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的函数，但是我们已经把扩展开发的流程和框架搭建起来了，我们可以在这个基础上增加各种我们想要的功能。