2023年怎样编写一个独立的php扩展函数模板
文件格式:DOCX
时间:2023-04-30 00:00:00    小编:海上边缘人

2023年怎样编写一个独立的php扩展函数模板

小编:海上边缘人

在日常学习、工作或生活中,大家总少不了接触作文或者范文吧,通过文章可以把我们那些零零散散的思想,聚集在一块。大家想知道怎么样才能写一篇比较优质的范文吗?以下是小编为大家收集的优秀范文,欢迎大家分享阅读。

怎样编写一个独立的php扩展函数篇一

有时候独立扩展需要是共享的已供其他模块加载。那么大家知道怎样编写一个独立的php扩展吗?下面一起来看看!

独立的 php 扩展可以独立于 php 源码之外进行分发。要创建一个这样的扩展,需要准备好两样东西:

你的模块源码

接下来我们来描述一下如果创建这些文件并组合起来。

准备好系统工具

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

gnu autoconf

gnu automake

gnu libtool

gnu m4

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

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

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

$ mkdir /tmp/newext

$ cd /tmp/newext

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

$ cp -rp php-4.0.x/ext/mysql/* .

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

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

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

$ phpize

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

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

$ ./configure

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

[--with-mysql=mysql-dir]

$ make install

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

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

定义一个新扩展

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

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

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

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

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

修改 m4 后缀的配置文件

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

php_arg_enable(foobar,whether to enable foobar,

[ --enable-foobar enable foobar])

if test "$php_foobar" != "no"; then

php_new_extension(foobar, foo.c bar.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 代码来处理函数的参数。具体信息可以查看 _skel。

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

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

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

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

$ /php/bin/phpize

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

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

安装扩展

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

$ ./configure

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

$ make install

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

在 config.m4 文件中,使用 php_arg_with/php_arg_enable 来设定扩展,这样就可以自动使用 --with-foo=shared[,..] 或 --enable-foo=shared[,..] 这样的指令作为编译参数了。

在 config.m4 文件中,使用 php_new_extension(foo,.., $ext_shared) 使扩展可以被构建。

添加以下代码到你的 c 语言资源文件中:

#ifdef compile_dl_foo

zend_get_module(foo)

#endif

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

s("content_relate");

【怎样编写一个独立的php扩展】相关文章:

php pdo的扩展内容08-20php扩展程序讲解09-30php下zmq扩展安装-208-17php 5.x 扩展开发要点08-18linux下用phpize给php动态添加扩展09-14怎样编写导游词06-30php中该怎样防止sql注入08-23php网页怎样清除病毒清08-21怎样才能成为php高手?09-08

猜你喜欢 网友关注 本周热点 软件
musicolet
2025-08-21
BBC英语
2025-08-21
百度汉语词典
2025-08-21
精选文章
基于你的浏览为你整理资料合集
2023年怎样编写一个独立的php扩展函数模板 文件夹
复制