【视频】从零开始编写第一个PHP扩展
Rango会讲解在Linux下从零开始写一个PHP扩展，并编译安装到PHP里，一直到执行扩展中的函数。包含的内容有：
- 为什么要开发PHP扩展
- ext_skel工具的使用
- 修改config.m4
- phpize的使用
- 必备工具，autoconf / gcc / make / php5 / php5-dev
- ZendAPI的使用简介，会介绍几个重要的API
摘自：http://wiki.swoole.com/wiki/page/238.html
学习笔记：
1、安装 Eclipse IDE 插件
(1) 去官网下载 Eclipse 3.7
http://www.eclipse.org/downloads/packages/release/indigo/sr2
(2) 安装 IDE插件
Help -> Install New Software
Work width -> 选择 “Indigo - http://download.eclipse.org/releases/indigo”
Programming Languages ->
选择“C/C++ Development Tools”
选择“PHP Development Tools(PDT) SDK Feature”
(3) 下载PHP源码
2、安装开发工具（3个）
sudo apt-get install gcc make autoconf
- gcc：C语言的编译器
- make：C/C++工程自动构建工具
- autoconf：检测一些系统环境，以及一些编译参数的设置
3、开发扩展
(1) 重要工具 ./ext/ext_skel
为我们自动创建一个PHP扩展工程的工具/脚本，执行它一下，会打印一些帮助信息
$ ./ext_skel ./ext_skel --extname=module [--proto=file] [--stubs=file] [--xml[=file]] [--skel=dir] [--full-xml] [--no-help] --extname=module module is the name of your extension --proto=file file contains prototypes of functions to create --stubs=file generate only function stubs in file --xml generate xml documentation to be added to phpdoc-cvs --skel=dir path to the skeleton directory --full-xml generate xml documentation for a self-contained extension (not yet implemented) --no-help don't try to be nice and create comments in the code and helper functions to test if the module compiled
(2) 利用 ext_skel 创建工程
$ ./ext_skel --extname=test Creating directory test Creating basic files: config.m4 config.w32 .svnignore test.c php_test.h CREDITS EXPERIMENTAL tests/001.phpt test.php [done]. To use your new extension, you will have to execute the following steps: 1. $ cd .. 2. $ vi ext/test/config.m4 3. $ ./buildconf 4. $ ./configure --[with|enable]-test 5. $ make 6. $ ./sapi/cli/php -f ext/test/test.php 7. $ vi ext/test/test.c 8. $ make Repeat steps 3-6 until you are satisfied with ext/test/config.m4 and step 6 confirms that your module is compiled into PHP. Then, start writing code and repeat the last two steps as often as necessary.
(3) 进入到 扩展 test 目录中
config.m4：autoconf 工具的配置文件
php_test.h：头文件
test.c：C源文件
开发扩展的第一步，就是修改 config.m4，把我们的扩展启用，dnl 是 autoconf 的 注释符，把
dnl PHP_ARG_WITH(test, for test support, dnl Make sure that the comment is aligned: dnl [ --with-test Include test support])
改为
PHP_ARG_WITH(test, for test support, [ --with-test Include test support])
表示 启用了这个扩展
(4) 在 扩展test 目录下，执行命令
$ /opt/software/php/bin/phpize Configuring for: PHP Api Version: 20100412 Zend Module Api No: 20100525 Zend Extension Api No: 220100525
PHP根据刚才修改的 config.m4 文件，生成一个 configure 脚本，执行成功后，会看到这个目录就多了一些文件。
我们最主要看的是 configure 这个文件，它是一个Shell脚本，这个脚本帮我们检测一些头文件，一些环境特性方面的东西。
(5) 执行 configure 文件
sudo ./configure --with-php-config=/opt/software/php/bin/php-config
执行成功后，在扩展目录下会产生一个 Makefile 文件，它是 make 命令的配置文件，
(6) make 根据 Makefile 文件，对 C 源文件进行编译。
$ sudo make
会在扩展的 modules 目录下，生成 test.so 文件
(7) 安装扩展
将刚才编译好的扩展（test.so）安装到PHP的扩增目录
$ sudo make install Installing shared extensions: /opt/software/php/lib/php/extensions/no-debug-non-zts-20100525/
(8) 启用扩展
通过如下命令，找到 php.ini 文件位置，
$ /opt/software/php/bin/php -i | grep php.ini Configuration File (php.ini) Path => /opt/software/php/etc Loaded Configuration File => /opt/software/php/etc/php.ini
编译 php.ini，添加
extension=test.so
(9) 查看扩展是否被启用
$ /opt/software/php/bin/php -m [PHP Modules] bcmath bz2 ... sysvshm test tokenizer ... zip zlib [Zend Modules] Xdebug
(10) 自己重新写一个函数 test_hello
php_test.h 文件中，增加
PHP_FUNCTION(test_hello);
test.c 文件中，增加
PHP_FUNCTION(test_hello)
{
long a;
long b;
char *c;
int c_len;if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "lls", &a, &b, &c, &c_len) == FAILURE) {
return;
}char *str;
int len = spprintf(&str, 0, "%s: %d\n", c, a * b);RETURN_STRINGL(str, len, 0);
}
再重新编译、安装 sudo make && make install
(11) 检测 自定义函数 test_hello 是否存在
$ php --rf 'test_hello' Exception: Function test_hello() does not exist
提示 函数不存在，说明该函数还没有注册到 Zend引擎中
(12) 注册 test_hello函数到 Zend引擎中
在 test.c 文件中找到如下代码块：
/* {{{ test_functions[]
*
* Every user visible function must have an entry in test_functions[].
*/
const zend_function_entry test_functions[] = {
PHP_FE(confirm_test_compiled, NULL) /* For testing, remove later. */
PHP_FE_END /* Must be the last line in test_functions[] */
};
增加 test_hello 函数的注册
const zend_function_entry test_functions[] = {
PHP_FE(test_hello, NULL)
PHP_FE(confirm_test_compiled, NULL) /* For testing, remove later. */
PHP_FE_END /* Must be the last line in test_functions[] */
};
(13) 重新 编译、安装
$ sudo make && make install
(14) 重新 检测函数是否存在
$ php --rf 'test_hello'
Function [ <internal:test> function test_hello ] {
}
OK，函数注册Zend成功！
