概述php如何发布扩展信息发布扩展信息
发布扩展信息
扩展可以发布 PHPinfo()
或反射API要求的信息。我们一起来看一下。
本章不会太长,因为真的很简单。
相关学习推荐:PHP编程从入门到精通
MINFO( ) 挂钩
如果声明了,一切都在声明的 MINFO()
挂钩中进行。如果未声明,则引擎将运行默认功能以打印有关扩展名的信息。该功能只会打印扩展程序的版本以及最终声明的 INI条目 。
如果要加入此过程,则必须在扩展结构中声明一个 MINFO()
hook。
注意
一切都在 ext / standard / info.c 中进行,您可以阅读该文件。引擎通过调用 PHP_info_print_module() 来打印有关PHP扩展的信息
下面是一个简单的 MINFO()
案例:
#include "PHP/main/SAPI.h"#include "ext/standard/info.h"#define PIB_TXT "PHPInternalsBook Authors"#define PIB_HTML "<h3>" PIB_TXT "</h3>"PHP_MINFO_FUNCTION(pib){ time_t t; char cur_time[32]; time(&t); PHP_asctime_r(localtime(&t), cur_time); PHP_info_print_table_start(); PHP_info_print_table_colspan_header(2, "PHPInternalsBook"); PHP_info_print_table_row(2, "Current time", cur_time); PHP_info_print_table_end(); PHP_info_print_Box_start(0); if (!sAPI_module.PHPinfo_as_text) { PHP_write(PIB_HTML, strlen(PIB_HTML)); } else { PHP_write(PIB_TXT, strlen(PIB_TXT)); } PHP_info_print_Box_end();}Zend_module_entry pib_module_entry = { STANDARD_MODulE_header, "pib", NulL, /* Function 入口 */ NulL, /* Module 初始化 */ NulL, /* Module 关闭 */ NulL, /* Request 初始化 */ NulL, /* Request 关闭 */ PHP_MINFO(pib), /* Module information */ "0.1", /* 扩展的版本号写在这里 */ STANDARD_MODulE_PROPERTIES};
你要做的主要是处理 PHP_info_print_*()
API,它允许你将信息打印到生成的输出流中。如果你想要打印一些原始的信息,一个简单的 PHP_write()
就足够了。PHP_write()
就是把你传入的信息当作 SAPI 输出流的一个参数, 而 PHP_info_print_*()
API 也是一样,但是之前会被按照要求格式化,如果想要 HTML 格式,则会使用 HTML 的 table-tr-td 标签,如果不需要格式化成 HTML 的话,就会简单的用空格间隔。
如你所见,你必须 include ext/standard/info.h 以引入 PHP_info_print_*()
API ,并且你还需要引入 PHP/main/SAPI.h 来获得 sAPI_module
符号。这个符号是全局的,它代表了当前 PHP 进程所使用的 SAPI 。PHPinfo_as_text
字段告诉你,如果你准备写入一个类似比如 PHP-fpm 的 “Web” 的 SAPI 或者写入一个类似 PHP-cli 的 “text” 的(SAPI)。
能触发你的 MINFO()
钩子的是下面这些:
调用用户端的 PHPinfo()
函数PHP -i
、 php-cgi -i
、 PHP-fpm -i
。或者更抽象的表述就是 <SAPI_binary> - i
PHP --ri
或者用户端的 ReflectionExtension::info()
注意:
要留意输出的格式。如果你需要在 text 和 HTML 之间转换格式,就研究一下
sAPI_module.PHPinfo_as_text
。你无法得知在用户端扩展的信息是被如何调用的。
如果你要展示你的 INI 设置,只要在你的 MINFO()
中调用 disPLAY_INI_ENTRIES()
宏即可。这个宏的解析看这里 display_ini_entrIEs().
能触发你的 MINFO()
钩子的是下面这些:
调用用户端的 PHPinfo()
函数PHP -i
、 php-cgi -i
、 PHP-fpm -i
。或者更抽象的表述就是 <SAPI_binary> - i
PHP --ri
或者用户端的 ReflectionExtension::info()
注意:
要留意输出的格式。如果你需要在 text 和 HTML 之间转换格式,就研究一下
sAPI_module.PHPinfo_as_text
。你无法得知在用户端扩展的信息是被如何调用的。
如果你要展示你的 INI 设置,只要在你的 MINFO()
中调用 disPLAY_INI_ENTRIES()
宏即可。这个宏的解析看这里 display_ini_entrIEs().
关于反射 API 的说明
反射大量使用你的Zend_module_entry
结构。例如,当你调用ReflectionExtension::getVersion()
时,API 只会读取Zend_module_entry
结构的版本字段。
与发现函数相同,你的Zend_module_entry
具有一个const struct _Zend_function_entry * functions
成员,该成员用于注册PHP函数。
基本上,PHP 用户区反射 API 只会读取你的Zend_module_entry
结构并发布这些信息。它还可以使用你的module_number
来收集在引擎的不同位置注册的扩展的信息。例如,ReflectionExtension::getinientrIEs()
或 ReflectionExtension::getClasses()
使用了这个。 总结
以上是内存溢出为你收集整理的php如何发布扩展信息发布扩展信息全部内容,希望文章能够帮你解决php如何发布扩展信息发布扩展信息所遇到的程序开发问题。
如果觉得内存溢出网站内容还不错,欢迎将内存溢出网站推荐给程序员好友。
请登录后查看评论内容