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)
                // }}}
            
        

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