php的高級嵌入式

高級嵌入式

php的嵌入式能夠提供的可不僅僅是同步的加載和執行腳本. 通過理解php的執行模塊各個部分是怎樣組合的, 甚至給出一個腳本還可以回調到你的宿主應用中. 本章將涉及SAPI層提供的I/O鉤子帶來的好處, 展開你已經從前面的主題中獲取到信息的執行模塊進行學習.

回調到php中

除了加載外部的腳本, 和你在上一章看到的類似, 你的php嵌入式應用, 下面將實現一個類似於用戶空間eval()的命令.

int zend_eval_string(char *str, zval *retval_ptr,  
                     char *string_name TSRMLS_DC)

這裡, str是實際要執行的php腳本代碼, 而string_name是一個與執行關聯的任意描述信息. 如果發生錯誤, php會將這個描述信息作為錯誤輸出中的"文件名". retval_ptr, 你應該已經猜到了, 它將被設置為所傳遞代碼產生的返回值. 試試用下面的代碼創建新的項目吧.

#include <sapi/embed/php_embed.h>  
      
int main(int argc, char *argv[]) {  
    PHP_EMBED_START_BLOCK(argc, argv)  
        zend_eval_string("echo 'Hello World!';", NULL, "Simple Hello World App" TSRMLS_CC);  
    PHP_EMBED_END_BLOCK()  
          
    return 0;  
}

現在使用命令或第19章"設置宿主環境"構建它(將Makefile中或命令中的embed1替換為embed2)

備選方案: 腳本文件的包含

可以預見的是, 這使得編譯和執行外部腳本文件遠比之前的方法更加容易, 因為你的應用可以將原本復雜的打開/准備/執行的執行序列, 以這種簡化但功能更加強大的設計替代:

#include <sapi/embed/php_embed.h>  
      
int main(int argc, char *argv[]) {  
    char    *filename;  
          
    if ( argc <= 1 ) {  
        fprintf(stderr, "Usage: %s <filename.php> <arguments>\n", argv[1]);  
        return -1;  
    }  
          
    filename    = argv[1];  
          
    /* 忽略第0個參數 */
    argc --;  
    argv ++;  
          
    PHP_EMBED_START_BLOCK(argc, argv)  
        char    *include_script;  
              
        spprintf(&include_script, 0, "include '%s';", filename);  
        zend_eval_string(include_script, NULL, filename TSRMLS_CC);  
        efree(include_script);  
    PHP_EMBED_END_BLOCK()  
          
    return 0;  
}

注意: 這種特殊的方法必須接受一個缺點, 如果文件名包含單引號, 將導致解析錯誤. 不過這可以通過使用ext/standard/php_string.h中的php_addslashes()API調用解決. 花一些時間去閱讀這個文件以及附錄中的API參考, 你會發現很多的特性, 它們可以讓你避免在以後重造輪子.

調用用戶空間函數

如你看到的加載和執行腳本文件, 在內部有兩種方式調用用戶空間函數. 現在最明顯的可能是重用zend_eval_string(), 將函數名和所有它的參數組織到一個龐大的字符串中, 然後收集返回值.

PHP_EMBED_START_BLOCK(argc, argv)  
    char    *command;  
    zval    retval;  
      
    spprintf(&command, 0, "nl2br('%s');", argv[1]);  
    zend_eval_string(command, &retval, "nl2br() execution" TSRMLS_CC);  
    efree(command);  
    printf("out: %s\n", Z_STRVAL(retval));  
    zval_dtor(&retval);  
PHP_EMBED_END_BLOCK()

和前面的include很像, 這個方法有一個致命的缺陷: 如果輸入參數paramin(譯者給出的例子中是argv[1])給出一個錯誤的數據, 函數將會失敗, 或者更糟糕的是導致無法預期的結果. 解決方案是永遠都避免編譯代碼的運行時片段, 並直接使用call_user_function()API調用函數.

int call_user_function(HashTable *function_table, zval **object_pp,  
                       zval *function_name, zval *retval_ptr,  
                       zend_uint param_count, zval *params[] TSRMLS_DC);