在部署 PHP 系統時，我常會先提醒自己先把「基礎環境」搞清楚，畢竟一個小疏忽就可能讓整個安裝流程卡住，甚至導致日後維護困難。舉例來說，去年我在一個中小企業的專案裡，因為伺服器的 memory_limit 只設定為 64M，結果在安裝大型框架時直接崩潰，讓客戶差點失去信心。
安裝前的環境檢查
首先，確認 PHP 版本至少為 7.4，因為許多現代套件已拋棄 7.0 以下的支援。你可以在終端機輸入 php -v 直接看到版本資訊。接著，檢查必備的擴充套件——pdo_mysql、mbstring、openssl 以及 curl，缺一不可。若是使用 Composer，請務必確保 allow_url_fopen 已啟用，否則套件下載會失敗。
常見錯誤與排除方式
安裝過程中最常見的錯誤是「權限不足」與「路徑錯誤」。舉個例子，將系統放在 /var/www/html/ 時，如果 storage 或 cache 目錄沒有給予 775（或 777）寫入權限，系統會直接拋出「無法寫入檔案」的例外。解法其實很簡單：chmod -R 775 storage cache，再檢查 nginx 或 apache 的 user 是否與檔案擁有者相同。
另一個坑是「URL 重寫」沒有正確設定。若你的 .htaccess 或 nginx.conf 缺少 RewriteEngine On 或相對應的 try_files 規則，安裝程式會顯示 404 錯誤，讓人誤以為檔案遺失。記得在 Apache 中加入：
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]
在 Nginx 則需要：
location / {
try_files $uri $uri/ /index.php?$query_string;
}
最佳實踐與安全建議
說到安全，別忘了在 php.ini 中關閉 display_errors，避免把錯誤訊息直接暴露給外部。再者，設定 session.cookie_httponly = true 與 session.cookie_secure = true，可以減少 XSS 與 Session 劫持的風險。最後，我個人喜歡在安裝完畢後，立即刪除 install.php 或將其重新命名，這樣即使有人誤點到，也不會再觸發安裝流程。
總結來說，只要在安裝前做好版本、擴充套件與權限的檢查，安裝過程中留意錯誤訊息並快速對照官方文件，最後加上幾項基本的安全設定，PHP 系統的部署就能既順利又安心。希望這些小技巧能幫助到正在閱讀的你，讓你的專案少走彎路。
評論（5）
memory_limit 64M 真的會炸，上次我也卡在這 😭
pdo_mysql 沒開結果折騰一整天，誰懂啊
nginx 那段 try_files 寫錯了是不是？我照抄還是 404🤔
chmod 777 太危險了吧，開發完記得改回來啊
storage 權限問題害我重裝三次，血淚教訓