三種「打開」場景區分
| 場景 | 操作 | 工具/環境 | 結果 |
| 查看/編輯源碼 | 文本編輯器打開 | VS Code、PhpStorm、Sublime、Notepad++、Vim | 顯示 PHP 代碼,可修改 |
| 本地運行測試 | 啟動 PHP 服務器訪問 | PHP 內建服務器、XAMPP、Laragon、Docker | 瀏覽器顯示執行後的 HTML/JSON |
| 線上部署訪問 | 配置 Web 服務器指向入口 | Nginx/Apache + PHP-FPM、雲函數、Serverless | 公開網址可訪問 |
場景一:編輯源碼 (推薦工具)
- VS Code (免費、跨平台、PHP Intelephense 智能提示、Xdebug 調試) ⭐ 首選
- PhpStorm (付費、專業級重構、框架深度整合、資料庫工具)
- Sublime Text / Notepad++ (輕量、啟動快、適合輕量編輯)
- Vim/Neovim (終端原生、鍵盤流、配合 LSP)
關鍵配置:設置編碼為 UTF-8 無 BOM,換行符 LF,縮進 4 空格。
場景二:本地運行 (三種零配置方案)
方案 A:PHP 內建服務器 (零安裝、臨時測試)
# 1. 確保已安裝 PHP (php -v)
# 2. 進入項目根目錄 (包含 index.php)
cd /path/to/project
# 3. 啟動
php -S localhost:8000 -t public
# -S 監聽地址:端口
# -t 文檔根目錄 (若 index.php 在 public/ 下)
# 4. 瀏覽器訪問
# https://localhost:8000
⚠️ 僅適用開發測試,單線程、無並發、無 .htaccess 支援。
方案 B:整合包 (Windows/Mac 新手友好)
| 工具 | 平台 | 特點 | 文檔根目錄 |
| XAMPP | Win/Mac/Linux | Apache+MySQL+PHP+Perl、圖形控制面板 | htdocs/ |
| Laragon | Windows | 輕量、自動虛擬主機、Ngrok 內網穿透、現代版本 | www/ |
| PHPStudy (小皮) | Win/Mac | 中文、多版本切換、站點管理視覺化 | www/ |
| MAMP | Mac/Win | Mac 原生體驗、免費版足夠 | htdocs/ |
操作:安裝 → 啟動 Apache/Nginx + MySQL → 將項目放入文檔根目錄 → 瀏覽器訪問 https://localhost/ 或配置虛擬主機 https://myproject.test。
方案 C:Docker 容器化 (生產一致性、團隊統一)
# docker-compose.yml
version: '3.8'
services:
php:
image: php:8.2-apache
ports:
- "8080:80"
volumes:
- ./:/var/www/html
# 可選:安裝擴展
# command: bash -c "docker-php-ext-install pdo_mysql && apache2-foreground"
# 啟動
docker-compose up -d
# 訪問 https://localhost:8080
場景三:生產部署架構
用戶 → [CDN/WAF] → Nginx (靜態資源、反向代理、SSL 終止)
↓ proxy_pass
PHP-FPM Pool (多 Worker 進程)
↓ Unix Socket / TCP
PHP 腳本執行 (index.php 入口)
↓
MySQL/Redis/Queue/Storage
Nginx + PHP-FPM 核心配置
# /etc/nginx/sites-available/myapp
server {
listen 80;
server_name myapp.com www.myapp.com;
root /var/www/myapp/public; # 指向 public/ 目錄
index index.php index.html;
location / {
try_files $uri $uri/ /index.php?$query_string; # 前端控制器模式
}
location ~ \.php$ {
fastcgi_pass unix:/run/php/php8.2-fpm.sock; # 或 127.0.0.1:9000
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
include fastcgi_params;
fastcgi_intercept_errors on;
}
# 安全:隱藏版本、禁止訪問敏感文件
location ~ /\.(env|git|htaccess) { deny all; }
location ~ /storage/ { deny all; }
}
常見問題排查
- 瀏覽器顯示源碼 / 下載 .php 文件
- Web 服務器未配置 PHP 處理器 → 檢查 Nginx
fastcgi_pass、Apache SetHandler/AddType、PHP-FPM 是否運行
- 500 Internal Server Error
- 查看錯誤日誌:
tail -f /var/log/nginx/error.log、/var/log/php8.2-fpm.log、storage/logs/laravel.log
- 404 Not Found (除首頁外)
- 路由重寫未生效 → Nginx
try_files、Apache mod_rewrite、.htaccess
- 權限錯誤 (Permission denied)
chown -R www-data:www-data /var/www/myapp、chmod -R 755 storage bootstrap/cache (Laravel)
- 白屏無輸出
- 致命錯誤但
display_errors=Off → 臨時開啟或查日誌
最佳實踐清單
- ✅ 入口文件統一為
public/index.php,核心代碼置於 public 外層
- ✅ 使用 Composer 自動加載,
composer dump-autoload -o 生產優化
- ✅ 環境配置用
.env,.env.example 納入版控,.env 加入 .gitignore
- ✅ 啟用 OPcache、JIT (PHP 8+)、預加載
- ✅ 靜態資源走 CDN、Nginx 直接服務、啟用 Gzip/Brotli
- ✅ 監控:Prometheus + Grafana (PHP-FPM Exporter)、Sentry 錯誤追蹤
copyright ©
萬盛學電腦網 all rights reserved