在 Windows 上安裝 PHP 擴(kuò)展

在 Windows 上有兩種加載 PHP 擴(kuò)展的方式：把擴(kuò)展編譯進(jìn) PHP，或者加載 DLL。加載預(yù)編譯的擴(kuò)展是更簡單更被推薦的方式。

要加載某擴(kuò)展，需要在系統(tǒng)中有其相對應(yīng)的 “.dll” 文件。所有擴(kuò)展都會由 PHP 小組定期自動編譯（如何下載見下節(jié)）。

要將一擴(kuò)展編譯入 PHP，請參考從源程序編譯一章。

要編譯一個(gè)獨(dú)立的擴(kuò)展（即 DLL 文件），請參考從源程序編譯一章。如果在 PHP 發(fā)行包和 PCEL 中都沒有某 DLL 文件，那可能需要自己編譯之后才能使用該擴(kuò)展。

去哪里找擴(kuò)展庫？

PHP 擴(kuò)展庫通常稱為“php_*.dll”（其中星號代表具體某擴(kuò)展的名字），位于“PHP\ext”目錄下。

PHP 發(fā)行包中包括了大多數(shù)開發(fā)者最常用到的擴(kuò)展庫。這些被稱為“核心”擴(kuò)展庫。

不過呢，如果用戶所需要的功能并沒有被任何核心擴(kuò)展提供，那還是有可能在 ? PECL 中找到。PHP Extension Community Library（PECL，PHP 擴(kuò)展社區(qū)庫）是個(gè) PHP 擴(kuò)展的儲存室，提供了對于所有已知擴(kuò)展的下載及開發(fā)途徑的指南。

如果用戶開發(fā)了一個(gè)自己使用的擴(kuò)展，可以考慮將其發(fā)布到 PECL 中以便于其他有相同需求的用戶使用。一個(gè)很好的副作用是可以得到其他用戶的反饋，感謝，錯(cuò)誤報(bào)告甚至修正／更新。不過在向 PECL 發(fā)布擴(kuò)展之前，請先閱讀 ? PECL 提交指南。

下載哪個(gè)擴(kuò)展？

用戶常常會發(fā)現(xiàn)每個(gè) DLL 都有好幾個(gè)版本：

不同的版本號（至少前兩個(gè)數(shù)字要一致）
不同的線程安全性設(shè)定
不同的處理器體系（x86，x64，...)
不同的排錯(cuò)設(shè)定
其它

請記住用戶的擴(kuò)展設(shè)定應(yīng)該與所使用的 PHP 可執(zhí)行文件的設(shè)定都保持一致。以下腳本可以顯示所有 PHP 設(shè)定：

示例 #1 phpinfo() call


<?php
phpinfo();
?>

或者在命令行運(yùn)行：

drive:\\path\to\php\executable\php.exe -i

載入一個(gè)擴(kuò)展

最常見的方式是在 php.ini 配置文件里包含一個(gè) PHP 擴(kuò)展。請注意很多擴(kuò)展已經(jīng)在 php.ini 里了，僅需要移除分號來激活它們。

需要注意，從 PHP 7.2.0 開始，可以直接用擴(kuò)展的名稱，來替代擴(kuò)展的文件名。這樣配置文件就跟操作系統(tǒng)解耦了，也更容易理解。我們推薦采用此方式加載擴(kuò)展。為了與之前的版本保持兼容，直接寫擴(kuò)展名的方式會仍然支持。

;extension=php_extname.dll

extension=php_extname.dll

; PHP version 7.2 開始的推薦寫法：
extension=extname
zend_extension=another_extension

不過呢，有些 web 服務(wù)器會搞混，因?yàn)槠洳⒉灰欢ㄊ褂煤?PHP 可執(zhí)行文件處于同一目錄下的 php.ini 文件。要搞清楚具體使用了哪一個(gè) php.ini 文件，在 phpinfo() 的輸出中查看：

Configuration File (php.ini) Path  C:\WINDOWS

Loaded Configuration File   C:\Program Files\PHP\5.2\php.ini

激活一個(gè)擴(kuò)展后，保存 php.ini 文件并重啟動 web 服務(wù)器，然后用 phpinfo() 再次查看確定。新的擴(kuò)展應(yīng)該有其自己的一節(jié)。

解決問題

如果某擴(kuò)展并未在 phpinfo() 中顯示，應(yīng)該查看日志以確定問題出在哪里。

如果是在命令行使用 PHP（CLI），擴(kuò)展加載出錯(cuò)信息會直接在屏幕顯示。

如果在 web 服務(wù)器中使用 PHP，則日志文件的位置與格式各不相同。請閱讀所使用的 web 服務(wù)器之文檔以確定日志文件的位置，這與 PHP 本身并無關(guān)系。

最常見的問題是 DLL 和 DLL 依賴的文件的位置，php.ini 中“extension_dir”設(shè)定的值，以及編譯時(shí)的設(shè)置不匹配。

如果問題出在編譯時(shí)設(shè)置不匹配，那可能所下載的 DLL 文件不對。可以嘗試重新下載一個(gè)設(shè)置匹配的擴(kuò)展。此外，phpinfo() 可以起到很大幫助。