快速在PHP中加入自己的模块

Step 1 =>
php的扩展模块都放在 ext/ 目录下，比如说 snmp模块、mysql模块。 我们要建立自己的模块，就要在ext目录下为自己的模块建一个目录。比如，我们要做一个分析config文件的模块，命名为pconfig模块(parse config的简写)，需在ext下建立目录pconfig。将我写好的7个文件copy到该目录下,另外需对主目录下的configure和internal_functions.c作一些修改。

Step 2 =>
Makefile.am Makefile.in 是模板文件，用户执行configure时，会调用这两个文件，生成编译时所用的Makefile文件。修改时将小写的pconfig换成你自己的模块名，别忘了把大写的PCONFIG也替换掉（不要告诉我你不会vi的替换语句）。config.m4也是执行configure将会调用的检测脚本程序,以后我们来讨论这些脚本程序的更深入的修改。现在你只需要把pconfig该成你的模块就可以了。对config.h.stub和setup.stub也如法炮制。其实setup.stub也没什么用。

Step 3 =>
php3-pconfig.h 头文件中
extern php3_module_entry pconfig_module_entry;
#define pconfig_module_ptr &pconfig_module_entry
#define phpext_pconfig_ptr pconfig_module_ptr
这几行定义了模块的入口，将入口注册到php后，php会通过模块入口找到你写的函数
　
下面几个函数定义是用宏进行定义的，展开以后其实就是 php3_minit_pconfig , php3_rinit_pconfig ……分别在你的模块初试化或结束时被调用，如果你的模块很简单，也就不需要这些定义了
　
extern PHP_MINIT_FUNCTION(pconfig);
extern PHP_RINIT_FUNCTION(pconfig);
extern PHP_MSHUTDOWN_FUNCTION(pconfig);
PHP_MINFO_FUNCTION(pconfig);
　
这是你的函数声明，将来写在php脚本语句中的函数名就是在PHP_FUNCTION中定义的名字。
PHP_FUNCTION(pconfig_test);
如果有多个，还可以继续往下加
PHP_FUNCTION(pconfig_parsefile);
PHP_FUNCTION(pconfig_release); …….
　
Step 4 =>
接下来我们看最重点的C代码了
function_entry pconfig_functions[] = {
PHP_FE(pconfig_test, NULL)
{NULL, NULL, NULL}
};
定义的是你的函数的入口（前面我们提到过模块的入口），按照格式将你在头文件中定义的函数写进去吧。注意，这是用宏定义的，不要管语法是否正确。以后我们具体讨论这些宏的用法。
php3_module_entry pconfig_module_entry = {
"pconfig", pconfig_functions, PHP_MINIT(pconfig), PHP_MSHUTDOWN(pconfig), PHP_RINIT(pconfig), NULL, PHP_MINFO(pconfig), STANDARD_MODULE_PROPERTIES
};
注册模块的入口信息，比如模块名，函数接口，初试化模块将调用的函数等等，如果你的模块不执行复杂操作的话，可以忽略掉他们，写成
php3_module_entry pconfig_module_entry = {
"pconfig", pconfig_functions, NULL,NULL,NULL,NULL,NULL,STANDARD_MODULE_PROPERTIES
};

Step 5 =>
写你自己的函数
在头文件和function_entry处，我们已经定义了自己的函数pconfig_test,现在我们就来实现pconfig_test的功能。就比如执行两个数相加的和吧。
static void _php3_pconfig_test(INTERNAL_FUNCTION_PARAMETERS)
{ ......
}
PHP_FUNCTION(pconfig_test)
{
_php3_pconfig_test(INTERNAL_FUNCTION_PARAM_PASSTHRU);
}
当系统调用pconfig_test时，会调用你的_php3_pconfig_test函数，当然你也可以把_php3_pconfig_test里的内容直接写在PHP_FUNCTION(pconfig_test)中，这样做只是程序结构比较清晰。注意：不要将_php3_pconfig_test命名成php3_pconfig_test，PHP_FUNCTION(pconfig_test)宏展开后实际上就是php3_pconfig_test!

Step 6 =>
好了，现在我们开始修改configure,在echo $ac_n "checking for MySQL support""... $ac_c" 1>&6的前面（当然，如果你熟悉configure的话，可以加在任何合适的地方）加上下面几句话
if test "${with_pconfig+set}" = set; then
withval="$with_pconfig"
# Add your lib in here
EXTRA_LIBS="$EXTRA_LIBS"
# Add your include path in here
INCLUDES="$INCLUDES"
EXT_SUBDIRS="$EXT_SUBDIRS pconfig"
EXT_LIBS="$EXT_LIBS pconfig/libphpext_pconfig.a"
EXTINFO_DEPS="$EXTINFO_DEPS ../ext/pconfig/extinfo.c.stub"
EXT_STATIC="$EXT_STATIC pconfig"
fi
修改internal_functions.c，在头文件定义中加入#include "ext/pconfig/php3_pconfig.h"
在zend_module_entry数组中加入phpext_pconfig_ptr,
　
Step 7 =>
从新configure，带上需要的参数，不要忘记的是在参数里加入 --with-pconfig
　
Step 8 =>
index.php3
<?
echo pconfig_test(123,678);
?>
执行命令>php index.php3
结果：810