執行架構圖解
瀏覽器 HTTP 請求
↓
Web Server (Nginx/Apache)
↓ (FastCGI / mod_php)
PHP-FPM / PHP 模組 解析 .php 檔案
↓
Zend Engine 編譯為 Opcode → 執行
↓
輸出 HTML/JSON → 回傳給 Web Server → 瀏覽器渲染
三種常見執行模式
| 模式 | 適用場景 | 啟動指令範例 |
| Web Server + PHP-FPM (Nginx) | 生產環境、高併發 | systemctl start php8.3-fpm nginx |
| Apache + mod_php (Thread Safe) | 傳統虛擬主機、簡單部署 | systemctl start httpd |
| 內建開發伺服器 | 本地開發、快速測試 | php -S localhost:8000 -t public |
| CLI 命令列 | 排程任務、佇列消費者、腳本 | php artisan schedule:run |
最小驗證步驟
- 建立
public/index.php:
<?php
phpinfo();
- 終端機進入專案根目錄:
php -S localhost:8000 -t public
- 瀏覽器開啟
https://localhost:8000/index.php → 看到紫色 PHP 資訊頁即成功。
常見問題
- 顯示原始碼:Web Server 未正確轉發 .php 給 PHP 解析器(檢查 Nginx
fastcgi_pass、Apache SetHandler)。
- 500/502 錯誤:PHP-FPM 未啟動、Socket/Port 不通、權限不足、
php.ini 錯誤。
- 變更不生效:OPcache 快取、PHP-FPM 需重啟、瀏覽器快取。
生產環境部署檢查清單
- ✅
display_errors=Off、log_errors=On
- ✅ OPcache 啟用並調整
opcache.memory_consumption
- ✅ 僅開啟必要擴充套件
- ✅ 使用 Composer 自動載入、生產環境
composer install --no-dev --optimize-autoloader
- ✅ 靜態資源由 Nginx 直接服務、啟用 Gzip/Brotli