PHP7扩展开发教程之Hello World实现方法示例


Posted in PHP onAugust 03, 2017

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

一、下载PHP源代码

要开发PHP扩展,需要先下载PHP的源代码,一方面是因为我们的扩展一般会用到PHP自身定义的函数和宏,另一方面我们可以利用官方提供的工具减少工作量。

我下载了PHP-7.0.2,地址是:http://cn2.php.net/get/php-7.0.2.tar.gz。

解压源码压缩包, tar xzf php-7.0.2.tar.gz,我们现在只需要关注Zend和ext这两个目录。

Zend目录里面包含了PHP的Zend Engine源代码,有些函数和宏的定义我们需要在这里面简单地看一下。

ext目录里面包含了PHP原生的扩展,以及我们开发自己的扩展时可以利用的工具,Linux下使用ext_skel,Windows下使用ext_skel_win32.php

二、使用ext_skel工具

我们可以在ext目录下看到所有的PHP原生扩展,其中包括了熟悉的curl,json,mbstring,simplexml,sockets等扩展,还有很多没有用过甚至没有听说过的扩展,不用在意这些,我们先打开我们最熟悉的curl来看看,有config.m4配置文件,有php_curl.h,curl_file.c等源代码,还有一些中间文件,最后还有一个tests目录,里面放的curl扩展的单元测试。重点关注config.m4,php_curl.h,curl_file.c即可,最简单的场景下这三个文件就是一个扩展的全部组成部分了。

打开随便看一下,不算太复杂,但是自己写一个类似的还是挺头疼的,这时就需要用到我前面提到的ext_skel工具了。这个工具也在ext目录下,我们执行一下,./ext_skel --help,可以看到若干参数,我们用到的只有--extname=module,这里填上自己开发的扩展名称。想深入了解各个参数的作用可以看这里:http://php.net/manual/en/internals2.buildsys.skeleton.php

./ext_skel --extname=hello

ext目录下多了一个hello目录,我们后续的工作都在这个目录下面,工具已经为我们自动生成了一些文件。

config.m4配置文件

开发PHP扩展,在写C代码之前,要先配置一下这里。我们打开可以看到详细的注释说明,dnl是注释语法。

如果你的扩展用到了外部依赖,就配置--with-hello选项,否则配置--enable-hello选项,删除这下面3行的del注释

PHP_ARG_ENABLE(hello, whether to enable hello support,
Make sure that the comment is aligned:
[ --enable-hello      Enable hello support])

PHP_ARG_WITH和PHP_ARG_ENABLE这两个宏用来配置configure选项,一个配置需要外部依赖的,另一个配置不需要外部依赖的

配置好的内容,在后面执行configure --help时可以看到。

php_hello.h头文件

类似于C语音的头文件,包含了一些自定义的结构和函数声明,在这个demo中暂时不需要改动

hello.c代码文件

真正的逻辑代码都在这个文件中,后面会详细介绍。

三、编写代码

好了,到这一步我们终于要开始写代码了,打开hello.c文件。

整个扩展的入口是zend_module_entry这个结构,具体的定义可以在Zend目录下的zend_modules.h文件中看到,一共有十几个属性,快速跳过,我们暂时只需要"hello world"。

zend_module_entry hello_module_entry = {
  STANDARD_MODULE_HEADER,
  "hello",
  hello_functions,
  PHP_MINIT(hello),
  PHP_MSHUTDOWN(hello),
  PHP_RINIT(hello),    /* Replace with NULL if there's nothing to do at request start */
  PHP_RSHUTDOWN(hello),  /* Replace with NULL if there's nothing to do at request end */
  PHP_MINFO(hello),
  PHP_HELLO_VERSION,
  STANDARD_MODULE_PROPERTIES
};

STANDARD_MODULE_HEADER帮我们实现了前面6个属性

"hello"是扩展的名字

hello_functions是扩展包含的全部方法的集合

后面5个宏分别代表5个扩展特定方法

PHP_HELLO_VERSION是扩展的版本号,定义在头文件中

STANDARD_MODULE_PROPERTIES帮我们实现了剩下的属性

暂时都不需要修改,知道这是一个入口就行。顺着这个入口,我们继续看怎么给扩展添加方法,在hello_functions[]方法数组中已经有了一个示例方法confirm_hello_compiled,我们参考它写我们的方法hello_world

const zend_function_entry hello_functions[] = {
  PHP_FE(confirm_hello_compiled, NULL)    /* For testing, remove later. */
  PHP_FE(hello_world, NULL)
  PHP_FE_END /* Must be the last line in hello_functions[] */
};

先在扩展的方法数组中添加上hello_world,然后再定义hello_world。找到confirm_hello_compiled方法定义的地方,在它下面依葫芦画瓢,php_printf是Zend Engine中的printf方法。

PHP_FUNCTION(hello_world)
{
  php_printf("Hello World!\n");
  RETURN_TRUE;
}

四、编译安装

最后就是编译安装我们的扩展了,安装过PHP扩展的同学不用看,没有经验的可以参考一下。

phpize

./configure
make
make install

现在PHP的扩展目录中已经有了hello.so这个文件,在php.ini中添加上扩展的配置

extension = hello.so

五、测试

写一个test.php方法,执行脚本就可以看到"Hello World!"

<?php
hello_world();

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

PHP 相关文章推荐
用PHP调用数据库的存贮过程!
Oct 09 PHP
特转载一高手总结PHP学习资源和链接.
Dec 05 PHP
首页四格,首页五格For6.0(GBK)(UTF-8)[12种组合][9-18][版主安装测试通过]
Sep 24 PHP
那些年一起学习的PHP(一)
Mar 21 PHP
php获取目标函数执行时间示例
Mar 04 PHP
ThinkPHP3.2.2的插件控制器功能简述
Jul 09 PHP
PHP使用PDO连接ACCESS数据库
Mar 05 PHP
教大家制作简单的php日历
Nov 17 PHP
基于PHP实现简单的随机抽奖小程序
Jan 05 PHP
CodeIgniter配置之SESSION用法实例分析
Jan 19 PHP
详解php框架Yaf路由重写
Jun 20 PHP
浅谈PHP5.6 与 PHP7.0 区别
Oct 09 PHP
Kindeditor编辑器添加图片上传水印功能(php代码)
Aug 03 #PHP
phpStudy中升级MySQL版本到5.7.17的方法步骤
Aug 03 #PHP
使用PHP json_decode可能遇到的坑与解决方法
Aug 03 #PHP
Yii 2中的load()和save()示例详解
Aug 03 #PHP
Yii2使用表单上传文件的实例代码
Aug 03 #PHP
yii2学习教程之5种内置行为类详解
Aug 03 #PHP
PHP实现的简单在线计算器功能示例
Aug 02 #PHP
You might like
overlord人气高涨,却被菲利普频繁举报,第四季很难在国内上映
2020/05/06 日漫
PHP 和 MySQL 基础教程(一)
2006/10/09 PHP
php数组函数序列之rsort() - 对数组的元素值进行降序排序
2011/11/02 PHP
将PHP的session数据存储到数据库中的代码实例
2016/06/24 PHP
PHP中常用的魔术方法
2017/04/28 PHP
2020最新版 PhpStudy V8.1版本下载安装使用详解
2020/10/30 PHP
Aster vs KG BO3 第一场2.18
2021/03/10 DOTA
javascript 获取表单file全路径
2009/12/31 Javascript
javascript:void(0)的问题使用探讨
2014/04/10 Javascript
JavaScript 学习笔记之操作符
2015/01/14 Javascript
Bootstrap实现导航栏的2种方式
2016/11/28 Javascript
Vue 单文件中的数据传递示例
2017/03/21 Javascript
JavaScript 实现 Tab 点击切换实例代码
2017/03/25 Javascript
ionic3+Angular4实现接口请求及本地json文件读取示例
2017/10/11 Javascript
解决iview打包时UglifyJs报错的问题
2018/03/07 Javascript
JS中的JSON对象的定义和取值实现代码
2018/05/09 Javascript
使用vue-router完成简单导航功能【推荐】
2018/06/28 Javascript
Vue-cli@3.0 插件系统简析
2018/09/05 Javascript
[04:29]【TI9采访】OG.N0tail在胜者组决赛后接受采访
2019/08/25 DOTA
python读取浮点数和读取文本文件示例
2014/05/06 Python
python超简单解决约瑟夫环问题
2015/05/12 Python
python实现实时监控文件的方法
2016/08/26 Python
Python2与python3中 for 循环语句基础与实例分析
2017/11/20 Python
Python3一行代码实现图片文字识别的示例
2018/01/15 Python
浅谈flask截获所有访问及before/after_request修饰器
2018/01/18 Python
python 实现倒排索引的方法
2018/12/25 Python
Python中出现IndentationError:unindent does not match any outer indentation level错误的解决方法
2020/04/18 Python
selenium+python自动化测试环境搭建步骤
2019/06/03 Python
Python利用matplotlib做图中图及次坐标轴的实例
2019/07/08 Python
Django框架创建项目的方法入门教程
2019/11/04 Python
keras自定义回调函数查看训练的loss和accuracy方式
2020/05/23 Python
电子专业推荐信范文
2013/11/18 职场文书
房屋出售协议书
2014/04/10 职场文书
无财产离婚协议书范本
2014/10/28 职场文书
Java中多线程下载图片并压缩能提高效率吗
2021/07/01 Java/Android
浅谈为什么我的 z-index 又不生效了
2022/07/15 HTML / CSS