php扩展开发札记（2）多个源码文件的配置和编译

php扩展开发笔记（2）多个源码文件的配置和编译

我们在开发过程中，为了代码得可读性和易维护性，肯定是需要多个代码文件的，而不仅仅是通过 ext_skel 生成得骨架文件。这篇文章主要介绍下，多个代码文件的时候，我们需要注意什么，以及怎么做。

我的代码文件如下（slash为我的扩展名）

<code class="language-c hljs "><span class="hljs-comment">// ext_skel 生成默认得模块相关的主要文件</span>php_slash.h <span class="hljs-comment">// 头文件</span>slash.c <span class="hljs-comment">// 源码文件</span>config.m4 <span class="hljs-comment">// 编译的时候需要修改的文件</span></code>

在这个默认生成的骨架文件里面，我们只要执行下面几步，就可以完成一个新的扩展了。

<code class="language-c hljs ">删除config.m4的第<span class="hljs-number">10</span>－<span class="hljs-number">12</span>行开头的注释dnlphpize./configuremake && make install</code>

通过上面的步骤，我们就完成了一个扩展，通过 dl(“slash.so”);的方式就可以进行测试了。如果编写一个类在上一篇文章里有介绍。

下面我们介绍增加新的类和源码文件以及如何编译配置等。

增加一个新的php类（Slash_Http_Util），并且给该类增加一个 getIv 的方法，php代码测试代码如下：

<code class="language-php hljs "><span class="hljs-variable">$httpUtil</span> = <span class="hljs-keyword">new</span> Slash_Http_Util();<span class="hljs-variable">$httpUtil</span>->getIv(); <span class="hljs-comment">// 会输出 HELLO</span></code>

源码文件 slash_http_util.h

<code class="language-c hljs "><span class="hljs-preprocessor">#ifndef SLASH_HTTP_UTIL_H</span><span class="hljs-preprocessor">#define SLASH_HTTP_UTIL_H</span><span class="hljs-keyword">extern</span> zend_class_entry *slash_http_util_ce;PHP_METHOD(slash_http_util, getIv);SLASH_MINIT_FUNCTION(http_util);<span class="hljs-preprocessor">#endif</span></code>

源码文件 slash_http_util.c

<code class="language-c hljs "><span class="hljs-preprocessor">#ifdef HAVE_CONFIG_H</span><span class="hljs-preprocessor">#include "config.h"</span><span class="hljs-preprocessor">#endif</span><span class="hljs-preprocessor">#include "php.h"</span><span class="hljs-preprocessor">#include "php_ini.h" /* for zend_alter_ini_entry */</span><span class="hljs-preprocessor">#include "php_slash.h"</span><span class="hljs-preprocessor">#include "slash_http_util.h"</span>zend_class_entry *slash_http_util_ce;PHP_METHOD(slash_http_util, getIv) {    php_printf(<span class="hljs-string">"HELLO"</span>);    RETURN_TRUE;}zend_function_entry slash_http_util_methods[] = {    ZEND_ME(slash_http_util, getIv, NULL, ZEND_ACC_PUBLIC|ZEND_ACC_STATIC)    PHP_FE_END};SLASH_MINIT_FUNCTION(http_util) {    zend_class_entry ce;    SLASH_INIT_CLASS_ENTRY(ce, SLASH_CN_HTTP_UTIL, slash_http_util_methods);    slash_http_util_ce = zend_register_internal_class(&ce TSRMLS_CC);    <span class="hljs-keyword">return</span> SUCCESS;}</code>

以上的代码完成了新类的添加，并且给该类增加了一个叫 getIv 的方法。下面需要修改我的 config.m4 配置文件，增加 slash_http_util.c 这个文件。打开 config.m4 到最后倒数第二行，默认 ext_skel 生成的代码是

<code class="language-c hljs ">PHP_NEW_EXTENSION(slash,slash.c,$ext_shared)</code>

修改，增加 slash_http_util.c 这个文件，需要注意的是两个 *.c 文件之间是空格，没有标点符号

<code class="language-c hljs ">PHP_NEW_EXTENSION(slash,slash.c slash_http_util.c, $ext_shared)</code>

完成 config.m4 的修改以后，还需要去修改 slash.c 这个文件，默认情况下在这个文件中会有下面的代码

<code class=" hljs cs">PHP_MINIT_FUNCTION(slash){    <span class="hljs-comment">/* If you have INI entries, uncomment these lines    REGISTER_INI_ENTRIES();    */</span>    <span class="hljs-keyword">return</span> SUCCESS;}</code>

我们需要把我们新创建的这个类载入进来

<code class=" hljs scss"><span class="hljs-function">PHP_MINIT_FUNCTION(slash)</span>{    <span class="hljs-comment">/* If you have INI entries, uncomment these lines    REGISTER_INI_ENTRIES();    */</span>    <span class="hljs-function">SLASH_STARTUP(http_util)</span>;    return SUCCESS;}</code>

通过这几步，新的类就完全创建成功了，你可以通过 phpize、configure、make 来编译这个模块了。最后通过我们开始制定的目标进行测试。

几个需要注意的问题：
1. 修改 config.m4 文件，增加源码文件
2. 修改 config.m4 文件以后，需要重新执行 phpize
3. 在模块加载函数中 PHP_MINIT_FUNCTION 加入这个新的类。

上面的代码中如果你完全copy可能没办法通过编译，因为我自定义重命名了几个宏（php_slash.h），实际开发中你可以zend的宏。

<code class="language-c hljs "><span class="hljs-preprocessor">#define SLASH_CN_HTTP_UTIL "Slash_Http_Util"</span><span class="hljs-comment">// {{{ php life cycle redefine</span><span class="hljs-preprocessor">#define SLASH_MINIT_FUNCTION(module) PHP_MINIT_FUNCTION(slash_##module)</span><span class="hljs-preprocessor">#define SLASH_MSHUTDOWN_FUNCTION(module) PHP_MSHUTDOWN_FUNCTION(slash_##module)</span><span class="hljs-preprocessor">#define SLASH_RINIT_FUNCTION(module) PHP_RINIT_FUNCTION(slash_##module)</span><span class="hljs-preprocessor">#define SLASH_RSHUTDOWN_FUNCTION(module) PHP_RSHUTDOWN_FUNCTION(slash_##module)</span><span class="hljs-preprocessor">#define SLASH_STARTUP(module) PHP_MODULE_STARTUP_N(slash_##module)(INIT_FUNC_ARGS_PASSTHRU)</span><span class="hljs-comment">// }}}</span><span class="hljs-comment">// {{{ class init mac</span><span class="hljs-preprocessor">#define SLASH_INIT_CLASS_ENTRY(ce, name, methods)  INIT_CLASS_ENTRY(ce, name, methods)</span><span class="hljs-comment">// }}}</span></code>

以上代码仅供参考，欢迎交流。