Publish extended information

Extensions can publishphpinfo()or the information required by the reflection API. Let's take a look together.

This chapter won’t be too long because it’s really simple.

Related learning recommendations:PHP programming from entry to proficiency

MINFO() hook

If declared, everything will Do it in the declaredMINFO()hook. If not declared, the engine will run a default function to print information about the extension. This function will only print the extension's version and the final declared INI entry.

If you want to join this process, you must declare aMINFO()hook in the extension structure.

NOTE

Everything happens in ext/standard/info.c, which you can read. The engine prints information about PHP extensions by calling php_info_print_module()

The following is a simpleMINFO()case:

#include "php/main/SAPI.h" #include "ext/standard/info.h" #define PIB_TXT "PHPInternalsBook Authors" #define PIB_HTML "
" PIB_TXT "
" 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 };

The main thing you have to do is deal with thephp_info_print_*()API, which allows you to print information to the generated output stream. If you want to print some raw information, a simplephp_write()will suffice.php_write()treats the information you pass in as a parameter of the SAPI output stream, andphp_info_print_*()API is the same, but it will be formatted as required before. If If you want HTML format, you will use HTML'stable-tr-tdtag. If you don't need to format it into HTML, you will simply use spaces to separate it.

As you can see, you have to includeext/standard/info.hto introduce thephp_info_print_*()API, and you also need to includephp /main/SAPI.hto get thesapi_modulesymbol. This symbol is global and represents theSAPIused by the current PHP process. Thephpinfo_as_textfield tells you if you are going to write a "Web" SAPI likephp-fpmor write a "Web" likephp-clitext” (SAPI).

What can trigger yourMINFO()hook is the following:

• Call the client’sphpinfo()function
• php -i,php-cgi -i,php-fpm -i. Or a more abstract expression is - i
• ##php --rior the client'sReflectionExtension::info()

Note:

Pay attention to the output format. If you need to convert between text and HTML, look into

sapi_module.phpinfo_as_text. You have no way of knowing how the extended information on the client side is called.

If you want to display your INI settings, just call the

DISPLAY_INI_ENTRIES()macro in yourMINFO(). For the analysis of this macro, see display_ini_entries().

The hooks that can trigger your

MINFO()are the following:

Calling the client's
• phpinfo()Function
• php -i,php-cgi -i,php-fpm -i. Or a more abstract expression is - i
##php --ri
• or the client'sReflectionExtension::info()

Note:

Pay attention to the output format. If you need to convert between text and HTML, look into

sapi_module.phpinfo_as_text

. You have no way of knowing how the extended information on the client side is called.

If you want to display your INI settings, just call the

DISPLAY_INI_ENTRIES()

macro in yourMINFO(). For the analysis of this macro, see display_ini_entries().Instructions on the reflection API

Reflection uses your

zend_module_entry

structure extensively. For example, when you callReflectionExtension::getVersion(), the API will only read the version field of thezend_module_entrystructure.Same as discovering functions, your

zend_module_entry

has aconst struct _zend_function_entry * functionsmember, which is used to register PHP functions.

Basically, the PHP userland reflection API just reads your zend_module_entrystructure and publishes that information. It can also use yourmodule_numberto collect information about extensions registered in different places in the engine. For example,ReflectionExtension::getINIentries()orReflectionExtension::getClasses()use this.

The above is the detailed content of How to publish extended information in php. For more information, please follow other related articles on the PHP Chinese website!