Windows 下 PHP 安裝 Phalcon 擴展完整指南：版本匹配與驗證關鍵步驟

Phalcon 作為 C 擴展框架，安裝核心在於 DLL 版本與 PHP 版本、架構、線程安全性完全匹配。本文梳理安裝全流程與常見報錯對策。

核心匹配四要素

安裝步驟

1. 從 GitHub Releases 或 官網 下載對應版本的 php_phalcon.dll。
2. 放入 PHP ext 目錄（如 C:\php\ext）。
3. 編輯 php.ini，添加 extension=phalcon（無需 php_ 前綴）。
4. 重啟 Web 服務（Apache/Nginx/PHP-FPM）。

驗證安裝

<?php
print_r(preg_grep('/^Phalcon/', get_declared_classes()));
?>

若輸出包含 Phalcon\Di, Phalcon\Mvc\Application 等類，即安裝成功。

常見報錯對策

• PHP Startup: Unable to load dynamic library 'phalcon' → 版本/架構/TS-NTS 不匹配，重新核對四要素下載正確 DLL。
• php5.dll not found → 嘗試下載 VC 運行時庫 (VC15 x64) 而非手動找 dll。
• WAMP/XAMPP 環境 → 注意修改對應的 php.ini（可能有多個），用 php --ini 確認加載的配置文件。

現代替代方案

PHP 8.0+ 建議使用 Zephir 編譯安裝 或 Docker 官方鏡像 phalconphp/php-fpm，規避 Windows DLL 地獄。

版本精準匹配是 Phalcon Windows 安裝的鐵律，驗證腳本是確認生效的金標準。