从零开始写 PHP 扩展（一）

PHP 是用 C 语言写的。对于每一个 PHPer 来讲，都有着心里的一种但愿写扩展的冲动了吧。然而，缺少一个很好的切入点。Google 上搜 PHP 扩展开发，大部分都是复制品文章，甚至有些人连操做都没有操做过就搬运在了本身的博客。不过也有几篇好教程，可是都是 PHP 5 时代的产物，隐藏着很是多的坑。我会将我本身慢慢踩坑的过程记录下来，也许这就成了其它人的“教程”了吧。

生成一个扩展

想必不少人已经看到不少网上的教程了。大多都是教咱们执行这个命令：$ ./ext_skel --extname=extname。可是，当你 clone 了 PHP 源码后会发现，master 分支下并无 ext/ext_skel 这个文件。因此，我总结了一下：

若是你是直接下载 PHP 的源码，或者在已经 release 的版本分之下，你能够执行这个命令

$ cd ext
$ ./ext_skel --extname=extname

若是你是直接在 master 分支下，只有 ext_skel.php 文件，这个时候你就直接能够执行这个 PHP 文件

$ cd ext
$ php ext_skel.php --ext extname

因为我是直接在 master 分支下开发的，因此后面的都是默认在 master 分之下的操做。

生成了扩展以后，咱们会看到四个文件和一个文件夹。如今这个阶段，咱们只须要用到两个文件，.c 文件和 .h 文件。

一个小坑

在咱们生成好扩展以后，咱们能够试着编译一下

$ phpize
$ ./configure
$ make && make test

咱们会惊讶地发现，编译的时候会有一个 warning。

warning: implicit declaration of function
      'ZEND_PARSE_PARAMETERS_NONE' is invalid in C99 [-Wimplicit-function-declaration]
        ZEND_PARSE_PARAMETERS_NONE();
        ^
1 warning generated.

而后你再执行 make test 发现有一个测试没有经过。没错，脚本为咱们生成好的文件，竟然通不过本身的测试。有没有以为很诡异。咱们看看 warning 的具体信息。找不到函数 ZEND_PARSE_PARAMETERS_NONE。看了一下文件，发如今第 15 行。看看这个函数名大概也能猜出来是什么意思了。因而我去 PHP 源码里搜了一下。但是咱们发现了这样一个宏定义。

#ifndef zend_parse_parameters_none
#define zend_parse_parameters_none()    \
        zend_parse_parameters(ZEND_NUM_ARGS(), "")
#endif

替换掉原来的大写以后，就没有 warning 了。这也算是官方给咱们挖了一个小坑吧。虽然大写的有宏定义，可是为何会报错，我也不太清楚了。

定义一个函数

我想，大多数人写扩展，确定至少但愿实现一个函数，不会是要几个全局变量就去写个扩展的吧（雾

这里 PHP 给咱们提供了一个有用的宏 PHP_FUNCTION。生成好的代码里也有定义好的两个函数，能够参照它的用法。这个宏最终会被翻译成一个函数。例如 PHP_FUNCTION(name) 最终会被翻译成 void zif_name(zend_execute_data *execute_data, zval *return_value)

同时咱们看到有定义了这么一个数组

const zend_function_entry cesium_functions[] = {
    PHP_FE(cesium_test1,        arginfo_cesium_test1)
    PHP_FE(cesium_test2,        arginfo_cesium_test2)
    PHP_FE_END
};

咱们须要将新添加的函数添加到这个数组里。像这样

const zend_function_entry cesium_functions[] = {
    PHP_FE(cesium_test1,        arginfo_cesium_test1)
    PHP_FE(cesium_test2,        arginfo_cesium_test2)
    PHP_FE(name,           NULL)
    PHP_FE_END
};

记住，结尾不要加分号或者逗号。最后，咱们能够个这个函数一个输出

PHP_FUNCTION(name)
{
    php_printf("Hello\n");
}

编译安装完了以后咱们就能够使用这个函数了

总结

本文仅仅是展现了从建立扩展开始到运行的全过程，本着能运行的心态来走完这些流程。

因为做者水平有限，若有错误，敬请不吝赐教。