php在Linux怎么部署_LNMP环境搭建PHP服务的详细指南【指南】

应先确认系统类型再配置PHP环境:CentOS/RHEL需添加Remi源启用PHP 8.2,Ubuntu/Debian需启用universe源;LNMP必须用php-fpm而非mod_php;Nginx需正确配置fastcgi_pass并验证php-fpm运行状态;注意MySQL用户权限、扩展加载及SELinux等权限问题。

确认 Linux 发行版和软件源状态

不同发行版的包管理器和默认仓库内容差异很大,直接 yum install phpapt install php 可能装到过时版本(如 PHP 7.4),甚至缺关键模块(如 php-fpmphp-mysqlnd)。务必先查清系统类型:

cat /etc/os-release
。CentOS/RHEL 8+ 默认用 dnf,且官方源已移除 PHP;Ubuntu 22.04 默认带 PHP 8.1,但扩展需单独安装。

  • Debian/Ubuntu:确保启用 universe 源(/etc/apt/sources.list 中含 deb http://archive.ubuntu.com/ubuntu jammy universe
  • CentOS Stream / Rocky Linux:必须添加 Remi 仓库(dnf install https://rpms.remirepo.net/enterprise/remi-release-9.rpm),再启用 PHP 8.2 模块:dnf module enable php:remi-8.2
  • 跳过 EPEL 单独装 PHP —— 它不提供主 PHP 包,只补工具类扩展

安装 Nginx + PHP-FPM 而非 mod_php

LNMP 中 PHP 必须以 php-fpm 方式运行,Nginx 本身不解析 PHP 文件。装错成 Apache 的 libapache2-mod-php 或 Nginx 的 php-cgi(已废弃)会导致 502 Bad Gateway 或 404。

  • 安装命令示例(Ubuntu 22.04):apt install nginx php-fpm php-mysql php-curl php-gd php-mbstring php-xml php-zip
  • 关键配置文件路径:/etc/php/8.1/fpm/pool.d/www.conf(监听套接字或端口)、/etc/nginx/sites-enabled/default(Nginx 需 proxy_pass 到 unix:/run/php/php8.1-fpm.sock127.0.0.1:9000
  • 务必检查 php-fpm 是否启用并运行:systemctl is-enabled php8.1-fpmsystemctl status php8.1-fpm,否则 Nginx 请求会超时

验证 PHP 是否被 Nginx 正确调用

常见错误是 Nginx 配置里漏了 fastcgi_pass,或 fastcgi_param SCRIPT_FILENAME 指向错误路径,导致返回空白页或直接下载 .php 文件。

  • /var/www/html/info.php 写:
  • Nginx server 块中必须包含:
    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
    }
  • 若看到下载 info.php,说明 Nginx 根本没把请求交给 PHP-FPM —— 检查 location 是否被更宽泛的规则(如 location /)覆盖,或 fastcgi_pass 地址与 php-fpm 实际监听地址不一致

MySQL 连接权限与 PHP 扩展加载问题

PHP 脚本能跑 phpinfo() 不代表能连数据库。两个高频断点:MySQL 用户未授权远程(或 localhost)访问,以及 mysqlipdo_mysql 扩展未启用。

  • 检查扩展是否加载:php -m | grep -E 'mysqli|pdo_mysql';若无输出,编辑 /etc/php/8.1/fpm/php.ini,取消注释 extension=mysqliextension=pdo_mysql,然后重启 php8.1-fpm
  • MySQL 创建用户时别用 'user'@'%' 就完事 —— 若 PHP-FPM 与 MySQL 同机,Nginx 传来的连接常是 localhost,需显式建 'user'@'localhost'GRANT 权限
  • mysqli_connect() 报错 Connection refused:优先查 mysql.service 是否运行,再查 bind-address 是否设为 127.0.0.1(而非 0.0.0.0 或注释掉)
Nginx 的 root 目录权限、PHP-FPM 的 user/group(默认 www-datanginx)、SELinux 策略(RHEL 系默认开启)——这三个地方出问题,比 PHP 语法错误更难定位。