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面向对象全攻略 (十四) php5接口技术
Sep 30 PHP
php下获取Discuz论坛登录用户名、用户组、用户ID等信息的实现代码
Dec 29 PHP
PHP学习笔记之三 数据库基本操作
Jan 17 PHP
php懒人函数 自动添加数据
Jun 28 PHP
php数组函数序列之array_intersect() 返回两个或多个数组的交集数组
Nov 10 PHP
php实现单链表的实例代码
Mar 22 PHP
PHP开发框架kohana中处理ajax请求的例子
Jul 14 PHP
php中mkdir函数用法实例分析
Nov 15 PHP
简单说说PHP优化那些事(经验分享)
Nov 27 PHP
64位windows系统下安装Memcache缓存
Dec 06 PHP
PHP递归实现文件夹的复制、删除、查看大小操作示例
Aug 11 PHP
PHP通过调用新浪API生成t.cn格式短网址链接的方法详解
Feb 20 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
php smarty模版引擎中的缓存应用
2009/12/02 PHP
PHP几个实用自定义函数小结
2016/01/25 PHP
Yii2框架数据验证操作实例详解
2018/05/02 PHP
sina的lightbox效果。
2007/01/09 Javascript
比较详细的关于javascript中void(0)的具体含义解释
2007/08/02 Javascript
javascript下数值型比较难点说明
2010/06/07 Javascript
javascript函数中的arguments参数
2010/08/01 Javascript
jQuery根据纬度经度查看地图处理程序
2013/05/08 Javascript
解析javascript 数组以及json元素的添加删除
2013/06/26 Javascript
ext前台接收action传过来的json数据示例
2014/06/17 Javascript
jQuery简单实现提交数据出现loading进度条的方法
2016/03/29 Javascript
滚动条的监听与内容随着滚动条动态加载的实现
2017/02/08 Javascript
Vuex之理解Getters的用法实例
2017/04/19 Javascript
JavaScript通过filereader接口读取文件
2017/05/10 Javascript
微信小程序使用Socket的实例
2017/09/19 Javascript
canvas+gif.js打造自己的数字雨头像的示例代码
2017/10/26 Javascript
React-redux实现小案例(todolist)的过程
2019/09/29 Javascript
使用Vue-cli 中为单独页面设置背景图片铺满全屏
2020/07/17 Javascript
使用graphics.py实现2048小游戏
2015/03/10 Python
Python中类型关系和继承关系实例详解
2015/05/25 Python
Python2中的raw_input() 与 input()
2015/06/12 Python
vue.js实现输入框输入值内容实时响应变化示例
2018/07/07 Python
使用python生成杨辉三角形的示例代码
2018/08/29 Python
学习python分支结构
2019/05/17 Python
Python GUI学习之登录系统界面篇
2019/08/21 Python
TensorFlow中如何确定张量的形状实例
2020/06/23 Python
python字典key不能是可以是啥类型
2020/08/04 Python
OpenCV+Python3.5 简易手势识别的实现
2020/12/21 Python
会计助理岗位职责
2014/02/17 职场文书
我爱我校演讲稿
2014/05/21 职场文书
本科生自荐信
2014/06/18 职场文书
实习护士自荐信
2014/06/21 职场文书
党员教师四风自我剖析材料
2014/09/30 职场文书
经销商会议开幕词
2016/03/04 职场文书
陶瓷类经典广告语集锦
2019/10/25 职场文书
Python-OpenCV实现图像缺陷检测的实例
2021/06/11 Python