温馨提示×

Debian PHP与Nginx怎么配置

小樊
66
2026-08-27 11:44:00
栏目: 编程语言

下面给你一个在 Debian 系统上配置 Nginx + PHP(PHP-FPM)的完整流程,适用于 Debian 11 / 12,也基本适用于 Ubuntu。


一、安装 Nginx 和 PHP

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装 Nginx

sudo apt install nginx -y

启动并设置开机自启:

sudo systemctl enable nginx
sudo systemctl start nginx

3. 安装 PHP(PHP-FPM)

以 PHP 8.2 为例(Debian 12 默认):

sudo apt install php8.2-fpm php8.2-cli -y

常用扩展(按需):

sudo apt install php8.2-mysql php8.2-curl php8.2-gd php8.2-mbstring php8.2-xml php8.2-zip -y

启动 PHP-FPM:

sudo systemctl enable php8.2-fpm
sudo systemctl start php8.2-fpm

确认运行状态:

systemctl status php8.2-fpm

二、配置 Nginx 支持 PHP

1. 创建网站目录

sudo mkdir -p /var/www/example.com

2. 创建测试 PHP 文件

echo "<?php phpinfo(); ?>" | sudo tee /var/www/example.com/index.php

3. 配置 Nginx 虚拟主机

编辑配置文件:

sudo nano /etc/nginx/sites-available/example.com

示例配置(重点看 PHP 部分):

server {
    listen 80;
    server_name example.com www.example.com;

    root /var/www/example.com;
    index index.php index.html index.htm;

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

    # PHP 处理
    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
    }

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

4. 启用站点

sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/

测试 Nginx 配置:

sudo nginx -t

重载 Nginx:

sudo systemctl reload nginx

三、验证是否成功

浏览器访问:

http://服务器IP

或

http://example.com

看到 phpinfo() 页面即成功 ✅


四、常见问题排查

1. 访问 PHP 显示下载而不是执行

✅ 原因:Nginx 没有正确转发给 PHP-FPM
✅ 检查:

fastcgi_pass unix:/run/php/php8.2-fpm.sock;

2. 502 Bad Gateway

检查 PHP-FPM 是否运行:

systemctl status php8.2-fpm

检查 sock 文件是否存在:

ls /run/php/

3. 权限问题

sudo chown -R www-data:www-data /var/www/example.com
sudo chmod -R 755 /var/www/example.com

五、常见优化(可选)

PHP-FPM 配置

sudo nano /etc/php/8.2/fpm/pool.d/www.conf

确认:

user = www-data
group = www-data
listen = /run/php/php8.2-fpm.sock

六、HTTPS(推荐)

使用 Let’s Encrypt:

sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d example.com -d www.example.com

如果你愿意,我可以帮你:

  • ✅ 配置 多站点
  • ✅ 配置 Laravel / ThinkPHP
  • ✅ 配置 HTTPS + 安全加固
  • ✅ 排查 502 / 404 / 权限问题

直接告诉我你的 Debian 版本 + PHP 版本 + 使用场景 即可。

0 踩