PHP扩展开发:第一个扩展

在上一篇文章《PHP扩展开发:安装PHP》我们已经将开发PHP扩展的PHP环境安装成功，那么接下来采用最简单直接的方式创建第一个扩展。

我们先假设业务场景，是需要有这么一个扩展，提供一个叫ccvita_string的函数，他的主要作用是返回一段字符。（这个业务场景实在太假，大家就这么看看吧）对应的PHP代码可能是这样：

function ccvita_string($str){
     $result = '<a href="'.$str.'">Link</a>'；
     return $result;
}

　　第一步，生成代码
PHP为了扩展开发的方便，提供了一个类似代码生成器的工具ext_skel，具体可以参见说明。
首先我们创建一个文件ccvita.skel，它的内容为

string ccvita_string(string str)

　　就是告诉ext_skel这个东西，我们要做的扩展里面有个函数叫ccvita_string。然后执行

cd MooENV/src/php-5.3.8/ext/
./ext_skel --extname=ccvita --proto=ccvita.skel
cd ccvita/

　　这时候，ccvita这个扩展的代码框架就已经出来了。

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

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

　　修改为

PHP_ARG_WITH(ccvita, for ccvita support,
Make sure that the comment is aligned:
[  --with-ccvita             Include ccvita support])

　　第三步，实现功能
修改源码ccvita.c文件
找到将ccvita_string这个函数修改为

PHP_FUNCTION(ccvita_string)
{
    char *str = NULL;
    int argc = ZEND_NUM_ARGS();
    int str_len;
    char *result;

    if (zend_parse_parameters(argc TSRMLS_CC, "s", &str, &str_len) == FAILURE)
        return;

    str_len = spprintf(&result, 0, "<a href=\"%.78s\">Link</a>", str);
    RETURN_STRINGL(result, str_len, 0);
}

　　第四步，编译扩展
保存后，开始编译

/usr/local/php/bin/phpize
./configure --with-php-config=/usr/local/php/bin/php-config
make

　　第五步，添加扩展
这时候，一切顺利的话，该扩展已经在modules/ccvita.so这个位置了。下面就是将这个扩展加入到PHP中去，让我们PHP程序可以调用到。

cp modules/ccvita.so /usr/local/php/ext/
vim /usr/local/php/etc/php.ini
extension=/usr/local/php/ext/ccvita.so #在php.ini文件最后增加这一行
service php-fpm restart #重启PHP服务
cp ccvita.php /data/www/wwwroot/default/

　　

接下来就可以访问ccvita.php这个文件，测试扩展了。下一篇，将会涉及一些更深入的内容。

相关代码，可以在我的github上clone出来，地址：https://github.com/KimiChen/PHP-EXT