PHP模块开发：第一篇 hello world！

最新推荐文章于 2025-10-25 18:57:54 发布

最新推荐文章于 2025-10-25 18:57:54 发布 · 483 阅读

文章标签：

#PHP #Zend #EXT #C #C++

PHP 专栏收录该内容

3 篇文章

订阅专栏

本文介绍如何从零开始创建一个简单的PHP模块，包括生成模块基础结构、实现自定义函数、编译配置及测试等步骤。

在一些必要的场景我们不得不自己开发出自己的本地PHP函数满足一些特定的需求，而新的函数必须存在于PHP模块中。下面将介绍最简单的PHP模块开发：构建自己的say_hello($arg)函数来输出hello world : $arg。

本文档介绍的PHP模块开发仅仅是动动手做做hello world的程度，关于为什么这么做暂时不会介绍太多，更加详细的介绍后续解剖。

php 环境的搭建请参考：。。。

下面通过简单的几个步骤可以完成模块hello world级别的模块：

生成模块基础结构
修改模块代码，添加say_hello 函数
修改编译配置文件
生成模块共享库
配置模块，使模块生效
测试模块

1、生成模块基础

进入php源代码目录下的ext目录。
执行./ext_skel ––extname=sayhello (我这里的“–”编码有问题请不要直接拷贝)
输出：

[root@myhost ext]# ./ext_skel ––extname=sayhello

Creating directory sayhello
Creating basic files: config.m4 config.w32 .cvsignore sayhello.c php_sayhello.h CREDITS EXPERIMENTAL tests/001.phpt sayhello.php [done].
To use your new extension, you will have to execute the following steps:
1. $ cd ..
2. $ vi ext/sayhello/config.m4
3. $ ./buildconf
4. $ ./configure ––[with|enable]-sayhello
5. $ make
6. $ ./php -f ext/sayhello/sayhello.php
7. $ vi ext/sayhello/sayhello.c
8. $ make
Repeat steps 3-6 until you are satisfied with ext/sayhello/config.m4 and
step 6 confirms that your module is compiled into PHP. Then, start writing
code and repeat the last two steps as often as necessary.

看到显示输出表示模块基础结构已经生成，我们来看下生成的模块包含哪些文件：

-rw-r–r– 1 root root 2103 Apr 9 05:05 config.m4 //编译配置文件

-rw-r–r– 1 root root 310 Apr 9 05:05 config.w32 //w32编译配置文件
-rw-r–r– 1 root root 8 Apr 9 05:05 CREDITS //作者信息
-rw-r–r– 1 root root 0 Apr 9 05:05 EXPERIMENTAL //测试版信息标识
-rw-r–r– 1 root root 2755 Apr 9 05:05 php_sayhello.h //模块定义头文件
-rw-r–r– 1 root root 5294 Apr 9 05:05 sayhello.c //模块实现文件
-rw-r–r– 1 root root 508 Apr 9 05:05 sayhello.php //用来测试模块加载的php文件
drwxr-xr-x 2 root root 4096 Apr 9 05:05 tests //测试文件目录

这个时候模块的骨架已经出来了，我们下一步就可以将目标的say_hello()函数加入。

2、实现say_hello()函数

打开模块的php_sayhello.h 文件，增加为php say_hello()准备的c函数定义：
PHP_FUNCTION(say_hello); //php 源代码为模块开放定义了许多宏，习惯了使用还是蛮方便的
增加完以后我们再对PHP_FUNCTION(say_hello)在say_hello.c中增加具体的实现：

PHP_FUNCTION(say_hello){

char *arg = NULL;
int arg_len;
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &arg, &arg_len) == FAILURE) { //获取php代码的输入参数，方式与scanf差不多
return;
}
zend_printf("hello world : %s",arg)；
RETURN_STRINGL(arg, arg_len, 1);
}

现在实现代码也写了，我们还需要将这个函数注册到php本地函数中，需要修改sayhello.c中的sayhello_functions：

zend_function_entry sayhello_functions[] = {

PHP_FE(confirm_sayhello_compiled, NULL) /* For testing, remove later. */
PHP_FE(say_hello, NULL) //好，现在say_hello函数也注册了
{NULL, NULL, NULL} /* Must be the last line in sayhello_functions[] */
};