PHP 開發環境建置指南：Windows (WampServer) / Linux (LNMP) / macOS (Homebrew) 完整步驟

Windows：WampServer 一鍵安裝

1. 下載 WampServer（含 Apache, PHP, MySQL, MariaDB）。
2. 安裝預設路徑 `C:\wamp64`，啟動服務（系統匣圖示變綠）。
3. 專案放置於 `C:\wamp64\www\your-project`，瀏覽 `https://localhost/your-project`。
4. 切換 PHP 版本：左鍵圖示 → PHP → Version。
5. 啟用擴充：左鍵 → PHP → PHP extensions → 勾選 `php_openssl`, `php_curl`, `php_mbstring` 等。

編輯器推薦：VS Code / PhpStorm

• VS Code 安裝擴充：PHP Intelephense、PHP Debug、Error Lens、GitLens。
• 設定 `php.validate.executablePath` 指向 `C:\wamp64\bin\php\phpX.Y.Z\php.exe`。

Linux (CentOS/Ubuntu) 編譯安裝 LNMP

1. 安裝相依套件

# CentOS 7
yum -y install gcc gcc-c++ make autoconf libtool \
    libxml2-devel openssl-devel bzip2-devel libcurl-devel \
    libjpeg-devel libpng-devel freetype-devel \
    libicu-devel libzip-devel oniguruma-devel \
    mariadb-devel sqlite-devel

2. 編譯 PHP 8.2

cd /usr/local/src
wget https://www.php.net/distributions/php-8.2.20.tar.gz
tar xzf php-8.2.20.tar.gz
cd php-8.2.20
./configure --prefix=/usr/local/php \
    --enable-fpm --with-fpm-user=www --with-fpm-group=www \
    --with-openssl --with-zlib --with-bz2 --with-curl \
    --enable-mbstring --enable-intl --enable-opcache \
    --with-mysqli=mysqlnd --with-pdo-mysql=mysqlnd \
    --with-pdo-sqlite --with-sqlite3 \
    --with-zip --with-jpeg --with-freetype \
    --enable-gd --enable-bcmath --enable-sockets \
    --enable-pcntl --enable-exif --with-gettext
make -j$(nproc) && make install

3. 配置 php-fpm

cp php.ini-production /usr/local/php/lib/php.ini
cp /usr/local/php/etc/php-fpm.conf.default /usr/local/php/etc/php-fpm.conf
cp /usr/local/php/etc/php-fpm.d/www.conf.default /usr/local/php/etc/php-fpm.d/www.conf
# 編輯 www.conf：user/group = www, listen = 127.0.0.1:9000
mkdir -p /usr/local/php/var/log
useradd -r -s /sbin/nologin www

4. 安裝 Nginx

yum -y install nginx  # 或官方 repo 安裝最新版
# 編輯 /etc/nginx/conf.d/default.conf
server {
    listen 80;
    server_name localhost;
    root /var/www/html;
    index index.php index.html;
    location / { try_files $uri $uri/ /index.php?$query_string; }
    location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}
systemctl enable --now nginx php-fpm

5. 安裝 MariaDB/MySQL

yum -y install mariadb-server
systemctl enable --now mariadb
mysql_secure_installation
# 建立資料庫/使用者
mysql -u root -p -e "CREATE DATABASE myapp; CREATE USER 'app'@'%' IDENTIFIED BY 'secret'; GRANT ALL ON myapp.* TO 'app'@'%';"

macOS：Homebrew 輕鬆管理

brew update
brew install php@8.2 nginx mariadb
# 啟動服務
brew services start php@8.2 nginx mariadb
# PHP 設定檔：/opt/homebrew/etc/php/8.2/php.ini
# Nginx 設定：/opt/homebrew/etc/nginx/nginx.conf
# 專案目錄建議：~/Sites 或 /opt/homebrew/var/www

常用除錯技巧

• 查看 PHP 版本與模組：`php -v` / `php -m`
• 測試 php-fpm：`curl -I https://127.0.0.1:9000`（需啟用 status 頁面）
• Nginx 測試配置：`nginx -t`
• 查看錯誤日誌：`tail -f /var/log/nginx/error.log` / `tail -f /usr/local/php/var/log/php-fpm.log`
• Xdebug 設定（VS Code）：安裝 `xdebug` 擴充，`php.ini` 加入 `zend_extension=xdebug.so` 並設定 `xdebug.mode=debug,develop` `xdebug.client_port=9003`。