# 19.1 嵌入式SAPI # 嵌入式SAPI 回顧介紹中, php構建了一個層級系統. 最高層是提供用戶空間函數和類庫的所有擴 展. 同時, 其下是服務API(SAPI)層, 它扮演了webserver(比如apache, iis以及命令行接口 cli)的接口. 在這許多sapi實現中有一個特殊的sapi就是嵌入式sapi. 當這個sapi實現被構建時, 將 會創建一個包含所有你已知的php和zend api函數以及變量的庫對象, 這個庫對象還包含一些額外的幫助函數和宏, 用以簡化外部程序的調用. 生成嵌入式api的庫和頭文件和其他sapi的編譯所執行的動作相同. 只需要傳遞--enable-embed到./configure命令中即可. 和以前?樣, 使用--enable-debug對于錯誤報告和 跟蹤很有幫助. 你可能還需要打開--enable-maintainer-zts, 當然, 理由你已經耳熟能詳了, 它將幫助 你注意到代碼的錯誤, 不過, 這里還有其他原因. 假設某個時刻, 你有多個應用使用php嵌入 庫執行腳本任務; 其中一個應用是簡單的短生命周期的, 它并沒有使用線程, 因此為了效率 你可能想要關閉ZTS. 現在假設第二個應用使用了線程, 比如webserver, 每個線程需要跟蹤自己的請求上下 文. 如果ZTS被關閉, 則只有第?個應用可以使用這個庫; 然而, 如果打開ZTS, 則兩個應用 都可以在自己的進程空間使用同?個共享對象. 當然, 你也可以同時構建兩個版本, 并給它們不同的名字, 但是這相比于在不需要ZTS 時包括ZTS帶來的很小的效率影響更多的問題. 默認情況下, 嵌入式庫將構建為libphp5.so共享對象, 或者在windows下的動態鏈接庫, 不過, 它也可能使用可選的static關鍵字(--enable-embed=static)被構建為靜態庫. 構建為靜態庫的版本避免了ZTS/非ZTS的問題, 以及潛在的可能在一個系統中有多個 php版本的情況. 風險在于這就意味著你的結果應用二進制將顯著變大, 它將承載整個 ZendEngine和PHP框架, 因此, 選擇的時候就需要慎重的考慮你是否需要的是?個相對更小的庫. 無論你選擇那種構建方式,一旦你執行make install, libphp5都將被拷貝到你的./ configure指定的PREFIX目錄下的lib/目錄中. 此外還會在PREFIX/include/php/sapi/ embed目錄下放入名為php\_embed.h的頭文件, 以及你在使用php嵌入式庫編譯程序時需 要的其他幾個重要的頭文件. ## links - [目錄](preface.md) - 19 [設置宿主環境](19.html) - 19.2 [構建并編譯?個宿主應用](19.2.html)