解決 PHP Fatal error: Undefined class constant 'MYSQL_ATTR_USE_BUFFERED_QUERY' 錯誤

解決 PHP Fatal error: Undefined class constant 'MYSQL_ATTR_USE_BUFFERED_QUERY' 錯誤

當你在 PHP 專案中遇到 Fatal error: Undefined class constant 'MYSQL_ATTR_USE_BUFFERED_QUERY' 這類錯誤時，通常是因為 PDO MySQL 擴展未正確啟用所導致。這個常數屬於 PDO 的 MySQL 驅動專用屬性，若擴展模組未載入，PHP 自然無法識別該常數，進而拋出致命錯誤。

快速排查與修復步驟

1. 開啟 php.ini 設定檔：找到你目前 PHP 環境使用的 php.ini 檔案位置（可透過 php --ini 或 phpinfo() 確認）。
2. 啟用 pdo_mysql 擴展：在檔案中搜尋 extension=pdo_mysql 或 extension=php_pdo_mysql.dll（Windows 環境）。若該行前方有分號 ; 表示被註解停用，請移除分號。
3. 重啟 Web 伺服器：修改完成後儲存檔案，並重新啟動 Apache、Nginx 或 PHP-FPM 服務，使設定生效。
4. 驗證修復結果：重新造訪原本報錯的頁面，或執行 php -m | grep pdo_mysql 確認模組已正常載入。

補充說明

• 若使用 Linux 套件管理器安裝 PHP，可能需額外安裝 php-pdo_mysql 或 php7.x-pdo-mysql 套件。
• Windows 使用者請確認 ext 目錄下確實存在 php_pdo_mysql.dll 檔案。
• 若問題持續，請檢查是否有多個 PHP 版本共存導致載入錯誤的 php.ini。

完成上述步驟後，錯誤通常即可解決，專案可恢復正常運行。