Nginx与PHP-FPM集成开发环境搭建指南

一、环境准备

1. 系统要求

• Linux/Unix系统(推荐Ubuntu/CentOS)
• 或Windows(WSL2环境)
• 管理员权限

2. 软件需求

• Nginx
• PHP(带FPM模块)
• 可选数据库(MySQL/MariaDB/PostgreSQL)

二、安装步骤

1. 安装Nginx

Ubuntu/Debian:

sudo apt update
sudo apt install nginx
sudo systemctl start nginx
sudo systemctl enable nginx

CentOS/RHEL:

sudo yum install epel-release
sudo yum install nginx
sudo systemctl start nginx
sudo systemctl enable nginx

2. 安装PHP和PHP-FPM

Ubuntu/Debian (以PHP8.1为例):

sudo apt install php-fpm php-cli php-mysql php-curl php-gd php-mbstring php-xml php-zip
sudo systemctl start php8.1-fpm
sudo systemctl enable php8.1-fpm

CentOS/RHEL:

sudo yum install php php-fpm php-mysqlnd
sudo systemctl start php-fpm
sudo systemctl enable php-fpm

3. 配置Nginx与PHP-FPM

1. 编辑Nginx默认配置文件:

sudo nano /etc/nginx/sites-available/default

2. 修改或添加以下内容:

server {
    listen 80;
    server_name localhost;
    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:/var/run/php/php8.1-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

注意：根据你的PHP版本调整php8.1-fpm.sock路径

3. 测试Nginx配置并重启:

sudo nginx -t
sudo systemctl reload nginx

4. 测试PHP

1. 创建测试文件:

sudo nano /var/www/html/info.php

2. 添加内容:

<?php phpinfo(); ?>

3. 访问 http://localhost/info.php 查看PHP信息

三、常见问题解决

1. 502 Bad Gateway错误

• 检查PHP-FPM是否运行: sudo systemctl status php-fpm
• 检查sock文件路径是否正确
• 确保Nginx用户(通常是www-data)有权限访问sock文件

2. PHP文件被下载而非执行

• 确保Nginx配置中正确处理.php文件
• 检查fastcgi_pass指令是否正确

3. 性能优化建议

• 调整PHP-FPM池配置(/etc/php/8.1/fpm/pool.d/www.conf)
• 启用OPcache: sudo apt install php-opcache
• 配置Nginx缓存

四、可选组件安装

1. 安装MySQL/MariaDB

sudo apt install mysql-server
sudo mysql_secure_installation

2. 安装phpMyAdmin

sudo apt install phpmyadmin
# 配置Nginx指向phpMyAdmin目录

五、开发环境建议

1. 配置本地域名:

   • 编辑/etc/hosts添加 127.0.0.1 mydev.local
   • 配置Nginx server_name为mydev.local

2. 启用错误显示(仅开发环境):

   • 修改php.ini: display_errors = On
   • 重启PHP-FPM: sudo systemctl restart php-fpm

3. 安装Xdebug进行调试:

sudo apt install php-xdebug
# 配置xdebug.ini

通过以上步骤，你应该已经成功搭建了Nginx+PHP-FPM的开发环境。根据你的具体项目需求，可能还需要安装其他PHP扩展或配置数据库连接。