Nginx + PHP-FPM (FastCGI) 深度實戰：原理、安裝優化、緩存與故障排查

Nginx 不直接解析 PHP，需通過 FastCGI 協議將動態請求轉發給 PHP-FPM (FastCGI Process Manager)。本文系統講解 FastCGI 工作原理、PHP-FPM 編譯安裝優化、Nginx 配置最佳實踐、緩存策略、超時參數調優、502 錯誤根因分析與排查體系。

FastCGI 工作原理 (C/S 架構)

1. Nginx (HTTP Server) 接收請求，判斷為動態 PHP 請求 (匹配 location ~ \.php$)。
2. Nginx 通過 Unix Socket (/run/php/php8.2-fpm.sock) 或 TCP (127.0.0.1:9000) 封裝 FastCGI 協議數據包發送給 PHP-FPM Master 進程。
3. PHP-FPM Master 分配空閒 Worker 進程處理請求：解析腳本、執行業務邏輯、連接數據庫、生成響應。
4. Worker 將響應按 FastCGI 協議返回給 Nginx。
5. Nginx 將響應發送給客戶端瀏覽器。

關鍵優勢：進程持久化 (避免 CGI 每請求 fork)、職責分離 (Nginx 專注靜態/代理、PHP-FPM 專注業務)、可跨機器部署 (解耦擴展)。

PHP-FPM 編譯安裝優化參數 (PHP 8.2 示例)

./configure \
    --prefix=/usr/local/php \
    --with-config-file-path=/usr/local/php/etc \
    --with-config-file-scan-dir=/usr/local/php/etc/php.d \
    --enable-fpm \
    --with-fpm-user=www --with-fpm-group=www \
    --with-fpm-systemd \
    --enable-opcache \
    --enable-bcmath --enable-calendar --enable-exif \
    --enable-ftp --enable-gd --enable-intl --enable-mbstring \
    --enable-mysqlnd --enable-pcntl --enable-shmop --enable-soap \
    --enable-sockets --enable-sysvmsg --enable-sysvsem --enable-sysvshm \
    --enable-xml --enable-zip \
    --with-curl --with-openssl --with-zlib --with-zip \
    --with-jpeg --with-png --with-freetype --with-webp \
    --with-mhash --with-sodium --with-password-argon2 \
    --with-pear \
    --disable-short-tags \
    --disable-phpdbg \
    --disable-cgi
make -j$(nproc) && make install

關鍵點：--enable-fpm 內建 FPM；--with-fpm-systemd 支持 systemd 通知；--enable-opcache 開啟 opcode 緩存 (生產必開)；--disable-cgi 禁用舊版 CGI 接口。

PHP-FPM 核心配置優化 (www.conf)

[www]
user = www
group = www
listen = /run/php/php8.2-fpm.sock  # Unix Socket 性能優於 TCP
listen.owner = www
listen.group = www
listen.mode = 0660

pm = dynamic
pm.max_children = 100      # 最大進程數 = 總內存 / 單進程內存 (留 20% 系統)
pm.start_servers = 20
pm.min_spare_servers = 10
pm.max_spare_servers = 30
pm.max_requests = 1000     # 防止內存洩漏, 進程處理 1000 請求後重生
pm.status_path = /php_status
ping.path = /php_ping

request_terminate_timeout = 60s  # 請求硬超時, 防卡死
request_slowlog_timeout = 10s
slowlog = /var/log/php-fpm/www-slow.log

rlimit_files = 65535
rlimit_core = 0

php_admin_value[error_log] = /var/log/php-fpm/www-error.log
php_admin_flag[log_errors] = on
php_admin_value[memory_limit] = 256M
php_admin_value[max_execution_time] = 60
php_admin_value[opcache.enable] = 1
php_admin_value[opcache.memory_consumption] = 256
php_admin_value[opcache.max_accelerated_files] = 20000
php_admin_value[opcache.revalidate_freq] = 60

Nginx FastCGI 配置最佳實踐

# 上游定義 (支援多實例負載均衡)
upstream php_backend {
    server unix:/run/php/php8.2-fpm.sock weight=1 max_fails=3 fail_timeout=30s;
    # server 127.0.0.1:9000 weight=1;  # TCP 方式
    keepalive 64;  # 長連接池, 減少握手
}

server {
    listen 80;
    server_name example.com;
    root /data/www/example.com;
    index index.php index.html;

    # 靜態資源直接服務
    location ^~ /static/ { expires 30d; access_log off; try_files $uri =404; }
    location ^~ /uploads/ { expires 7d; location ~ \.php$ { deny all; } }

    # PHP 動態請求
    location ~ \.php$ {
        try_files $uri =404;  # 防止傳遞不存在文件到 PHP (安全)
        
        fastcgi_pass php_backend;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
        
        # 緩存配置 (可選, 適用於高頻只讀接口)
        fastcgi_cache PHP_CACHE;
        fastcgi_cache_valid 200 301 302 30m;
        fastcgi_cache_valid 404 1m;
        fastcgi_cache_key $scheme$request_method$host$request_uri;
        fastcgi_cache_bypass $http_cache_control;  # 客戶端可繞過緩存
        fastcgi_no_cache $http_cache_control;
        
        # 超時參數 (關鍵防 502/504)
        fastcgi_connect_timeout 5s;
        fastcgi_send_timeout 60s;
        fastcgi_read_timeout 60s;
        fastcgi_buffer_size 128k;
        fastcgi_buffers 4 256k;
        fastcgi_busy_buffers_size 512k;
        fastcgi_temp_file_write_size 512k;
    }

    # 前端控制器模式 (Laravel/ThinkPHP/Symfony)
    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
}

FastCGI 緩存參數深度解析

502 Bad Gateway / 504 Gateway Timeout 根因速查表

監控與可觀測性

• 啟用 pm.status_path，Prometheus 抓取 php-fpm-exporter 監控：active/idle 進程、請求耗時、慢請求數、內存使用。
• Nginx ngx_http_stub_status_module + nginx-prometheus-exporter 監控連接數、請求率、緩存命中率。
• 關鍵告警：PHP-FPM idle 進程 < 10%、平均響應時間 > 1s、502/504 率 > 0.1%、OOM 重啟次數 > 0。

掌握 Nginx + PHP-FPM 全鏈路原理與調優參數，是構建高併發、高可用 PHP 應用架構的核心內功。