PHP

井水玉藻

PHP 8.5.6 是当前的最新稳定版本

1. 添加 PHP 官方维护者仓库

sudo apt update
sudo apt install -y lsb-release ca-certificates curl apt-transport-https

# 添加GPG 密钥
sudo curl -sSLo /usr/share/keyrings/deb.sury.org-php.gpg https://packages.sury.org/php/apt.gpg

# 添加 PHP 仓库到系统源列表
echo "deb [signed-by=/usr/share/keyrings/deb.sury.org-php.gpg] https://packages.sury.org/php/ $(lsb_release -sc) main" \
    | sudo tee /etc/apt/sources.list.d/php.list

2. 安装 PHP 8.5.6 及其扩展

sudo apt update
sudo apt install -y php8.5-cli php8.5-common \
    php8.5-curl \
    php8.5-dom \
    php8.5-gd \
    php8.5-mbstring \
    php8.5-mysql \
    php8.5-zip \
    php8.5-fpm \
    php8.5-gmp \
    php8.5-bcmath \
    php8.5-redis
# 如果你配合 Nginx 使用，建议安装 FPM
# phpMyAdmin需要 php8.5-gmp php8.5-bcmath

3. 验证安装结果

安装完成后，你可以通过以下命令检查版本和已加载的模块：

检查版本： php -v （应显示 PHP 8.5.6）

检查扩展： 运行以下命令查看你要求的扩展是否全部在线：

php -m | grep -E "curl|dom|fileinfo|gd|json|mbstring|openssl|pdo_mysql|tokenizer|zip"

井水玉藻

Nginx 502 Bad Gateway 一般是由于 Nginx默认的用户为 nginx

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

可以修改 Nginx 运行用户

sudo nano /etc/nginx/nginx.conf

检查第一行，如果是 user nginx; 请修改为 user www-data;

井水玉藻

Nginx 与 PHP-FPM 通过 Unix Socket（.sock）通信失败的常见原因及解决方案。

当 Nginx 返回 502 Bad Gateway 且日志中出现 connect() to unix:/run/php/php8.5-fpm.sock failed (13: Permission denied) 时，请按以下步骤检查。

1. 权限校验

Unix Socket 是一个文件，通信双方必须有权限读写该文件。

问题描述：Nginx 的 Worker 进程用户与 PHP-FPM 的 listen.owner 不一致。
检查方法：
查看 Nginx 运行用户：ps aux | grep nginx（通常是 www-data 或 nginx）。
查看 Sock 文件权限：ls -l /run/php/php8.5-fpm.sock。

解决方案：
编辑 /etc/php/8.5/fpm/pool.d/www.conf，确保以下配置取消注释：

listen.owner = www-data
listen.group = www-data
listen.mode = 0660

同时确保 /etc/nginx/nginx.conf 第一行的 user 也是 www-data。

2. 目录不存在或路径错误

问题描述：PHP-FPM 无法在不存在的目录中创建 .sock 文件。
检查方法：ls -d /run/php/。

解决方案：

sudo mkdir -p /run/php/
sudo chown www-data:www-data /run/php/

在 Nginx 配置中，确保 fastcgi_pass 的路径与 www.conf 中的 listen 路径完全一致。

3. 配置冲突：TCP vs Unix Socket

问题描述：在 PHP 配置中同时开启了 9000 端口监听和 sock 监听，导致其中一个失效。

解决方案：
在 www.conf 中，只能保留一个有效的 listen 指令：

; 禁用 TCP 监听
; listen = 127.0.0.1:9000 
    
; 启用 Unix Socket
listen = /run/php/php8.5-fpm.sock

4. 站点根目录（/home 路径）权限障碍

问题描述：当你将网站放在 /home/www 时，即使 Sock 连接成功，Nginx 也可能因为无法进入 /home 目录而报错。

解决方案：
赋予 www-data 用户对路径的“执行”权限（进入目录的权限）：

sudo chmod 755 /home/www
sudo chmod 755 /home/www/
sudo chown -R www-data:www-data /home/www

5. 快速恢复指令集

如果修改了配置，请务必按此顺序重启服务以生效：

# 1. 检查 Nginx 语法
sudo nginx -t

# 2. 重启 PHP-FPM (这会重新生成 .sock 文件)
sudo systemctl restart php8.5-fpm

# 3. 重启 Nginx
sudo systemctl restart nginx

井水玉藻

配置好了 PHP 环境，安装 Composer

curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer