PHP的C扩展开发入门指南

为什么要用C扩展

C是静态编译的，执行效率比PHP代码高很多。同样的运算代码，使用C来开发，性能会比PHP要提升数百倍。IO操作如CURL，因为耗时主要在IOWait上，C扩展没有明显优势。

另外C扩展是在进程启动时加载的，PHP代码只能操作Request生命周期的数据，C扩展可操作的范围更广。

源码下载

From PHP官网

http://php.net/downloads.php

From Git

git clone https://github.com/php/php-src.git

From git.php.net

git clone http://git.php.net/repository/php-src.git

From Github

1. 打开 php-src project page
2. 选择感兴趣的分支
3. 点击 Download ZIP即可

这里以zip为例：

wget http://museum.php.net/php5/php-5.3.16.tar.gztar zxvf php-5.3.16.tar.gzmv php-5.3.16 php-src

进入到PHP源码目录：

cd php-src	

若使用 Git好处是方便切换不同版本

git clone http://git.php.net/repository/php-src.gitPHP 5.4: git checkout PHP-5.4   PHP 5.5: git checkout PHP-5.5   PHP 5.6: git checkout PHP-5.6   PHP 7.0: git checkout PHP-7.0   PHP HEAD: git checkout master

生成扩展

cd ext

第一步

生成PHP扩展骨架：

./ext_skel --extname=myext

ext_skel是PHP官方提供的用于生成php扩展骨架代码的工具

成功创建完基本文件之后会提示如下：

Creating directory myextCreating basic files: config.m4 config.w32 .svnignore myext.c php_myext.h CREDITS EXPERIMENTAL tests/001.phpt myext.php [done].To use your new extension, you will have to execute the following steps:1.  $ cd ..2.  $ vi ext/myext/config.m43.  $ ./buildconf4.  $ ./configure --[with|enable]-myext5.  $ make6.  $ ./php -f ext/myext/myext.php7.  $ vi ext/myext/myext.c8.  $ makeRepeat steps 3-6 until you are satisfied with ext/myext/config.m4 andstep 6 confirms that your module is compiled into PHP. Then, start writingcode and repeat the last two steps as often as necessary.

查看生成的文件：

tree myext|-- CREDITS|-- EXPERIMENTAL|-- config.m4|-- config.w32|-- myext.c|-- myext.php|-- php_myext.h`-- tests    `-- 001.phpt1 directory, 8 files

config.m4是AutoConf工具的配置文件，用来修改各种编译选项。

第二步

修改 config.m4

cd ..vi ext/myext/config.m4

将

dnl PHP_ARG_WITH(myext, for myext support,dnl Make sure that the comment is aligned:dnl [  --with-myext             Include myext support])

修改为

PHP_ARG_WITH(myext, for myext support,[  --with-myext             Include myext support])

下边还有一个 –-enable-myext，是表示编译到php内核中。with是作为动态链接库载入的。

第三步

修改 php_myext.h，在45行找到 PHP_FUNCTION(confirm_myext_compiled), 这里就是扩展函数声明部分;

可以增加一行 PHP_FUNCTION(myext_helloworld);, 表示声明了一个myext_helloworld的扩展函数。

第四步

修改 myext.c, 这个是扩展函数的实现部分 在42行之后， 加入 PHP_FE(myext_helloworld, NULL)

const zend_function_entry myext_functions[] = {    PHP_FE(confirm_myext_compiled,  NULL)       /* For testing, remove later. */    PHP_FE(myext_helloworld,  NULL)    PHP_FE_END  /* Must be the last line in myext_functions[] */};

这的代码是将函数指针注册到Zend引擎，增加一行PHP_FE(myext_helloworld, NULL)（后面不要带分号）。

第五步

在 myext.c末尾加myext_helloworld的执行代码。

PHP_FUNCTION(myext_helloworld){    char *arg = NULL;	int arg_len, len;	char *strg;	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &arg, &arg_len) == FAILURE) {		return;	}	php_printf("Hello World!\n");	RETURN_TRUE;}

zend_parse_parameters是用来接受PHP传入的参数，RETURN_XXX宏是用来返回给PHP数据。

第六步

在myext目录下依次执行：

phpize./configuremakemake install

如果执行 ./configure时出现此错误： configure: error: Cannot find php-config. Please use Cwith-php-config=PATH 说明php-config配置文件不在缺省目录里， 重新执行： ./configure --with-php-config=/usr/local/php/bin/php-config节课 这个文件通常是在PHP的安装目录的bi目录下的一个叫做 php-config或者 php-config5的文件

然后修改php.ini加入 extension = "myext.so"

第七步

通过执行 php -r "myext_helloworld('test');"验证扩展是否成功加载，如果成功则输出 hello world!

参考

• http://php.net/git.php
• http://rango.swoole.com/archives/152