PHP錯誤 "Call to undefined function php()" 成因與解決

PHP 致命錯誤：Call to undefined function php() 徹底解析

這是一個典型的「調用未定義函數」錯誤。錯誤字面意為：代碼中嘗試調用名為 php() 的函數，但當前作用域（全局/命名空間）未找到該函數定義。

常見觸發場景

1. 誤將標簽寫成函數調用：

   <?php
           // ❌ 錯誤：以為 php() 是輸出函數
           php("Hello World"); 
           
           // ✅ 正確：使用 echo/print 或短標簽
           echo "Hello World";
           // 或  (需開啟 short_open_tag)
           ?>
           

2. 拼寫錯誤/大小寫不匹配：

   <?php
           // 定義了 function PhpInfo() 但調用 phpinfo()
           // PHP 函數名**不區分大小寫**，但用戶自定義函數**區分大小寫** (PHP 7+ 類方法不區分)
           function myFunc() {}
           MyFunc(); // ✅ 內置函數不區分，用戶函數區分
           ?>
           

3. 擴展未加載/版本不兼容：

   <?php
           // 調用了某擴展函數，如 imagecreatetruecolor() 但未啟用 php-gd
           // 或調用了 PHP 8 新函數 (str_contains) 在 PHP 7 環境
           ?>
           

4. 命名空間問題：

   <?php
           namespace App\Utils;
           function php() {} // 定義在命名空間下
           
           // 其他文件調用
           php(); // ❌ 在全局命名空間找不到
           \App\Utils\php(); // ✅ 完全限定名
           use function App\Utils\php; php(); // ✅ 導入
           ?>
           

快速排查步驟

1. 查看錯誤日誌定位**文件名與行號**。
2. 檢查該行是否寫了 php(...) 或類似拼寫。
3. 搜索項目中是否定義了 function php()。
4. 若是第三方庫函數，確認 `composer install` 完成、擴展已啟用 (`php -m | grep ext`)、PHP 版本滿足要求。
5. 臨時在該行前加 var_dump(function_exists('php')); 驗證。

預防最佳實踐

• IDE (PhpStorm/VS Code + PHP Intelephense) 實時提示「Undefined function」。
• 靜態分析工具：phpstan analyse src、psalm 可掃描出所有未定義調用。
• 遵循 PSR-12 編碼規範，函數名用 camelCase，避免與關鍵字衝突。
• 入口文件註冊自動加載器，確保類/函數可被正確解析。

總結

「Call to undefined function php()」99% 是誤把 <?php 標簽或輸出語句寫成了函數調用。檢查代碼將 php(...) 替換為 echo ... 或 print ... 即可解決。若非此情況，按上述步驟排查擴展、命名空間、拼寫問題。