怎样编写一个独立的PHP扩展

这期内容当中小编将会给大家带来有关怎样编写一个独立的PHP扩展,文章内容丰富且以专业的角度为大家分析和叙述,阅读完这篇文章希望大家可以有所收获。

创新互联专注于申扎企业网站建设,响应式网站建设,商城网站定制开发。申扎网站建设公司,为申扎等地区提供建站服务。全流程定制网站建设,专业设计,全程项目跟踪,创新互联专业和态度为您提供的服务

独立的PHP扩展可以独立于PHP源码之外进行分发。要创建一个这样的扩展,需要准备好两样东西:配置文件(config.m4)你的模块源码。接下来创新互联小编来讲解下怎样编写一个独立的PHP扩展?

怎样编写一个独立的PHP扩展

准备好系统工具

想要扩展能够在系统上编译并成功运行,需要准备转以下工具:

GNUautoconfGNUautomakeGNUlibtoolGNUm4

以上这些都可以从ftp://ftp.gnu.org/pub/gnu/获取。

注:以上这些都是类Unix环境下才能使用的工具。

改装一个已经存在的扩展

为了显示出创建一个独立的扩展是很容易的事情,我们先将一个已经内嵌到PHP的扩展改成独立扩展。安装PHP并且执行以下命令:

$mkdir/tmp/newext

$cd/tmp/newext

现在你已经有了一个空目录。我们将MySQL扩展目录下的文件复制过来:

$cp-rpphp-4.0.X/ext/mysql/*.

#注:看来这篇README真的需要更新一下了

#PHP7中已经移除了mysql扩展部分

到这里扩展就完成了,执行:

$phpize

现在你可以独立存放这个目录下的文件到任何地方,这个扩展可以完全独立存在了。

用户在编译时需要使用以下命令:

$./configure

[--with-php-config=/path/to/php-config]

[--with-mysql=MYSQL-DIR]

$makeinstall

这样MySQL模块就可以使用内嵌的MySQL客户端库或者已安装的位于MySQL目录中的MySQL。

注:意思是说想要编写PHP扩展,你既需要已经安装了PHP,也需要下载一份PHP源码。

怎样编写一个独立的PHP扩展

定义一个新扩展

我们给示例扩展命名为“foobar”。

新扩展包含两个资源文件:foo.c和bar.c(还有一些头文件,但这些不只重要)。

示例扩展不引用任何外部的库(这点很重要,因为这样用户就不需要特别指定一些编译选项了)。

LTLIBRARY_SOURCES选项用于指定资源文件的名字,你可以有任意数量的资源文件。

注:上面说的是Makefile.in文件中的配置选项,可以参考xdebug。

修改m4后缀的配置文件

m4配置文件可以指定一些额外的检查。对于一个独立扩展来说,你只需要做一些宏调用即可。

PHP_ARG_ENABLE(foobar,whethertoenablefoobar,

[--enable-foobarEnablefoobar])

iftest"$PHP_FOOBAR"!="no";then

PHP_NEW_EXTENSION(foobar,foo.cbar.c,$ext_shared)

fi

PHP_ARG_ENABLE会自动设置好正确的变量以保证扩展能够被PHP_NEW_EXTENSION以共享模式启动。

PHP_NEW_EXTENSION的第一个参数是扩展的名称,第二个参数是资源文件。第三个参数$ext_shared是由PHP_ARG_ENABLE/WITH为PHP_NEW_EXTENSION设定的。

请始终使用PHP_ARG_ENABLE或PHP_ARG_WITH进行设置。即使你不打算发布你的PHP模块,这些设置也可以保证让你的模块和PHP主模块的接口保持一体。

注:PHP_ARG_ENABLE和PHP_ARG_WITH应该是用于定义模块是动态扩展还是静态编译进PHP中,就跟编译PHP时使用的--enable-xxx和--with-xxx一样。

创建资源文件

ext_skel可以为你的PHP模块创建一些通用的代码,你也可以编写一些基本函数定义和C代码来处理函数的参数。具体信息可以查看READNE.EXT_SKEL。

不要担心没有范例,PHP中有很多模块供你参考,选择一个简单的点开始,添加你自己的代码。

注:ext_skel可以生成好基本模块需要的资源文件和配置文件,不需要自己创建。

修改自定义模块

将config.m4文件和资源文件放到同一个目录中,然后执行phpize(PHP4.0以上的版本编译PHP的时候都安装了phpize)。

假如你的phpize不在系统环境变量中,你需要指定绝对路径,例如:

$/php/bin/phpize

这个命令会自动复制必需的构建文件到当前目录并根据config.m4创建配置文件。

通过以上的步骤,你已经有了一个独立的扩展了。

安装扩展

扩展可以通过以下命令编译安装:

$./configure

[--with-php-config=/path/to/php-config]

$makeinstall

给模块添加共享支持

有时候独立扩展需要是共享的已供其他模块加载。接下来我会解释如何给已经创建好的foo模块添加共享支持。

在config.m4文件中,使用PHP_ARG_WITH/PHP_ARG_ENABLE来设定扩展,这样就可以自动使用--with-foo=shared[,..]或--enable-foo=shared[,..]这样的指令作为编译参数了。在config.m4文件中,使用PHP_NEW_EXTENSION(foo,..,$ext_shared)使扩展可以被构建。添加以下代码到你的C语言资源文件中:

#ifdefCOMPILE_DL_FOO

ZEND_GET_MODULE(foo)

#endif

这一段讲的上面都提到过了,这里只是又强调了一下。

PECL网站约定

假如你打算发布你的扩展到PECL的网站,需要考虑以下几点:

添加LICENSE或COPYING到package.xml需要在扩展头文件中定义好版本信息,这个宏会被foo_module_entry调用来声明扩展版本:

#definePHP_FOO_VERSION"1.2.3"

上述就是小编为大家分享的怎样编写一个独立的PHP扩展了,如果刚好有类似的疑惑,不妨参照上述分析进行理解。如果想知道更多相关知识,欢迎关注创新互联行业资讯频道。


网站名称:怎样编写一个独立的PHP扩展
标题网址:http://azwzsj.com/article/gjcjds.html