用戶遇到兩類錯誤:
php_phalcon.dll 載入失敗 — 版本不匹配 (PHP 版本、TS/NTS、VC 編譯版本、位數任一不符)。php5.dll — 概念錯誤,php5.dll 並不存在 (PHP 5.x 核心為 php5ts.dll),且不應手動載入核心 DLL。| 維度 | 檢查命令 | 範例值 |
|---|---|---|
| PHP 版本 | php -v | 5.4.20 |
| Thread Safety | php -i | findstr "Thread Safety" | enabled → TS / disabled → NTS |
| Compiler (VC) | php -i | findstr "Compiler" | MSVC11 (VC11) / MSVC14 (VC14) / MSVC15 (VC15) |
| Architecture | php -i | findstr "Architecture" | x86 (32bit) / x64 (64bit) |
下載 Phalcon DLL 時必須精確匹配以上四項。官方 下載頁 按此分類提供。
php -i > phpinfo.txt 搜尋上述四項。phalcon-php5.4-ts-vc11-x86.zip。php_phalcon.dll 放入 PHP ext 目錄 (如 D:\wamp\bin\php\php5.4.20\ext\)。Dynamic Extensions 區域添加:
extension=php_phalcon.dll
確保在 extension=php_pdo_mysql.dll 等依賴擴展 之後 載入 (Phalcon 依賴 PDO)。
<?php
print_r(get_extension_funcs('phalcon'));
// 或
php -m | findstr phalcon| 現象 | 原因 | 解決 |
|---|---|---|
Apache 啟動閃退 / 事件檢視器報 php_phalcon.dll 缺少依賴 | 缺少 VC++ Redistributable | 安裝對應版本 VC++ Redist (VC11 → VC11 x86 / VC11 x64) |
php -m 顯示 phalcon 但 get_extension_funcs 為空 | CLI 與 Apache 載入不同 php.ini | 用 php --ini 確認 CLI 配置,分別修改兩份 ini |
報錯 Phalcon\Exception: Service 'db' was not found | DI 容器未註冊 db 服務 | 檢查 config/services.php 註冊 $di->setShared('db', ...) |