[置顶] 一个简单的PHP扩展

PHP扩展开发:第一个扩展

发布时间：December 14, 2011 分类：PHP

《PHP扩展开发:安装PHP》

《POSIX定时器:timer_settime() 》

在上一篇文章《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/