PHP7扩展开发之hello word实现方法详解

时间:2022-09-24 14:32:32

本文实例讲述了PHP7扩展开发之hello word实现方法。分享给大家供大家参考,具体如下:

这里是以PHP7作为基础,讲解如何从零开始创建一个PHP扩展。本文主要讲解创建一个扩展的基本步骤都有哪些。示例中,我们将实现如下功能:

  1. <?php 
  2. echo say(); 
  3. ?> 

输出内容:

  1. $ php ./test.php 
  2. $ hello word 

在扩展中实现一个say方法,调用say方法后,输出 hello word。

第一步:生成代码

PHP为我们提供了生成基本代码的工具ext_skel。这个工具在PHP源代码的./ext目录下。

  1. $ cd php_src/ext/ 
  2. $ ./ext_skel --extname=say 

extname参数的值就是扩展名称。执行ext_skel命令后,这样在当前目录下会生成一个与扩展名一样的目录。

第二步,修改config.m4配置文件

config.m4的作用就是配合phpize工具生成configure文件。configure文件是用于环境检测的。检测扩展编译运行所需的环境是否满足。现在我们开始修改config.m4文件。

  1. $ cd ./say 
  2. $ vim ./config.m4 

打开,config.m4文件后,你会发现这样一段文字。

  1. dnl If your extension references something external, use with
  2. dnl PHP_ARG_WITH(say, for say support, 
  3. dnl Make sure that the comment is aligned: 
  4. dnl [ --with-say       Include say support]) 
  5. dnl Otherwise use enable: 
  6. dnl PHP_ARG_ENABLE(say, whether to enable say support, 
  7. dnl Make sure that the comment is aligned: 
  8. dnl [ --enable-say      Enable say support]) 

其中,dnl 是注释符号。上面的代码说,如果你所编写的扩展如果依赖其它的扩展或者lib库,需要去掉PHP_ARG_WITH相关代码的注释。否则,去掉PHP_ARG_ENABLE相关代码段的注释。我们编写的扩展不需要依赖其他的扩展和lib库。因此,我们去掉PHP_ARG_ENABLE前面的注释。去掉注释后的代码如下:

  1. dnl If your extension references something external, use with
  2.  dnl PHP_ARG_WITH(say, for say support, 
  3.  dnl Make sure that the comment is aligned: 
  4.  dnl [ --with-say       Include say support]) 
  5.  dnl Otherwise use enable: 
  6.  PHP_ARG_ENABLE(say, whether to enable say support, 
  7.  Make sure that the comment is aligned: 
  8.  [ --enable-say      Enable say support]) 

第三步,代码实现

修改say.c文件。实现say方法。

找到PHP_FUNCTION(confirm_say_compiled),在其上面增加如下代码:

  1. PHP_FUNCTION(say) 
  2.     zend_string *strg; 
  3.     strg = strpprintf(0, "hello word"); 
  4.     RETURN_STR(strg); 

找到PHP_FE(confirm_say_compiled, 在上面增加如下代码:

  1. PHP_FE(say, NULL) 

修改后的代码如下:

  1. const zend_function_entry say_functions[] = { 
  2.    PHP_FE(say, NULL)    /* For testing, remove later. */ 
  3.    PHP_FE(confirm_say_compiled,  NULL)    /* For testing, remove later. */ 
  4.    PHP_FE_END /* Must be the last line in say_functions[] */ 
  5.  }; 
  6.  /* }}} */ 

第四步,编译安装

编译扩展的步骤如下:

  1. $ phpize 
  2. $ ./configure 
  3. $ make && make install 

修改php.ini文件,增加如下代码:

  1. [say] 
  2. extension = say.so 

然后执行,php -m命令。在输出的内容中,你会看到say字样。

第五步,调用测试

自己写一个脚本,调用say方法。看输出的内容是否符合预期。

希望本文所述对大家PHP程序设计有所帮助。