PHP扩展开发

Wesley13
• 阅读 665

首先需要确定系统中安装了gcc编译器,合适版本的bison等

####构建一个基本的扩展骨架 在PHP扩展开发时,使用ext_skel完成扩展的结构骨架创建。

$ ./ext_skel
./ext_skel --extname=module [--proto=file] [--stubs=file] [--xml[=file]]
           [--skel=dir] [--full-xml] [--no-help]

  --extname=module   这里的module是要创建的扩展名称
  --proto=file       这里的file文件包含了要创建的函数的原型
  --stubs=file       generate only function stubs in file
  --xml              generate xml documentation to be added to phpdoc-cvs
  --skel=dir         创建扩展骨架的目录
  --full-xml         generate xml documentation for a self-contained extension (not yet implemented)
  --no-help          don't try to be nice and create comments in the code and helper functions to test if the module compiled

注意: ext_skel命令文件在源文件的ext目录下。

这里的--extname参数是要创建的扩展名称,扩展名称为 小写字母 + 下划线 组成,并且, 在ext目录中必须是唯一的。

例如,这里要创建一个名为ext_demo_1的PHP扩展:

/vagrant/ext$ ./ext_skel --extname=ext_demo_1
Creating directory ext_demo_1
Creating basic files: config.m4 config.w32 .svnignore ext_demo_1.c php_ext_demo_1.h CREDITS EXPERIMENTAL tests/001.phpt ext_demo_1.php [done].

To use your new extension, you will have to execute the following steps:

1.  $ cd ..
2.  $ vi ext/ext_demo_1/config.m4
3.  $ ./buildconf
4.  $ ./configure --[with|enable]-ext_demo_1
5.  $ make
6.  $ ./php -f ext/ext_demo_1/ext_demo_1.php
7.  $ vi ext/ext_demo_1/ext_demo_1.c
8.  $ make

Repeat steps 3-6 until you are satisfied with ext/ext_demo_1/config.m4 and
step 6 confirms that your module is compiled into PHP. Then, start writing
code and repeat the last two steps as often as necessary.

现在,在ext目录下出现了一个新建的扩展目录ext_demo_1

/vagrant/ext/ext_demo_1$ ls
config.m4   CREDITS       ext_demo_1.c    php_ext_demo_1.h
config.w32  EXPERIMENTAL  ext_demo_1.php  tests

这时,该扩展是无法编译通过的,需要先编辑config.m4文件才行。

####配置文件config.m4

配置文件config.m4告诉UNIX构建系统扩展支持的configure选项以及扩展需要的额外的库, 包含哪些源文件等,该文件使用的是GNU的autoconf语法,以dnl开头的行为注释,使用中括号([和])包含的为字符串。

autoconf语法参见 AUTOCONF文档

PHP_ARG_ENABLE(ext_demo_1, whether to enable ext_demo_1 support,
[  --enable-ext_demo_1           Enable ext_demo_1 support])

if test "$PHP_EXT_DEMO_1" != "no"; then
  PHP_SUBST(EXT_DEMO_1_SHARED_LIBADD)
  PHP_NEW_EXTENSION(ext_demo_1, ext_demo_1.c, $ext_shared)
fi

上述为autoconf的配置文件,第一个宏PHP_ARG_ENABLE,含有三个参数:

  • ext_demo_1 这是第一个参数,为./configure建立了名为enable-ext_demo_1的选项
  • 第二个参数将会在./configure命令处理到该扩展的配置文件时,显示该参数的内容
  • 第三个参数是./configure命令的帮助,在使用./configure --help的时候显示

第二个宏为PHP_NEW_EXTENSION,该宏声明了扩展的模块和必须要编译作为扩展一部分的源码文件。 如果需要多个源文件,则使用空格分隔,第三个参数$ext_shared与调用 PHP_SUBST(EXT_DEMO_1_SHARED_LIBADD)有关。

PHP_NEW_EXTENSION(ext_demo_1, ext_demo_1.c, $ext_shared)

####编译扩展

修改完config.m4文件之后,接下来编译PHP和扩展。

/vagrant$ ./configure --disable-libxml --enable-ext_demo_1 --disable-dom --disable-simplexml --disable-xml --disable-xmlreader --disable-xmlwriter --without-pear --prefix=/usr/local/php
/vagrant$ make
/vagrant$ sudo make install
Installing PHP SAPI module:       cgi
Installing PHP CGI binary: /usr/local/php/bin/
Installing PHP CLI binary:        /usr/local/php/bin/
Installing PHP CLI man page:      /usr/local/php/man/man1/
Installing build environment:     /usr/local/php/lib/php/build/
Installing header files:          /usr/local/php/include/php/
Installing helper programs:       /usr/local/php/bin/
  program: phpize
  program: php-config
Installing man pages:             /usr/local/php/man/man1/
  page: phpize.1
  page: php-config.1
/vagrant/build/shtool install -c ext/phar/phar.phar /usr/local/php/bin
ln -s -f /usr/local/php/bin/phar.phar /usr/local/php/bin/phar
Installing PDO headers:          /usr/local/php/include/php/ext/pdo/

此时,PHP安装在了/usr/local/php目录下,进入该目录,可以看到如下文件:

/usr/local/php$ ls
bin  include  lib  man

进入/usr/local/php/bin目录,执行以下命令:

/usr/local/php/bin$ ./php --info|grep demo
Configure Command =>  './configure'  '--disable-libxml' '--enable-ext_demo_1' '--disable-dom' '--disable-simplexml' '--disable-xml' '--disable-xmlreader' '--disable-xmlwriter' '--without-pear' '--prefix=/usr/local/php'
ext_demo_1
ext_demo_1 support => enabled

可以看到,phpinfo()中扩展支持已经启用了,按照上述步骤安装的扩展中包含了一个测试扩展是否能够正常工作的函数, 该函数名为confirm_ext_demo_1_compiled(arg),执行结果如下:

/usr/local/php/bin$ ./php -r "echo confirm_ext_demo_1_compiled('mylxsw');"
Congratulations! You have successfully modified ext/ext_demo_1/config.m4. Module mylxsw is now compiled into PHP.

可以看到,ext_demo_1扩展安装成功了。

我的博客:http://aicode.cc/,在这里可以看到更多相关文章。

点赞
收藏
评论区
推荐文章
blmius blmius
3年前
MySQL:[Err] 1292 - Incorrect datetime value: ‘0000-00-00 00:00:00‘ for column ‘CREATE_TIME‘ at row 1
文章目录问题用navicat导入数据时,报错:原因这是因为当前的MySQL不支持datetime为0的情况。解决修改sql\mode:sql\mode:SQLMode定义了MySQL应支持的SQL语法、数据校验等,这样可以更容易地在不同的环境中使用MySQL。全局s
Easter79 Easter79
3年前
swap空间的增减方法
(1)增大swap空间去激活swap交换区:swapoff v /dev/vg00/lvswap扩展交换lv:lvextend L 10G /dev/vg00/lvswap重新生成swap交换区:mkswap /dev/vg00/lvswap激活新生成的交换区:swapon v /dev/vg00/lvswap
皕杰报表之UUID
​在我们用皕杰报表工具设计填报报表时,如何在新增行里自动增加id呢?能新增整数排序id吗?目前可以在新增行里自动增加id,但只能用uuid函数增加UUID编码,不能新增整数排序id。uuid函数说明:获取一个UUID,可以在填报表中用来创建数据ID语法:uuid()或uuid(sep)参数说明:sep布尔值,生成的uuid中是否包含分隔符'',缺省为
待兔 待兔
3个月前
手写Java HashMap源码
HashMap的使用教程HashMap的使用教程HashMap的使用教程HashMap的使用教程HashMap的使用教程22
Jacquelyn38 Jacquelyn38
3年前
2020年前端实用代码段,为你的工作保驾护航
有空的时候,自己总结了几个代码段,在开发中也经常使用,谢谢。1、使用解构获取json数据let jsonData  id: 1,status: "OK",data: 'a', 'b';let  id, status, data: number   jsonData;console.log(id, status, number )
Wesley13 Wesley13
3年前
PHP创建多级树型结构
<!lang:php<?php$areaarray(array('id'1,'pid'0,'name''中国'),array('id'5,'pid'0,'name''美国'),array('id'2,'pid'1,'name''吉林'),array('id'4,'pid'2,'n
Wesley13 Wesley13
3年前
00:Java简单了解
浅谈Java之概述Java是SUN(StanfordUniversityNetwork),斯坦福大学网络公司)1995年推出的一门高级编程语言。Java是一种面向Internet的编程语言。随着Java技术在web方面的不断成熟,已经成为Web应用程序的首选开发语言。Java是简单易学,完全面向对象,安全可靠,与平台无关的编程语言。
Stella981 Stella981
3年前
Django中Admin中的一些参数配置
设置在列表中显示的字段,id为django模型默认的主键list_display('id','name','sex','profession','email','qq','phone','status','create_time')设置在列表可编辑字段list_editable
Wesley13 Wesley13
3年前
MySQL部分从库上面因为大量的临时表tmp_table造成慢查询
背景描述Time:20190124T00:08:14.70572408:00User@Host:@Id:Schema:sentrymetaLast_errno:0Killed:0Query_time:0.315758Lock_
Python进阶者 Python进阶者
9个月前
Excel中这日期老是出来00:00:00,怎么用Pandas把这个去除
大家好,我是皮皮。一、前言前几天在Python白银交流群【上海新年人】问了一个Pandas数据筛选的问题。问题如下:这日期老是出来00:00:00,怎么把这个去除。二、实现过程后来【论草莓如何成为冻干莓】给了一个思路和代码如下:pd.toexcel之前把这