Nginx 配置 PHP 的完整指南

要在 Nginx 服务器上运行 PHP 应用程序，你需要正确配置 Nginx 与 PHP 处理器（通常是 PHP-FPM）的交互。以下是详细配置步骤：

1. 安装必要组件

首先确保已安装以下软件： - Nginx - PHP - PHP-FPM (FastCGI Process Manager)

在 Ubuntu/Debian 上安装：

sudo apt update
sudo apt install nginx php-fpm php-mysql

在 CentOS/RHEL 上安装：

sudo yum install epel-release
sudo yum install nginx php-fpm php-mysql

2. 基本 Nginx PHP 配置

编辑 Nginx 的服务器配置文件（通常在 /etc/nginx/sites-available/your_site）：

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

    location / {
        try_files $uri $uri/ =404;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.1-fpm.sock; # 根据你的PHP版本调整
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.ht {
        deny all;
    }
}

3. PHP-FPM 配置

确保 PHP-FPM 正在运行并监听正确的套接字：

sudo systemctl start php-fpm
sudo systemctl enable php-fpm

检查 PHP-FPM 监听地址（通常在 /etc/php/8.1/fpm/pool.d/www.conf 中）：

listen = /run/php/php8.1-fpm.sock

4. 测试配置

创建测试 PHP 文件：

echo "<?php phpinfo(); ?>" > /var/www/html/info.php

然后： 1. 测试 Nginx 配置：sudo nginx -t 2. 重启 Nginx：sudo systemctl restart nginx 3. 访问 http://your_server_ip/info.php 查看 PHP 信息页面

5. 常见问题解决

问题1：502 Bad Gateway - 检查 PHP-FPM 是否运行：systemctl status php-fpm - 确保 fastcgi_pass 路径与 PHP-FPM 配置一致

问题2：PHP 文件被下载而不是执行 - 确保 Nginx 配置中包含 PHP 处理部分 - 检查 include snippets/fastcgi-php.conf 是否存在

问题3：权限问题 - 确保 Nginx 用户（通常是 www-data 或 nginx）有权限访问 PHP 文件和套接字 - 设置正确权限：sudo chown -R www-data:www-data /var/www/html

6. 性能优化配置

location ~ \.php$ {
    fastcgi_pass unix:/run/php/php8.1-fpm.sock;
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;

    # 缓存和超时设置
    fastcgi_buffer_size 128k;
    fastcgi_buffers 4 256k;
    fastcgi_busy_buffers_size 256k;
    fastcgi_read_timeout 300;

    # 启用 OPcache
    fastcgi_param PHP_VALUE "opcache.enable=1 \n opcache.enable_cli=1";
}

7. 多版本 PHP 配置

如果你需要同时运行多个 PHP 版本：

# PHP 7.4
location ~ ^/php74/.*\.php$ {
    fastcgi_pass unix:/run/php/php7.4-fpm.sock;
    # 其他配置...
}

# PHP 8.1
location ~ \.php$ {
    fastcgi_pass unix:/run/php/php8.1-fpm.sock;
    # 其他配置...
}

完成以上配置后，你的 Nginx 服务器应该能够正确处理 PHP 文件了。记得根据你的实际 PHP 版本和系统环境调整路径和参数。