PHP扩展开发 - 第一个扩展

目录
  1. 需求
  2. 环境： php-5.3.16
    1. 第一步、生成代码
    2. 第二步，修改配置
    3. 第三步，实现功能
    4. 第四步，编译扩展
    5. 第五步，添加扩展
    6. 第六步，检查安装结果

需求

比如开发一个叫做 hello_world 的扩展，扩展里就一个函数 hello_world_test()，输入一个字符串，函数返回：Your input string: xxxxx! 。

环境： php-5.3.16

第一步、生成代码

PHP为了扩展开发的方便，提供了一个类似代码生成器的工具ext_skel

1
2
3
cd /opt/php-5.3.16/ext/
./ext_skel --extname=hello_world --proto=hello_world.skel
cd hello_world/

生成代码啦

第二步，修改配置

然后修改config.m4文件将10、11、12三行最前面的dnl删除掉，就是将

1
2
3
dnl PHP_ARG_WITH(hello_world, for hello_world support,
dnl Make sure that the comment is aligned:
dnl [  --with-hello_world             Include hello_world support])

修改为

1
2
3
PHP_ARG_WITH(hello_world, for hello_world support,
Make sure that the comment is aligned:
[  --with-hello_world             Include hello_world support])

第三步，实现功能

修改源码php_hello_world.h文件

在

1
PHP_FUNCTION(confirm_hello_world_compiled);

后，添加

1
PHP_FUNCTION(hello_world_test);

然后修改源码 hello_world.c 文件

添加

1
2
3
4
5
6
7
8
9
10
11
12
13
PHP_FUNCTION(hello_world_test)
{
        char *arg = NULL;
        int arg_len, len;
        char *strg;

        if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &arg, &arg_len) == FAILURE) {
                return;
        }

        len = spprintf(&strg, 0, "Hello World! Your input string is %s\n", arg);
        RETURN_STRINGL(strg, len, 0);
}

第四步，编译扩展

保存后，开始编译

1
2
3
4
5
/usr/local/php/bin/phpize
./configure --with-php-config=/usr/local/php/bin/php-config
make
make test
make install

第五步，添加扩展

现在看看是不是有个 /usr/local/php/lib/php/extensions/no-debug-non-zts-20090626/hello_world.so

编辑php.ini配置文件，把扩展加入进去：

1
2
3
// 扩展路径
extension_dir = "/usr/local/php/lib/php/extensions/no-debug-non-zts-20090626/"
extension = hello_world.so

保存退出。

第六步，检查安装结果

编辑test.php文件

1
2
3
4
5
6
7
echo "<pre>";
$str = confirm_hello_world_compiled(hello_world);
echo $str."<br>";

print_r(get_loaded_extensions());
print_r(get_extension_funcs('hello_world'));
echo hello_world_test('My first php extension! ');

看看有没有结果输出！