LinuxUbuntu配置PHP环境四大操作步骤-php教程-PHP中文网

ubuntu配php环境需完成四步闭环：装对组件（如libapache2-mod-php或php-fpm）、打通通信（确保socket路径与用户权限一致）、指对目录（root路径与script_filename匹配）、验准行为（用php -m和php-fpm -i确认模块及配置生效）。

linuxubuntu配置php环境四大操作步骤

Ubuntu 上配 PHP 环境，不是装完 php 就能跑起来的——缺了 Web 服务器、没连上 PHP-FPM、权限或路径写错，502 Bad Gateway 或空白页是常态。关键在四步闭环：装对组件、打通通信、指对目录、验准行为。

装 PHP 和扩展必须带 `php-fpm` 和 `libapache2-mod-php`（选 Apache 时）

Ubuntu 默认源里的 PHP 版本偏旧，但直接用 apt install php 只装 CLI 模式，Web 无法调用。要跑网站，得按用途选包：

Apache 用户：必须装 libapache2-mod-php，否则 .php 文件会被当纯文本下载；执行 sudo a2enmod php 后还得 sudo systemctl restart apache2
Nginx 用户：必须装 php-fpm，不能只装 php；版本号要对齐，比如装了 php8.1，就得用 php8.1-fpm，配置里写 fastcgi_pass unix:/run/php/php8.1-fpm.sock
扩展别漏 php-mbstring 和 php-xml——Laravel、Symfony 一启动就报错；php-opcache 要手动启用，否则性能差一截
验证命令别只跑 php -v，补一句 php -m | grep -E "fpm|mysql|mbstring"，确认模块真加载了

`/etc/php/*/fpm/pool.d/www.conf` 里三个参数必须一致

PHP-FPM 不是装完就自动和 Nginx 对得上——它默认以 www-data 用户跑，但 socket 文件属主/属组、FPM 进程用户、Nginx worker 用户三者不一致，就会 Permission denied。

Linux installer

先解析安全源，运行本地CLI安装、启动、卸载Linux桌面应用。用户请求时使用。

下载

listen.owner 和 listen.group 必须设成 www-data（Ubuntu 标准）
user 和 group 也必须是 www-data，不能写 root 或留空
listen = /run/php/php8.1-fpm.sock 路径要和 Nginx 配置里 fastcgi_pass 完全一致；注意 /run/php/ 是内存文件系统，重启后重建，别硬链到 /var/run/
改完配置必须 sudo systemctl restart php8.1-fpm，光 reload 不生效

Nginx 的 `location ~ \.php$` 块漏掉 `fastcgi_param SCRIPT_FILENAME` 就 404

很多教程复制粘贴时删掉了这行，结果访问 info.php 返回 404 或空白——Nginx 找得到 PHP 文件，但传给 FPM 时没告诉它“要执行哪个文件”。

标准写法里，include snippets/fastcgi-php.conf 已包含该参数，但前提是这个文件存在且未被注释；检查路径：/etc/nginx/snippets/fastcgi-php.conf
如果手动写，必须加：fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;，$document_root 要和 root 指令值完全匹配
常见坑：root /var/www/myapp 时，info.php 得放 /var/www/myapp/info.php；若框架要求入口在 public/，root 就得写 /var/www/myapp/public，否则 index.php 找不到
改完配置务必 sudo nginx -t 测语法，再 sudo systemctl reload nginx

`phpinfo()` 显示但项目报 `Class not found`？查 `php.ini` 加载路径

终端里 php -v 和浏览器里 phpinfo() 显示的 Loaded Configuration File 经常不一样——CLI 用一套 ini，FPM 用另一套，扩展开了但没加载进 Web 环境。

运行 php --ini 查 CLI 加载路径，php-fpm -i | grep "Loaded Configuration File" 查 FPM 实际加载的 ini
Ubuntu 下 FPM 的主 ini 通常在 /etc/php/8.1/fpm/php.ini，CLI 在 /etc/php/8.1/cli/php.ini；改错地方等于白改
开 opcache 要在 FPM 的 ini 里设 opcache.enable=1，CLI 的 ini 开了也没用
上传限制、时区、错误报告级别这些影响运行的行为，都得在 FPM 的 ini 里调，而不是 CLI 的

最易被忽略的是：PHP-FPM 配置改了、Nginx 配置改了、php.ini 也改了，但没重启对应服务，或者重启顺序错了（比如先 reload Nginx 再 start php-fpm），导致状态不一致。每次调完，用 sudo systemctl status php8.1-fpm nginx 看两服务都是 active (running)，再测请求。