just do it

基于PHP7的PHP扩展开发之一(hello word)

为什么要学PHP扩展开发?学会PHP扩展开发后,能增加你解决问题的能力。如,别人用PHP实现了一个功能。执行一次需要耗时10毫秒。而你用扩展实现了同样的功能,可能就只用1毫秒。

PHP扩展的应用场景
第一:当原有的PHP代码实现出现性能瓶颈的时候,可以考虑通过PHP扩展的方式实现同样的功能。一般用于一些基础组件。如,解析xml为数组。
第二:纯PHP代码无法实现的功能,可以考虑通过PHP扩展调用其他相关库实现。如,我搞的tclip扩展。需要调用opencv的lib库。

目标:用扩展实现自定义函数输出hello word。

1
2
3
4
<?php
//自定义扩展 在扩展中实现一个myecho方法,调用myecho方法后,输出 hello word。
echo myecho();// 输出 hello word
?>

第一步:生成代码

PHP为我们提供了生成基本代码的工具 ext_skel。这个工具在PHP源代码的./ext目录下。

1
2
$ cd php_src/ext/
$ ./ext_skel --extname=myecho

extname参数的值就是扩展名称。执行ext_skel命令后,这样在当前目录下会生成一个与扩展名一样的目录。
《基于PHP7的PHP扩展开发之一(hello word)》
第二步,修改config.m4配置文件

config.m4的作用就是配合phpize工具生成configure文件。configure文件是用于环境检测的。检测扩展编译运行所需的环境是否满足。现在我们开始修改config.m4文件。

1
2
$ cd ./myecho
$ vim ./config.m4

打开,config.m4文件后,你会发现这样一段文字。

1
2
3
4
5
6
7
8
9
10
11
dnl If your extension references something external, use with:
 
dnl PHP_ARG_WITH(myecho, for myecho support,
dnl Make sure that the comment is aligned:
dnl [  --with-myecho             Include myecho support])
 
dnl Otherwise use enable:
 
dnl PHP_ARG_ENABLE(myecho, whether to enable myecho support,
dnl Make sure that the comment is aligned:
dnl [  --enable-myecho           Enable myecho support])

其中,dnl 是注释符号。上面的代码说,如果你所编写的扩展如果依赖其它的扩展或者lib库,需要去掉PHP_ARG_WITH相关代码的注释。否则,去掉 PHP_ARG_ENABLE 相关代码段的注释。我们编写的扩展不需要依赖其他的扩展和lib库。因此,我们去掉PHP_ARG_ENABLE前面的注释。去掉注释后的代码如下:

1
2
3
4
5
6
7
8
9
10
11
dnl If your extension references something external, use with:
 
dnl PHP_ARG_WITH(myecho, for myecho support,
dnl Make sure that the comment is aligned:
dnl [  --with-myecho             Include myecho support])
 
dnl Otherwise use enable:
 
PHP_ARG_ENABLE(myecho, whether to enable myecho support,
Make sure that the comment is aligned:
[  --enable-myecho           Enable myecho support])

第三步,代码实现

修改myecho.c文件。实现myecho方法。 找到PHP_FUNCTION(confirm_myecho_compiled),在其上面增加如下代码:

1
2
3
4
5
6
PHP_FUNCTION(myecho)
{
        zend_string *strg;
        strg = strpprintf(0, "hello word");
        RETURN_STR(strg);
}

找到PHP_FE(confirm_myecho_compiled,NULL), 在上面增加如下代码:

1
PHP_FE(myecho, NULL)

修改后的代码如下:

1
2
3
4
5
const zend_function_entry myecho_functions[] = {
	PHP_FE(myecho, NULL)
	PHP_FE(confirm_myecho_compiled,	NULL)		/* For testing, remove later. */
	PHP_FE_END	/* Must be the last line in myecho_functions[] */
};

第四步,编译安装
php安装完后在bin目录下有个php-config。
php-config是一个脚本文件。用于获取所安装的php配置的信息。
编译扩展的步骤如下:

1
2
3
$ phpize
$ ./configure --with-php-config=/usr/local/php/bin/php-config   
$ make && make install

结果
《基于PHP7的PHP扩展开发之一(hello word)》

编辑php.ini文档,创建extension_dir的目录(如果已经创建扩展目录请忽略),将编译好的扩展文件复制到extension下面
将extension_dir = “./” 改成

1
extension_dir = "/usr/local/php/lib/php/extensions"

修改php.ini文件,增加如下代码:

1
2
[myecho]
extension = myecho.so

然后执行,php -m 命令。在输出的内容中,你会看到myecho字样。

第五步,调用测试

调用ext/myecho/myecho.php 看输出的内容是否符合预期
输出:
Functions available in the test extension:
myecho
confirm_myecho_compiled

Congratulations! You have successfully modified ext/myecho/config.m4. Module myecho is now compiled into PHP.
《基于PHP7的PHP扩展开发之一(hello word)》
或自己写php脚本调用myecho函数

1
2
3
<?php
echo myecho();
?>

输出内容:
myecho

Windows环境开发过程类似:
1、下载php源码
2、到ext目录下找到ext_skel_win32.php
在dos下运行

1
php ext_skel_win32.php --extname=myecho

//使用php解释这个php文件

//如果没有找PHP,说明你的PHP不在环境变量中,设置

3、如果成功会在ext目录下面生成一个myextension的目录,那么你的扩展的源码就在这个文件夹下面了

你会看到.dsp文件,用vc打开这个文件。

4、添加你自己的扩展函数

在h头文件中找到

1
 PHP_FUNCTION(confirm_idict_compiled);    /* For testing, remove later. */

在下面添加自己的函数

1
2
3
4
5
6
PHP_FUNCTION(myecho)
{
        zend_string *strg;
        strg = strpprintf(0, "hello word");
        RETURN_STR(strg);
}

在:

1
2
 PHP_FE(confirm_idict_compiled,    NULL)下面添加自已的函数:
 PHP_FE(myecho,    NULL)

查找:

1
 PHP_FUNCTION(confirm_idict_compiled)

按照这个函数在加入自己的函数
5、编译成功。
6、测试、加载:
将生成的myecho.dll拷贝到php的extension目录下
extension = myecho.dll
7、重启apache,在自己php中测试

1
2
3
<?php
echo myecho();
?>

8、成功

——————–
如果扩展是用VC6编译的,PHP是用VC9编译的,VC编译版本不匹配,造成无法加载成功。
解决方法:
在config.w32.h文件中加入编译版本
#define PHP_COMPILER_ID “VC9” //保持一致
编译成功

点赞