附錄 F. 配置選項
- 目錄
- 核心配置選項清單
核心配置選項清單
下面是 PHP 的 configure 腳本使用的部分選項的清單，用於類 Unix 環境的編譯。大部配置置選項在增加模組參考頁面適當的位置列出，而不是在這裡。要檢視所有可用配置選項的清單，在運行 autoconf 指令後在 PHP 的原始碼目錄運行 ./configure --help（參見安裝與配置一章）。也可以閱讀 GNU configure 文件以獲得有關 configure 指令的更詳細訊息，例如 --prefix=PREFIX。
注: 這些選項只用在編譯的時候。若果想要修改 PHP 的運行時配置，請閱讀運行時配置。
在 PHP 4 中的配置選項
注: 這些選項僅適用於 PHP 4.1.0 以上版本。儘管某些選項可以用在較舊版本的 PHP 4，甚至 PHP 3，若果想編譯舊版本的 PHP，請注意有些選項不可用。
雜項選項
- --enable-debug
編譯時加入除錯符號。
- --with-layout=TYPE
設定被安裝檔案的佈局。TYPE 是 PHP（預設）或 GNU。
- --with-pear=DIR
在 DIR（預設為 PREFIX/lib/php）中安裝 PEAR。
- --without-pear
不安裝 PEAR。
- --enable-sigchild
使用 PHP 自帶的 SIGCHLD 處理器。
- --disable-rpath
禁用在搜尋路徑中傳遞其他運行庫。
- --enable-libgcc
啟用 libgcc 的精確連結。
- --enable-php-streams
包括試驗性的 PHP 流。不要使用此選項，除非是要測試代碼！
- --with-zlib-dir[=DIR]
定義 zlib 的安裝目錄。
- --enable-trans-sid
啟用透明 session id 傳輸。僅適用於 PHP 4.1.2 或更低版本。PHP 4.2.0 以後，透明 sid 功能預設被編譯其中。
- --with-tsrm-pthreads
使用 POSIX 執行緒（預設）。
- --enable-shared[=PKGS]
編譯共享庫 [default=yes]。
- --enable-static[=PKGS]
編譯靜態庫 [default=yes]。
- --enable-fast-install[=PKGS]
為快速安裝改善 [default=yes]。
- --with-gnu-ld
假設 C 編譯器使用 GNU ld [default=no]。
- --disable-libtool-lock
避免鎖死（可能破壞並聯的編譯）。
- --with-pic
嘗試僅使用 PIC/非 PIC 物件 [default=use both]。
- --enable-memory-limit
編譯記憶體限制支援功能。
- --disable-url-fopen-wrapper
禁用 URL 形式的 fopen 封裝協定。該協定容許通過 HTTP 或是 FTP 訪問檔案。
- --enable-versioning
僅匯出必須的符號。檢視 INSTALL 檔案以獲得更多訊息。
- --with-imsp[=DIR]
包括 IMSP 支援（DIR 是 IMSP 的 include 目錄和 libimsp.a 所在目錄）。此選項僅在 PHP 3 中有效！
- --with-mck[=DIR]
包括 Cybercash MCK 支援。DIR 是 cybercash mck 的編譯目錄，預設為 /usr/src/mck-3.2.0.3-linux。更多說明情檢視 extra/cyberlib 內的檔案。此選項僅在 PHP 3 中有效！
- --with-mod-dav=DIR
通過 Apache 的 mod_dav 實現對 DAV 的支援。DIR 是 mod_dav 的安裝目錄 (僅對以 Apache 模組模式安裝的 PHP 有效)。此選項僅在 PHP 3 中有效！
- --enable-debugger
編譯遠端除錯功能。此選項僅在 PHP 3 中有效！
- --enable-versioning
利用 Solaris 2.x 和 Linux 提供的版本管理（versioning）和範圍（scoping）。此選項僅在 PHP 3 中有效！
SAPI 選項
下面的清單包括 PHP 可用的SAPI（伺服器套用寫程式介面）。
- --with-aolserver=DIR
指定 AOLserver 的安裝路徑。
- --with-apxs[=FILE]
編譯共享的 Apache 模組。FILE 是可選的 Apache apxs 工具的路徑，預設指向 apxs。請確認特殊的 apxs 已經安裝在伺服器中，並且它不是 Apache 源程式碼包中的那個 apxs。
- --with-apache[=DIR]
編譯靜態 Apache 模組。DIR 是 Apache 編譯目錄的頂層，預設為 /usr/local/apache。
- --with-mod_charset
啟用 mod_charset 的轉換表（俄文的 Apache 使用）。
- --with-apxs2[=FILE]
編譯共享的 Apache 2.0 模組。FILE 是可選的 Apache apxs 工具的路徑，預設指向 apxs。
- --with-caudium=DIR
為使用 Caudium 編譯 PHP 為一個 Pike 模組。DIR 是 Caudium 伺服器目錄，預設為 /usr/local/caudium/server。
- --disable-cli
PHP 4.3.0 之後的版本有效。禁止編譯 PHP 的 CLI 版本（使用它將同時強制使用 --without-pear 選項）。更多訊息請查考 PHP 的指令行模式。
- --enable-embed[=TYPE]
啟用編譯內嵌的 SAPI 庫。TYPE 或是為 shared 或是為 static，預設為 shared。PHP 4.3.0 之後的版本有效。
- --with-fhttpd[=DIR]
編譯 fhttpd 模組。DIR 是 fhttpd 原始碼目錄，預設為 /usr/local/src/fhttpd。PHP 4.3.0 及以後的版本此選項不再有效。
- --with-isapi=DIR
為 Zeus 伺服器以 ISAPI 模組模式編譯 PHP。
- --with-nsapi=DIR
指定 Netscape/iPlanet/SunONE 的安裝目錄。
- --with-phttpd=DIR
還沒有訊息。
- --with-pi3web=DIR
為 Pi3Web 伺服器編譯 PHP 模組。
- --with-roxen=DIR
以 Pike 模組模式編譯 PHP。DIR 是 Roxen 的根目錄，預設為 /usr/local/roxen/server。
- --enable-roxen-zts
使用 Zend 執行緒安全（ZTS）編譯 Roxen 模組。
- --with-servlet[=DIR]
包括 servlet 支援。DIR 是 JSDK 的安裝目錄。此 SAPI 要求 java 增加必須作為共享模組編譯到 PHP 中。
- --with-thttpd=SRCDIR
編譯 PHP 為 thttpd 模組。
- --with-tux=MODULEDIR
編譯 PHP 為 TUX 模組（僅在 Linux 下有效）。
- --with-webjames=SRCDIR
編譯 PHP 為 WebJames 模組（僅在 RISC 動作系統中有效）。
- --disable-cgi
禁止編譯 CGI 版本的 PHP。PHP 4.3.0 之後的版本有效。
- --enable-force-cgi-redirect
啟用內定伺服器重定向的安全檢驗。若果在 Apache 下使用 CGI 版本的 PHP，請啟用該選項。
- --enable-discard-path
若果啟用該選項，PHP CGI 目錄可以安全的放在 web 目錄樹的外面，人們無法避開 .htaccess 的安全限制。
- --with-fastcgi
編譯 PHP 為 FastCGI 套用程式。PHP 4.3.0 及以後的版本此選項不再有效，應該使用 --enable-fastcgi 選項。
- --enable-fastcgi
若果啟用，CGI 模組將被編譯為支援 FastCGI。PHP 4.3.0 之後的版本有效。
- --disable-path-info-check
若果該選項被禁用，例如 /info.php/test?a=b 形式的路徑將不能工作。PHP 4.3.0 之後的版本有效。更多訊息請參考 Apache 手冊。