PHP-Hooks

                                           

Von PHP bereitgestellte Hooks

PHP und Zend Engine bieten viele verschiedene Hooks für Erweiterungen, mit denen Erweiterungsentwickler die PHP-Laufzeit steuern können eine Möglichkeit, die PHP Userland nicht bieten kann.

In diesem Kapitel werden verschiedene Hooks und häufige Anwendungsfälle für sie von Erweiterungs-Hooks gezeigt.

Das allgemeine Muster für die Einbindung in die PHP-Funktionalität besteht darin, die vom PHP-Kern bereitgestellten Override-Funktionszeiger zu erweitern. Die Erweiterungsfunktion erledigt dann normalerweise ihre eigene Arbeit und ruft die ursprünglichen PHP-Kernfunktionen auf. Mithilfe dieses Musters können verschiedene Erweiterungen denselben Hook überschreiben, ohne dass es zu Konflikten kommt.

Verwandte Lernempfehlungen: PHP-Programmierung vom Einstieg bis zur Beherrschung

Einbindung in die Ausführung von Funktionen

Der Hook ist in

definiert:Zend/zend_execute.h

ZEND_API extern void (*zend_execute_ex)(zend_execute_data *execute_data);ZEND_API extern void (*zend_execute_internal)(zend_execute_data *execute_data, zval *return_value);

Wenn Sie diese Funktionszeiger überschreiben möchten, müssen Sie dies in Minit tun, da andere Entscheidungen in Zend Engine darauf basieren, ob der Zeiger wird überschrieben. Diese Tatsache wird im Voraus festgelegt. Das übliche Muster für das Überschreiben von

ist dieses:

static void (*original_zend_execute_ex) (zend_execute_data *execute_data);static void (*original_zend_execute_internal) (zend_execute_data *execute_data, zval *return_value);void my_execute_internal(zend_execute_data *execute_data, zval *return_value);void my_execute_ex (zend_execute_data *execute_data);PHP_MINIT_FUNCTION(my_extension){
    REGISTER_INI_ENTRIES();

    original_zend_execute_internal = zend_execute_internal;
    zend_execute_internal = my_execute_internal;

    original_zend_execute_ex = zend_execute_ex;
    zend_execute_ex = my_execute_ex;

    return SUCCESS;}PHP_MSHUTDOWN_FUNCTION(my_extension){
    zend_execute_internal = original_zend_execute_internal;
    zend_execute_ex = original_zend_execute_ex;

    return SUCCESS;}

Ein Nachteil des Überschreibens von

besteht darin, dass es das Verhalten der Zend Virtual Machine-Laufzeit ändert, um Rekursion zu verwenden, anstatt die Handle-Aufrufe des Interpreters zu belassen im Falle einer Schleife. Darüber hinaus können PHP-Engines, die zend_execute_ex nicht überschreiben, auch optimiertere Opcodes für Funktionsaufrufe generieren. zend_execute_ex

Diese Hooks sind abhängig von der Komplexität des ursprünglichen Funktionskapselungscodes sehr leistungsempfindlich.

Interne Funktionen überschreiben

Beim Überschreiben eines Ausführungs-Hooks kann die Erweiterung

jeden Funktionsaufruf protokollieren, Sie können auch Userland, Core und Individual überschreiben Funktionszeiger auf Erweiterungsfunktionen (und Methoden). Es weist bessere Leistungsmerkmale auf, wenn die Erweiterung nur Zugriff auf bestimmte interne Funktionsaufrufe benötigt.

#if PHP_VERSION_ID < 70200typedef void (*zif_handler)(INTERNAL_FUNCTION_PARAMETERS);#endif
zif_handler original_handler_var_dump;ZEND_NAMED_FUNCTION(my_overwrite_var_dump){
    // 如果我们想调用原始函数
    original_handler_var_dump(INTERNAL_FUNCTION_PARAM_PASSTHRU);}PHP_MINIT_FUNCTION(my_extension){
    zend_function *original;

    original = zend_hash_str_find_ptr(EG(function_table), "var_dump", sizeof("var_dump")-1);

    if (original != NULL) {
        original_handler_var_dump = original->internal_function.handler;
        original->internal_function.handler = my_overwrite_var_dump;
    }}

Beim Überschreiben einer Klassenmethode finden Sie die Funktionstabelle unter

: zend_class_entry

zend_class_entry *ce = zend_hash_str_find_ptr(CG(class_table), "PDO", sizeof("PDO")-1);if (ce != NULL) {
    original = zend_hash_str_find_ptr(&ce->function_table, "exec", sizeof("exec")-1);

    if (original != NULL) {
        original_handler_pdo_exec = original->internal_function.handler;
        original->internal_function.handler = my_overwrite_pdo_exec;
    }}

Ändern Sie den Abstract Syntax Tree (AST)

Wenn PHP 7 kompiliert wird, wird PHP-Code zunächst in einen abstrakten Syntaxbaum (AST) konvertiert und schließlich Opcodes generiert, die im Opcache gespeichert werden.

Der Hook wird von jedem kompilierten Skript aufgerufen und ermöglicht Ihnen, den AST zu ändern, nachdem er analysiert und erstellt wurde. zend_ast_process

Dies ist einer der komplexesten Hooks, da er umfassende Kenntnisse des AST erfordert. Das Erstellen eines ungültigen AST hier kann zu unerwartetem Verhalten oder Abstürzen führen.

Schauen Sie sich besser eine Beispielerweiterung an, die diesen Hook verwendet:

Google Stackdriver PHP Debugger Extension
• Ein Proof-of-Concept mit AST basierend auf Stackdriver

Vertraute Skript-/Dateikompilierung

Immer wenn ein Benutzerskript

/include oder das entsprechende require/include_once aufruft, wird PHP The Der Kernel wird diese Anfrage am Zeiger require_once verarbeiten. Der Parameter ist ein Dateihandle und das Ergebnis ist zend_compile_file处调用该函数. zend_op_array

zend_op_array * my_extension_compile_file(zend_file_handle * file_handle，int类型);

Es gibt zwei Erweiterungen im PHP-Kern, die diesen Hook implementieren: dtrace und opcache.

–

wird für USE_ZEND_DTRACE verwendet, wenn Sie Ihr PHP-Skript mit der Umgebungsvariablen dtrace_compile_file starten und PHP mit dtrace-Unterstützung kompiliert haben. Zend / zend_dtrace.c – Opcache speichert das Op-Array für eine bessere Leistung im gemeinsam genutzten Speicher. Wenn also ein Skript kompiliert wird, wird das endgültige Op-Array aus dem Cache bereitgestellt und nicht neu kompiliert. Sie finden diese Implementierung in
. ext / opcache / ZendAccelerator.c – Die Standardimplementierung mit dem Namen
ist Teil des Scannercodes in compile_file. Zend / zend_language_scanner.l

Anwendungsfälle für die Implementierung dieses Hooks sind Opcode-Beschleunigung, PHP-Code-Verschlüsselung/-Entschlüsselung, Debugging oder Profiling.

Sie können diesen Hook jederzeit ersetzen, während der PHP-Prozess ausgeführt wird, und alle nach dem Austausch kompilierten PHP-Skripte werden von der Implementierung des Hooks verarbeitet.

Es ist sehr wichtig, immer den rohen Funktionszeiger aufzurufen, da PHP sonst das Skript nicht mehr kompilieren kann und Opcache nicht mehr funktioniert.

此处的扩展覆盖顺序也很重要，因为您需要知道是要在Opcache之前还是之后注册钩子，因为Opcache如果在其共享内存缓存中找到操作码数组条目，则不会调用原始函数指针。 Opcache将其钩子注册为启动后钩子，该钩子在扩展的minit阶段之后运行，因此默认情况下，缓存脚本时将不再调用该钩子。

调用错误处理程序时的通知

与PHP用户区set_error_handler()函数类似，扩展可以通过实现zend_error_cb钩子将自身注册为错误处理程序：

ZEND_API void(* zend_error_cb)(int类型，const char * error_filename，const uint32_t error_lineno，const char * format，va_list args);

type变量对应于E _ *错误常量，该常量在PHP用户区中也可用。

PHP核心和用户态错误处理程序之间的关系很复杂：

1.如果未注册任何用户级错误处理程序，则始终调用zend_error_cb。
2.如果注册了userland错误处理程序，则对于E_ERROR，E_PARSE，E_CORE_ERROR，E_CORE_WARNING，E_COMPILE_ERROR的所有错误和E_COMPILE_WARNING始终调用zend_error_cb挂钩。
3.对于所有其他错误，仅在用户态处理程序失败或返回false时调用zend_error_cb。

另外，由于Xdebug自身复杂的实现，它以不调用以前注册的内部处理程序的方式覆盖错误处理程序。

因此，覆盖此挂钩不是很可靠。

再次覆盖应该以尊重原始处理程序的方式进行，除非您想完全替换它：

void(* original_zend_error_cb)(int类型，const char * error_filename，const uint error_lineno，const char * format，va_list args);void my_error_cb(int类型，const char * error_filename，const uint error_lineno，const char * format，va_list args){
    //我的特殊错误处理

    original_zend_error_cb(type，error_filename，error_lineno，format，args);}PHP_MINIT_FUNCTION(my_extension){
    original_zend_error_cb = zend_error_cb;
    zend_error_cb = my_error_cb;

    return SUCCESS;}PHP_MSHUTDOWN(my_extension){
    zend_error_cb = original_zend_error_cb;}

该挂钩主要用于为异常跟踪或应用程序性能管理软件实施集中式异常跟踪。

引发异常时的通知

每当PHP Core或Userland代码引发异常时，都会调用zend_throw_exception_hook并将异常作为参数。

这个钩子的签名非常简单：

void my_throw_exception_hook(zval * exception){
    if(original_zend_throw_exception_hook！= NULL){
        original_zend_throw_exception_hook(exception);
    }}

该挂钩没有默认实现，如果未被扩展覆盖，则指向NULL。

static void(* original_zend_throw_exception_hook)(zval * ex);void my_throw_exception_hook(zval * exception);PHP_MINIT_FUNCTION(my_extension){
    original_zend_throw_exception_hook = zend_throw_exception_hook;
    zend_throw_exception_hook = my_throw_exception_hook;

    return SUCCESS;}

如果实现此挂钩，请注意无论是否捕获到异常，都会调用此挂钩。将异常临时存储在此处，然后将其与错误处理程序挂钩的实现结合起来以检查异常是否未被捕获并导致脚本停止，仍然有用。

实现此挂钩的用例包括调试，日志记录和异常跟踪。

挂接到eval()

PHPeval不是内部函数，而是一种特殊的语言构造。因此，您无法通过zend_execute_internal或通过覆盖其函数指针来连接它。

挂钩到eval的用例并不多，您可以将其用于概要分析或出于安全目的。如果更改其行为，请注意可能需要评估其他扩展名。一个示例是Xdebug，它使用它执行断点条件。

extern ZEND_API zend_op_array *(* zend_compile_string)(zval * source_string，char * filename);

挂入垃圾收集器

当可收集对象的数量达到一定阈值时，引擎本身会调用gc_collect_cycles()或隐式地触发PHP垃圾收集器。

为了使您了解垃圾收集器的工作方式或分析其性能，可以覆盖执行垃圾收集操作的函数指针挂钩。从理论上讲，您可以在此处实现自己的垃圾收集算法，但是如果有必要对引擎进行其他更改，则这可能实际上并不可行。

int(* original_gc_collect_cycles)(无效);int my_gc_collect_cycles(无效){
    original_gc_collect_cycles();}PHP_MINIT_FUNCTION(my_extension){
    original_gc_collect_cycles = gc_collect_cycles;
    gc_collect_cycles = my_gc_collect_cycles;

    return SUCCESS;}

覆盖中断处理程序

当执行器全局EG(vm_interrupt)设置为1时，将调用一次中断处理程序。在执行用户域代码期间，将在常规检查点对它进行检查。引擎使用此挂钩通过信号处理程序实现PHP执行超时，该信号处理程序在达到超时持续时间后将中断设置为1。

当更安全地清理或实现自己的超时处理时，这有助于将信号处理推迟到运行时执行的后期。通过设置此挂钩，您不会意外禁用PHP的超时检查，因为它具有自定义处理的优先级，该优先级高于对zend_interrupt_function的任何覆盖。

ZEND_API void(* original_interrupt_function)(zend_execute_data * execute_data);void my_interrupt_function(zend_execute_data * execute_data){
    if(original_interrupt_function！= NULL){
        original_interrupt_function(execute_data);
    }}PHP_MINIT_FUNCTION(my_extension){
    original_interrupt_function = zend_interrupt_function;
    zend_interrupt_function = my_interrupt_function;

    return SUCCESS;}

##替换操作码处理程序

TODO

Das obige ist der detaillierte Inhalt vonPHP-Hooks. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!