20.1 回調到php中 · phpbook-PHP擴展開發及內核應用

# 20.1 回調到php中 # 回調到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); ``` 實際上從引擎外部調用時, function\_table總是EG(function\_table). 如果調用?個對象或類方法, object\_pp需要是IS\_OBJECT類型的調用實例zval, 或者對于類的靜態調用則是 IS\_STRING的值. function\_name通常是IS\_STRING的值, 包含要調用的函數名, 但是它也可以是IS\_ARRAY, 第0個元素包含一個對象或類名, 第1個元素包含方法名. 這個函數調用的結果是向傳入的retval\_ptr指向的zval設置返回值. param\_count和 params扮演了argc/argv的角色. 也就是說, params\[0\]包含所傳遞的第一個參數, params\[param\_count - 1\]包含了所傳遞的最后一個參數. 下面是用這種方法重新實現上面的例子: ``` 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() ?int call_user_function(HashTable *function_table, zval **object_pp, zval *function_name, zval *retval_ptr, zend_uint param_count, zval *params[] TSRMLS_DC); PHP_EMBED_START_BLOCK(argc, argv) zval *args[1]; zval retval, str, funcname; ZVAL_STRING(&funcname, "nl2br", 0); args[0] = &str; ZVAL_STRINGL(args[0], "HELLO WORLD!", sizeof("HELLO WORLD!"), 1); call_user_function(EG(function_table), NULL, &funcname, &retval, 1, args TSRMLS_CC); printf("out: %s\n", Z_STRVAL(retval)); zval_dtor(args[0]); zval_dtor(&retval); PHP_EMBED_END_BLOCK() ``` 盡管代碼看起來比較長, 但是工作量會顯著降低, 因為這里沒有要編譯的中間代碼, 傳遞的數據不需要復制, 每個參數都已經在Zend兼容的結構體中. 同時, 要記得原來的例子中在字符串中包含單引號時會有潛在的錯誤. 而這個版本沒有這個問題. ## links - [目錄](preface.md) - 20 [高級嵌入式](20.html) - 20.2 [錯誤處理](20.2.html)