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

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

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

// ext_skel 生成默认得模块相关的主要文件
php_slash.h // 头文件
slash.c // 源码文件
config.m4 // 编译的时候需要修改的文件

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

删除config.m4的第10－12行开头的注释dnl
phpize
./configure
make && make install

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

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

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

$httpUtil = new Slash_Http_Util();
$httpUtil->getIv(); // 会输出 HELLO

源码文件 slash_http_util.h

#ifndef SLASH_HTTP_UTIL_H
#define SLASH_HTTP_UTIL_H

extern zend_class_entry *slash_http_util_ce;

PHP_METHOD(slash_http_util, getIv);
SLASH_MINIT_FUNCTION(http_util);
#endif

源码文件 slash_http_util.c

#ifdef HAVE_CONFIG_H
#include "config.h"
#endif

#include "php.h"
#include "php_ini.h" /* for zend_alter_ini_entry */

#include "php_slash.h"
#include "slash_http_util.h"

zend_class_entry *slash_http_util_ce;

PHP_METHOD(slash_http_util, getIv) {
    php_printf("HELLO");
    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);

    return SUCCESS;
}

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

PHP_NEW_EXTENSION(slash,slash.c,$ext_shared)

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

PHP_NEW_EXTENSION(slash,slash.c slash_http_util.c, $ext_shared)

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

PHP_MINIT_FUNCTION(slash)
{
    /* If you have INI entries, uncomment these lines
    REGISTER_INI_ENTRIES();
    */
    return SUCCESS;
}

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

PHP_MINIT_FUNCTION(slash)
{
    /* If you have INI entries, uncomment these lines
    REGISTER_INI_ENTRIES();
    */
    SLASH_STARTUP(http_util);
    return SUCCESS;
}

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

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

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

#define SLASH_CN_HTTP_UTIL "Slash_Http_Util"

// {{{ php life cycle redefine
#define SLASH_MINIT_FUNCTION(module) PHP_MINIT_FUNCTION(slash_##module)
#define SLASH_MSHUTDOWN_FUNCTION(module) PHP_MSHUTDOWN_FUNCTION(slash_##module)
#define SLASH_RINIT_FUNCTION(module) PHP_RINIT_FUNCTION(slash_##module)
#define SLASH_RSHUTDOWN_FUNCTION(module) PHP_RSHUTDOWN_FUNCTION(slash_##module)
#define SLASH_STARTUP(module) PHP_MODULE_STARTUP_N(slash_##module)(INIT_FUNC_ARGS_PASSTHRU)
// }}}

// {{{ class init mac
#define SLASH_INIT_CLASS_ENTRY(ce, name, methods)  INIT_CLASS_ENTRY(ce, name, methods)
// }}}

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