在linux下面完成了LAMP的配置环境之后,就可以进行php的扩展开发了。
php中的扩展开发都在源码包的/ext文件夹之下,可以看到这里已经有了很多开发好的扩展。比如与数据库相关的mysql以及xml处理的模块等等。
首先建立一个文件夹:
mkdir hello
在进入这个文件夹之后,先创建并打开一个配置文件:
vim config.m4
这个给出一个配置问题的实例:
|
1
2
3
4
5
6
|
1
PHP_ARG_ENABLE(sample, whether to enable SAMPLE support,
2
[ --enable-sample Enable SAMPLE support])
3
if
test
"$PHP_SAMPLE"
=
"yes"
; then
4
AC_DEFINE(SAMPLE,
1
, [Whether you have SAMPLE])
5
PHP_NEW_EXTENSION(sample, sample.c, $ext_shared)
6
fi
|
* PHP_ARG_ENABLE的第三个参数则是在调用./configurehelp的时候会显示出来
* 为什么有时候用enable-xxx,有时候用with-xxx?enable是可以关掉的,但是with需要额外的第三方的库
* 如果说--enable-hello在配置的时候有了,那么$PHP_HELLO这个参数就会被设为yes,那么才有接下来的操作
* PHP_NEW_EXTENSION则是要声明所有需要的源文件:PHP_NEW_EXTENSION(sample, sample.c sample2.c sample3.c, $ext_shared)
* 最后一个参数在building一个shared module的时候一般是这么些的。$ext_shared
下面列出在config文件中可能有的配置选项: * PHP_ARG_WITH 或者 PHP_ARG_ENABLE 指定了PHP扩展模块的工作方式,前者意味着不需要第三方库,后者正好相反;
* PHP_REQUIRE_CXX 用于指定这个扩展用到了C++;
* PHP_ADD_INCLUDE 指定PHP扩展模块用到的头文件目录;
* PHP_CHECK_LIBRARY 指定PHP扩展模块PHP_ADD_LIBRARY_WITH_PATH定义以及库连接错误信息等;
* PHP_ADD_LIBRARY(stdc++,”",EXTERN_NAME_LIBADD)用于将标准C++库链接进入扩展
* PHP_SUBST(EXTERN_NAME_SHARED_LIBADD) 用于说明这个扩展编译成动态链接库的形式;
* PHP_NEW_EXTENSION 用于指定有哪些源文件应该被编译,文件和文件之间用空格隔开;
接下来看头文件:php_sample.h
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
1
?#ifndef PHP_SAMPLE_H
2
/* 防止两次引入 */
3
#define PHP_SAMPLE_H
4
/* 定义扩展的性质 */
5
#define PHP_SAMPLE_EXTNAME
"sample"
6
#define PHP_SAMPLE_EXTVER
"1.0"
7
/* 当在php的源码树之外build的时候,引入配置选项, 在使用phpize工具时,一般都是先定义的 */
8
#ifdef HAVE_CONFIG_H
9
#include
"config.h"
10
#endif
11
/* 引入php标准头文件 */
12
#include
"php.h"
13
PHP_FUNCTION(hello_world);
//声明扩展中的函数
14
/* 定义入口点的符号,zend在加载这个module的时候会用*/
15
extern zend_module_entry sample_module_entry;
16
#define phpext_sample_ptr &sample_module_entry
17
#endif
/* PHP_SAMPLE_H */
|
* 声明zend_module_entry被声明为extern,所以当扩展被以extension=。。的形式加载的时候,Zend能够通过dlopen()和dlsym()找到它。
最后来看源文件sample.c:
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
|
#include
"php_sample.h"
static
function_entry php_sample_functions[] = {
PHP_FE(sample_hello_world, NULL)
//任何扩展中的函数都要在这里声明。把函数名输出到了用户空间中
{ NULL, NULL, NULL }
};
zend_module_entry sample_module_entry = {
//创建一个入口
#
if
ZEND_MODULE_API_NO >=
20010901
//这个是一个版本号
STANDARD_MODULE_HEADER,
#endif
PHP_SAMPLE_EXTNAME,
php_sample_functions,
/* Functions 这里是把php_function加入到Zend中去*/
NULL,
/* MINIT */
NULL,
/* MSHUTDOWN */
NULL,
/* RINIT */
NULL,
/* RSHUTDOWN */
NULL,
/* MINFO */
#
if
ZEND_MODULE_API_NO >=
20010901
PHP_SAMPLE_EXTVER,
#endif
STANDARD_MODULE_PROPERTIES
};
#ifdef COMPILE_DL_SAMPLE
ZEND_GET_MODULE(sample)
#endif
//这块区域是当扩展被动态加载的时候,为Zend添加一个引用,记得要添加上就行。
/*真正的函数体的部分*/
PHP_FUNCTION(sample_hello_world)
{
php_printf(
"Hello World!\n"
);
}
|
接下来需要进行扩展的生成: phpize ./configure --enable-sample make sudo make install 在执行完这些语句之后,需要在php.ini中添加这个扩展名:extension=sample.so 然后再重启一下apache sudo /etc/init.d/httpd restart
接下来在phpinfo页面中查看是否sample这个扩展已经有了,如果有了,那么在下面test.php中验证:
|
1
2
3
|
<!--?php
sample_hello_world();
?-->
|
如果打印除了"Hello World!",那么就说明这个php扩展开发成功了。
本文详细介绍如何在Linux环境下从零开始创建PHP扩展,包括配置文件config.m4的编写、头文件和源文件的具体实现,以及如何编译安装和启用扩展。
1万+

被折叠的 条评论
为什么被折叠?



