PHPモジュール開発に関する知識の紹介

PHP コード アーキテクチャ

PHP のすべての部分は TSRM と呼ばれる層にあり、TSRM 層はスレッド セキュリティ管理 を担当します。一番下の SAPI は、コマンド ライン sapi の場合は php です。 -fpm は fastcgi の sapi であり、Apache のモジュール モードも

PHP カーネルと Zend エンジンであり、PHP カーネルはリクエスト管理/ネットワークとファイルの操作を担当し、Zend カーネルはコンパイルと処理を担当します。

これらすべてに加えて、PHP のほとんどの外部インターフェイスは拡張レイヤーを通じて提供されます。たとえば、標準や文字列などの言語ベースも拡張形式で提供されます。

拡張機能(後述) PHPに読み込む(モジュールと呼びます)方法には、静的コンパイルと動的リンクの2つの方法があります。静的コンパイルではPHPのconfigureスクリプトを再生成する必要がありますが、ここでは説明しません。動的リンク方法は、モジュールを .so ファイルに追加し、それを php に動的にロードします

.so ファイルをロードするには 2 つの方法があります。1 つは、extension=apc.so のように php.ini ファイルに書き込む方法です。コード ('xxx.so') で dl を使用します。

dl($library)

この関数は、モジュールをロードしてその内部機能を利用可能にすることです。

dl() 関数のソース コードは次のとおりです。 PHP ソース コードのルート ディレクトリ (PHP_SRC_HOME と略称)、PHP_SRC_HOME/ext/standard/dl.c、主要なプロセスは次のとおりです:

PHP_FUNCTION(dl)

PHPAPI PHP_FUNCTION(dl)  
{  
    //...  
    php_dl(filename, MODULE_TEMPORARY, return_value, 0 TSRMLS_CC);  
    //...   
}

php_dl

PHPAPI void php_dl(char *file, int type, zval *return_value, int start_now TSRMLS_DC)  
{  
    if (php_load_extension(file, type, start_now TSRMLS_CC) == FAILURE) {  
       //...  
}

php_load_extension

PHPAPI int php_load_extension(char *filename, int type, int start_now TSRMLS_DC) {  
    //文件名解析相关  
      
    //加载动态链接库  
    handle = DL_LOAD(libpath);  
      
    //加载错误处理  
      
    //获取模块的get_module函数(重点, 模块初始入口)  
    get_module = (zend_module_entry *(*)(void)) DL_FETCH_SYMBOL(handle, "get_module");  
      
    //get_module函数获取错误处理  
      
    //那个get_module()得到struct zend_module_entry  
    module_entry = get_module();  
    //...  
      
    //注册模块(重点, 函数在这里被注册)  
    if ((module_entry = zend_register_module_ex(module_entry TSRMLS_CC)) == NULL) {  
        //错误处理  
    }  
      
    //模块启动(重点, PHP_MINIT_FUNCTION)  
    if ((type == MODULE_TEMPORARY || start_now) && zend_startup_module_ex(module_entry TSRMLS_CC) == FAILURE) {  
        //错误处理  
    }  
      
    //模块请求启动(重点, PHP_RINIT_FUNCTION)  
    if ((type == MODULE_TEMPORARY || start_now) && module_entry->request_startup_func) {  
        //错误处理  
    }  
    return SUCCESS;  
}

process

get_module function

get_module = (zend_module_entry *(*)(void)) DL_FETCH_SYMBOL(handle, "get_module");

マクロ展開後のこのコードは次のようになります:

get_module = (zend_module_entry *(*) (void)) dlsym(handle, "_get_module");

dlsym() 関数が何をするのかは、簡単に理解できます。これは、ロードされたばかりのダイナミック リンク ライブラリから

関数ポインター

を取得するためのものです。私たちがモジュールを開発している目的。その時点で定義されている get_module 関数。 マクロ展開後、次のようになります (GNU の属性と C++ の extern "C" は考慮されません):

zend_module_entry *get_module(void) { return &sample_module_entry; }

dl() を置くことで、モジュール開発中の定義に関数のロードプロセスがリンクされ、モジュールがロードされると、ここからカスタマイズされた zend_module_entry が渡されることがわかります。 module

module_entry = zend_register_module_ex(module_entry TSRMLS_CC)

上記のコードは関数 php_load_extension から抽出されたもので、引き続き zend_register_module_ex() をドリルダウンして、関心のある関数登録を見つけます。 && zend_register_functions(NULL, module->functions, NULL, module-> ;type TSRMLS_CC)==FAILURE) {

zend_register_functions 関数の詳細を続けます:

ZEND_API int zend_register_functions(zend_class_entry *scope, const zend_function_entry *functions, HashTable *function_table, int type TSRMLS_DC) /* {{{ */ {  
    //...  
      
    //重点 如果没有函数符号表, 取全局函数符号表  
    if (!target_function_table) {  
        target_function_table = CG(function_table);  
    }  
      
    //...  
      
    //重点 循环zend_function_entry[]  
    while (ptr->fname) {  
        //向函数符号表增加函数  
        if (zend_hash_add(target_function_table, lowercase_name, fname_len+1, &function, sizeof(zend_function), (void**)?_function) == FAILURE) {  
            //错误处理  
        }  
      
        //...  
      
        //准备遍历zend_function_entry[]下一个元素  
        ptr++;  
      
        //...  
    }  
    //...  
      
    return SUCCESS;  
}

関数シンボル テーブルを取得するときに、CG マクロが使用されます:

target_function_table = CG(function_table);

これを 2 つの状況に分けます このマクロのロックを解除します:

//非线程安全  
compiler_globals.function_table  
      
//线程安全  
(((zend_compiler_globals *) (*((void ***) tsrm_ls))[ compiler_globals_id - 1])-> function_table)

最終的に取得するのは、HashTable である zend_compiler_globals の global

struct struct

function_table 要素です。

モジュールを開発する際は、zend_function_entryに関数トラバーサルを追加すればOK

モジュール起動/モジュールリクエスト起動この2つが分かりやすいです。モジュール開発における PHP_MINIT_FUNCTION() と PHP_RINIT_FUNCTION() にそれぞれ対応します

以上がPHPモジュール開発に関する知識の紹介の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。