5、扩展骨架文件内容

最新推荐文章于 2024-02-08 12:02:56 发布
最新推荐文章于 2024-02-08 12:02:56 发布
阅读量266 收藏
点赞数
原文链接：https://www.zend.com/extension-skeleton-file-content
版权

女主宣言

今天小编为大家分享编写PHP扩展的系列文章，文章从环境构建到扩展编写，会对使用到的相关PHP内核数据结构及API进行介绍，希望能对大家有所帮助。

PS：丰富的一线技术、多元化的表现形式，尽在“360云计算”，点关注哦！

我们先回顾一下扩展骨架文件的内容。

“config.m4”是扩展配置脚本，在通过“phpize”或“buildconf”命令生成“配置”脚本期间使用。它是用M4宏处理语言编写的。对于PHP扩展配置，非常基础的知识就足够了。可以从本教程或其他扩展配置文件中复制粘贴代码块。

PHP_ARG_ENABLE([test],
    [whether to enable test support],
    [AS_HELP_STRING([--enable-test],
        [Enable test support])],
    [no])

if test "$PHP_TEST" != "no"; then
    AC_DEFINE(HAVE_TEST, 1, [ Have test support ])
    PHP_NEW_EXTENSION(test, test.c, $ext_shared)
fi

PHP_ARG_ENABLE(...) 宏添加配置选项“--enable-test”。它可能会获得三个值“yes”，“no”和“shared”。

当运行“phpize”时，默认值为“shared”，这意味着我们将构建一个可动态加载的PHP扩展。但是，可以将“test”扩展目录复制到主PHP发行版（“ext/test”）中，然后重新运行“./buildconf”和“./configure…–enable-test”以重新构建整个PHP，扩展名为“test”，静态链接。

默认情况下可以启用扩展，在第5行将“no”替换为“yes”。在这种情况下，可以通过“./configure --disable-test”禁用“test”扩展。

在“if”之后的只是一个常规的UNIX shell代码，它测试由“--enable-test”，“--disable-test”或“--enable-test=shared”定义的值。

AC_DEFINE(HAVE_TEST)将C宏HAVE_TEST添加到“config.h”中，因此如有必要，可以使用条件编译指令（#ifdef，#ifndef）跳过无用的代码。

最后，PHP_NEW_EXTENSION(test, test.c, $ext_shared)宏指出，将从“test.c”文件构建扩展“test”。可以指定几个文件。根据$ ext_shared变量的值，扩展名可以构建为共享对象或静态链接。（它取自相同的“--enable-test”选项。）

如果添加新的源文件或需要链接某些外部库，则可能需要扩展此文件。稍后将说明如何链接库。只是，不要忘记在此文件中进行任何更改后重新运行“phpize” / “buildconf” +“configure”。

Windows PHP使用不同的构建系统。对于Windows，文件“config.w32”代替了“config.m4”。两者几乎相同。他们使用相似的宏，只是一种不同的语言：在Windows PHP构建系统上，使用JavaScript而不是M4和Shell。将不再重复对宏的解释。

ARG_ENABLE('test', 'test support', 'no');

if (PHP_TEST != 'no') {
    AC_DEFINE('HAVE_TEST', 1, 'test support enabled');
    EXTENSION('test', 'test.c', null, '/DZEND_ENABLE_STATIC_TSRMLS_CACHE=1');
}

“php_test.h”是具有通用定义的C头文件。在我们最基本的情况下，它定义：

  • test_module_entry — 扩展描述结构。（扩展程序的入口）

  • PHP_TEST_VERSION — 扩展的版本。

  • ZEND_TSRMLS_CACHE_EXTERN — 如果扩展是为线程安全的版本（ZTS）构建并编译为共享对象（COMPILE_DL_TEST），则为线程本地存储缓存条目。

/* test extension for PHP */

#ifndef PHP_TEST_H
# define PHP_TEST_H

extern zend_module_entry test_module_entry;
# define phpext_test_ptr &test_module_entry

# define PHP_TEST_VERSION "0.1.0"

# if defined(ZTS) && defined(COMPILE_DL_TEST)
ZEND_TSRMLS_CACHE_EXTERN()
# endif

#endif	/* PHP_TEST_H */

“test.c”是主要扩展源文件。我们将其分成小部分来分别解释。

/* test extension for PHP */

#ifdef HAVE_CONFIG_H
# include "config.h"
#endif

#include "php.h"
#include "ext/standard/info.h"
#include "php_test.h"

包括必要的C头文件。如有必要，可以添加其他“#include”指令。

/* For compatibility with older PHP versions */
#ifndef ZEND_PARSE_PARAMETERS_NONE
#define ZEND_PARSE_PARAMETERS_NONE() \
    ZEND_PARSCE_PARAMETERS_START(0, 0) \
    ZEND_PARSE_PARAMETERS_END()
#endif

一些向前兼容性宏，以便可以为较旧的PHP-7版本编译扩展。

/* {{{ void test_test1()
 */
PHP_FUNCTION(test_test1)
{
    ZEND_PARSE_PARAMETERS_NONE();

    php_printf("The extension %s is loaded and working!\r\n", "test");
}
/* }}} */

我们的PHP扩展提供的功能test_test1()的C代码。PHP_FUNCTION()宏的参数是函数名称。ZEND_PARSE_PARAMETERS_NONE()表示此函数不需要任何参数。php_printf(...)只是一个C函数调用，该函数将字符串打印到输出流中，类似于PHP printf()函数。

/* {{{ string test_test2( [ string $var ] )
 */
PHP_FUNCTION(test_test2)
{
    char *var = "World";
    size_t var_len = sizeof("World") – 1;
    zend_string *retval;

    ZEND_PARSE_PARAMETERS_START(0, 1)
        Z_PARAM_OPTIONAL
        Z_PARAM_STRING(var, var_len)
    ZEND_PARSE_PARAMETERS_END();

    retval = strpprintf(0, "Hello %s", var);

    RETURN_STR(retval);
}
/* }}}*/

另一个更复杂的函数使用“快速参数解析API”来描述其参数。

ZEND_PARSE_PARAMETERS_START(0, 1)启动参数描述部分。它的第一个参数(0)定义所需参数的数量。

第二个自变量(1)定义最大自变量数。因此，我们的函数可以不带参数调用，也可以带单个参数调用。

在本节中，我们应该定义所有参数，它们的类型以及将它们复制到的位置。对于我们的情况：

  • Z_PARAM_OPTIONAL 将必需的参数与可选的参数分开。

  • Z_PARAM_STRING() 定义一个字符串参数，该值将被复制到变量“var”，将长度复制到变量“var_len”。

请注意，我们的参数是可选的，因此可以省略。在这种情况下，将使用默认值“world”。参见ZEND_PARSE_PARAMETERS_START上方的变量“var”和“var_len”的初始化程序。

该代码创建一个“zend_string”值，并通过类似于PHP sprintf() 函数的宏RETURN_STR()返回该值：

/* {{{ PHP_RINIT_FUNCTION
 */
PHP_RINIT_FUNCTION(test)
{
#if defined(ZTS) && defined(COMPILE_DL_TEST)
    ZEND_TSRMLS_CACHE_UPDATE();
#endif

    return SUCCESS;
}
/* }}} */

PHP_RINIT_FUNCTION()定义了一个回调函数，它将在每次请求启动时被调用。在我们的情况下，它仅初始化线程本地存储缓存。尽早进行此操作（在MINIT或GINIT回调中）会更好。预计这将在PHP 8扩展框架中得到解决。

/* {{{ PHP_MINFO_FUNCTION
 */
PHP_MINFO_FUNCTION(test)
{
    php_info_print_table_start();
    php_info_print_table_header(2, "test support", "enabled");
    php_info_print_table_end();
}
/* }}} */

PHP_MINFO_FUNCTION()定义了一个回调函数，该函数将从PHP phpinfo()函数中调用，以打印有关扩展的信息。

/* {{{ arginfo
    */
ZEND_BEGIN_ARG_INFO(arginfo_test_test1, 0)
ZEND_END_ARG_INFO()

有关第一个函数的参数的信息。没有参数。

ZEND_BEGIN_ARG_INFO(arginfo_test_test2, 0)
    ZEND_ARG_INFO(0, str)
ZEND_END_ARG_INFO()
/* }}} */

有关第二个函数的参数的信息。名称为“str”的单个可选参数按值传递。

/* {{{ test_functions[]
 */
static const zend_function_entry test_functions[] = {
    PHP_FE(test_test1,		arginfo_test_test1)
    PHP_FE(test_test2,		arginfo_test_test2)
    PHP_FE_END
};
/* }}} */

“test_functions”是所有扩展功能的列表，以及有关其参数的信息。该列表由PHP_FE_END宏终止。

/* {{{ test_module_entry
 */
zend_module_entry test_module_entry = {
    STANDARD_MODULE_HEADER,
    "test",				/* Extension name */
    test_functions,			/* zend_function_entry */
    NULL,				/* PHP_MINIT - Module initialization */
    NULL,				/* PHP_MSHUTDOWN - Module shutdown */
    PHP_RINIT(test),			/* PHP_RINIT - Request initialization */
    NULL,				/* PHP_RSHUTDOWN - Request shutdown */
    PHP_MINFO(test),			/* PHP_MINFO - Module info */
    PHP_TEST_VERSION,			/* Version */
    STANDARD_MODULE_PROPERTIES
};
/* }}} */

test_module_entry 是主要的扩展条目结构。PHP核心从此类结构获取有关扩展的所有信息。它定义：

  • 扩展名(“test”)。

  • 声明的PHP函数列表(“test_functions”)。

  • 一些回调函数和扩展版本（PHP_TEST_VERSION-在头文件中定义）。

回调发生在以下情况：当PHP启动（MINIT），PHP终止（MSHUTDOWN），每个请求处理的开始（RINIT），每个请求处理的结束（RSHUTDOWN）以及来自phpinfo()（MINFO）的回调。

#ifdef COMPILE_DL_TEST
# ifdef ZTS
ZEND_TSRMLS_CACHE_DEFINE()
# endif
ZEND_GET_MODULE(test)
#endif

最后，为动态链接的两个定义。

如果大家有什么建议或疑问，可以在下方留言交流。

360云计算

由360云平台团队打造的技术分享公众号，内容涉及数据库、大数据、微服务、容器、AIOps、IoT等众多技术领域，通过夯实的技术积累和丰富的一线实战经验，为你带来最有料的技术分享

ZVAyIVqt0UFji
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
【PHP7源码分析】PHP中$_POST揭秘
weixin_34391445的博客
10-31 1620
运营研发团队 季伟滨 一、前言 前几天的工作中，需要通过curl做一次接口测试。让我意外的是，通过$_POST竟然无法获取到Content-Type是application/json的http请求的body参数。 查了下php官网（http://php.net/manual/zh/rese...）对$_POST的描述，的确是这样。后来...
上古卷轴5json文件修改_捏脸工具-RaceMenu
weixin_39867066的博客
12-22 3565
要求需要运行RaceMenu 的Skyrim脚本扩展器(SKSE)，版本1.7.2(或更新版本)。如果您不知道如何或无法自行安装SKSE，我建议您观看：Gopher的英文SKSE安装视频Frank SiriuS的德国SKSE安装视频RaceMenu相关的SKSE插件：CharGen扩展 (CoreMenu 2.5及更高版本附带的核心)NetImmerse Override Standalone...
maven骨架文件
qq_35900437的博客
01-03 425
骨架文件内容设置     xmlns="http://maven.apache.org/plugins/maven-archetype-plugin/archetype-catalog/1.0.0"     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"     xsi:schemaLocation="http://
PDS骨架示例：文件和文件夹结构的标准
culi4814的博客
08-21 780
pds文件Looking at the Packagist registry, we can see that most packages follow a pattern, with some small changes to fit their needs, while others have a weird folder structure that takes time to get yo...
PHP xhprof 扩展原理
pythonluo的专栏
09-03 690
简介：由于公司项目，最近需要分析后端PHP接口的性能数据，就采用了FACEBOOK之前开源的一个扩展，现在市面上很多分支都是基于FB最开始的线开发的，但是由于FB已经停止维护，所以现在其他线都是自己个人在维护。 今天我分析的这个分支是兼容PHP7+的版本收集性能数据，先贴出GITHUB的链接https://github.com/longxinH/xhprof 扩展的安装方式和PHP调用的A...
扩展实现php继承
云端
11-20 768
php代码： <?php interface i_myinterface { public function hello(); } class parent_class implements i_myinterface { public function hello() { echo "Good Morning!\n"; } } final class m
HTML5简介与基础骨架
2301_79951760的博客
02-08 2091
标签有两种表现形式：1.双标签，例如：
vim-skels:vim 骨架文件
08-04
【vim-skels: Vim 骨架文件】是为 Vim 和 Neovim 用户提供的一种高效配置框架，旨在简化编辑器的初始设置和扩展管理。它利用了流行的 Vim 插件管理器 `vim-plug`，使得用户能够快速、有序地安装和管理一系列预先配置...
skeletons:HTML 5 骨架
07-13
骨架文件“skeletons-gh-pages”可能是一个GitHub Pages项目，这是一个托管服务，允许用户将GitHub仓库内容发布到Web上。通常，这个文件夹结构包含了HTML、CSS和JavaScript文件，以及可能的图片和其他资源。HTML文件...
Vue页面骨架屏注入方法
08-27
我们可以在 /src 目录下新建一个 Skeleton.vue 文件，其内容可以是一个带有骨架屏样式的模板。然后，我们可以使用工具在构建时自动注入到 div#app 里面。 在 Skeleton.vue 文件中，我们可以使用 Vue 的模板语法来...
PHP扩展开发入门教程
12-18
**扩展骨架** PHP的官方扩展位于源码的`ext`目录。`ext_skel`脚本是一个用于生成PHP扩展骨架的工具，它能帮助快速创建自定义扩展。例如，创建名为`myext`的扩展： ```bash $ ./ext_skel --extname=myext ``` 在新...
PHP7扩展开发(二)：配置项与全局数值
weixin_34319817的博客
11-23 149
起步 Zend引擎提供了另种管理设置值(INI)的途径。现在弄个简单的，我们经常看到php.ini里有诸如 display_errors = On 这样的全局设置。假设我们需要为我们扩展定义一个值： hello.greeting 并用函数 hello_ini() 返回它的内容。 在php.ini: [hello] hello.greeti...
linux下安装libcurl及开源库的一般安装步骤
weixin_30315723的博客
11-06 218
　　前言 　　总有人说：要多看源代码！那么源代码去哪找呢？找到了又该怎么安装呢？本票博客不介绍如何使用和学习，只要讲获取和安装，以后会将curl和libevent的使用和学习。 　　一、开源库常用安装步骤 　　1、开源库下载 　　github全球最大的同性交流社区，还不赶紧get一下！里面有大量的开源项目和开源库，也可以上传自己的代码，注册一下帐户就可以了，这里就不讲怎么使用github了...
基于ASP.NET+MVC5+EF6开发企业网站.zip
08-22
项目工程资源经过严格测试可直接运行成功且功能正常的情况才上传，可轻松copy复刻，拿到资料包后可轻松复现出一样的项目，本人系统开发经验充足（全栈开发），有任何使用问题欢迎随时与我联系，我会及时为您解惑，提供帮助 【资源内容】：项目具体内容可查看/点击本页面下方的*资源详情*，包含完整源码+工程文件+说明（若有）等。【若无VIP，此资源可私信获取】 【本人专注IT领域】：有任何使用问题欢迎随时与我联系，我会及时解答，第一时间为您提供帮助 【附带帮助】：若还需要相关开发工具、学习资料等，我会提供帮助，提供资料，鼓励学习进步 【适合场景】：相关项目设计中，皆可应用在项目开发、毕业设计、课程设计、期末/期中/大作业、工程实训、大创等学科竞赛比赛、初期项目立项、学习/练手等方面中 可借鉴此优质项目实现复刻，也可基于此项目来扩展开发出更多功能 #注 1. 本资源仅用于开源学习和技术交流。不可商用等，一切后果由使用者承担 2. 部分字体及插图等来自网络，若是侵权请联系删除，本人不对所涉及的版权问题或内容负法律责任。收取的费用仅用于整理和收集资料耗费时间的酬劳 3. 积分资源不提供使用问题指导/解答
Steam家庭共享同时玩工具.bat
08-22
Steam家庭共享：两个人同时玩同一个游戏
基于Mysql和JAVA的股票交易系统.zip
08-22
项目工程资源经过严格测试可直接运行成功且功能正常的情况才上传，可轻松copy复刻，拿到资料包后可轻松复现出一样的项目，本人系统开发经验充足（全栈开发），有任何使用问题欢迎随时与我联系，我会及时为您解惑，提供帮助 【资源内容】：项目具体内容可查看/点击本页面下方的*资源详情*，包含完整源码+工程文件+说明（若有）等。【若无VIP，此资源可私信获取】 【本人专注IT领域】：有任何使用问题欢迎随时与我联系，我会及时解答，第一时间为您提供帮助 【附带帮助】：若还需要相关开发工具、学习资料等，我会提供帮助，提供资料，鼓励学习进步 【适合场景】：相关项目设计中，皆可应用在项目开发、毕业设计、课程设计、期末/期中/大作业、工程实训、大创等学科竞赛比赛、初期项目立项、学习/练手等方面中 可借鉴此优质项目实现复刻，也可基于此项目来扩展开发出更多功能 #注 1. 本资源仅用于开源学习和技术交流。不可商用等，一切后果由使用者承担 2. 部分字体及插图等来自网络，若是侵权请联系删除，本人不对所涉及的版权问题或内容负法律责任。收取的费用仅用于整理和收集资料耗费时间的酬劳 3. 积分资源不提供使用问题指导/解答
这个库用于存储及在组内共享《肖像印》项目数据.zip
08-22
项目工程资源经过严格测试可直接运行成功且功能正常的情况才上传，可轻松copy复刻，拿到资料包后可轻松复现出一样的项目，本人系统开发经验充足（全栈开发），有任何使用问题欢迎随时与我联系，我会及时为您解惑，提供帮助 【资源内容】：项目具体内容可查看/点击本页面下方的*资源详情*，包含完整源码+工程文件+说明（若有）等。【若无VIP，此资源可私信获取】 【本人专注IT领域】：有任何使用问题欢迎随时与我联系，我会及时解答，第一时间为您提供帮助 【附带帮助】：若还需要相关开发工具、学习资料等，我会提供帮助，提供资料，鼓励学习进步 【适合场景】：相关项目设计中，皆可应用在项目开发、毕业设计、课程设计、期末/期中/大作业、工程实训、大创等学科竞赛比赛、初期项目立项、学习/练手等方面中 可借鉴此优质项目实现复刻，也可基于此项目来扩展开发出更多功能 #注 1. 本资源仅用于开源学习和技术交流。不可商用等，一切后果由使用者承担 2. 部分字体及插图等来自网络，若是侵权请联系删除，本人不对所涉及的版权问题或内容负法律责任。收取的费用仅用于整理和收集资料耗费时间的酬劳 3. 积分资源不提供使用问题指导/解答
基于51单片机倒计时器秒表定时器数码管显示设计
最新发布
08-22
题目：基于51单片机倒计时器秒表定时器数码管显示设计（毕业设计） 系统构成： 本设计由STC89C52单片机核心电路+4位共阳数码管显示电路+蜂鸣器电路+按键电路+电源电路组成。 系统功能： 1、可以设置倒计时间1到99分种，倒计时最后5秒蜂鸣器报警提示。 2、在倒计时过程随时可以暂停和开始计时。 资料包含： 程序源码 电路图 任务书 答辩技巧 开题报告 参考论文 系统框图 程序流程图 使用到的芯片资料 器件清单 焊接说明 疑难问题说明
goproxy.tar
08-22
goproxy镜像文件
探索HTML5离线缓存与骨架屏开发实践
`manifest`文件虽然可以使用任意扩展名，但其MIME类型必须是`text/cache-manifest`。这个特性使得网站在用户首次访问时，会下载并存储指定的资源列表，以便在离线状态下仍能访问部分关键内容，提高可用性和用户体验...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值