首选docker部署php 8.2，因官方php:8.2-apache/fpm镜像预装完整扩展、配置灵活、规避系统包版本冲突与路径差异；apt安装则扩展不全、默认配置保守、socket路径不统一易致nginx 502。
PHP 8.2 在 VPS 上部署，首选 Docker + php:8.2-apache 或 php:8.2-fpm，而不是手动编译或套用旧版 LAMP 脚本。VPS 环境已默认支持 systemd、apt/dnf、curl 和 bash，没必要重复造轮子。
为什么不用 apt install php8.2 直接装？
Ubuntu/Debian 官源的 php8.2 包虽然可用，但扩展不全（比如缺 php8.2-opcache、php8.2-igbinary），且 php.ini 默认配置偏保守（upload_max_filesize = 2M、max_execution_time = 30）。更麻烦的是：不同发行版对 php8.2-fpm 的 socket 路径不一致（/run/php/php8.2-fpm.sock vs /var/run/php/php8.2-fpm.sock），容易导致 Nginx 502。
实操建议：
- 用 Docker 部署可完全规避系统级 PHP 版本冲突和路径差异；
- 若必须用系统包（如某些云厂商禁用 Docker），请先运行
apt list --installed | grep php8.2确认所有扩展已安装，再检查systemctl status php8.2-fpm是否 active (running)； - 别直接改
/etc/php/8.2/fpm/pool.d/www.conf里的listen，优先用ls -l /run/php/看实际 sock 文件是否存在、权限是否为www-data:www-data。
docker-compose.yml 怎么写才不踩坑？
常见错误是把 MySQL 和 PHP 放在同一容器里，或忽略时区、上传限制、OPcache 启用状态。以下是最小可用配置（适配 Ubuntu 22.04+、Docker 24+）：
version: '3.8'
services:
web:
image: php:8.2-apache
ports:
- "80:80"
volumes:
- ./src:/var/www/html
- ./php.ini:/usr/local/etc/php/php.ini
environment:
TZ: Asia/Shanghai
depends_on:
- db
<p>db:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: rootpass
MYSQL_DATABASE: appdb
volumes:</p>
- dbdata:/var/lib/mysql
volumes: dbdata:
关键点：
-
./php.ini必须存在，内容至少包含：upload_max_filesize = 64M、post_max_size = 64M、opcache.enable=1； - 别用
php:8.2-cli镜像跑 Web，它没 Apache 模块； - 如果项目含 Composer 依赖，进容器执行
docker exec -it <container> sh -c "cd /var/www/html && composer install --no-dev"</container>，别在宿主机装完再拷进去（权限/符号链接易错）。
Nginx 反向代理 PHP-FPM 容器时怎么配 fastcgi_pass？
很多人卡在 Nginx 报 502 Bad Gateway，本质是网络不通或用户权限不对。Docker 默认桥接网络下，fastcgi_pass 不能写 unix:/var/run/php/php8.2-fpm.sock —— 容器内没有这个路径，宿主机的 sock 文件也根本不在容器网络里。
正确做法是让 Nginx 运行在宿主机（非容器），PHP-FPM 运行在容器，并通过 TCP 通信：
- 启动 PHP-FPM 容器时加
-p 9000:9000并设PHP_FPM_LISTEN=0.0.0.0:9000； - Nginx 配置中写
fastcgi_pass 127.0.0.1:9000;，而非 unix socket； - 确认 PHP-FPM 容器里
php-fpm.conf的listen = 0.0.0.0:9000和listen.allowed_clients = 0.0.0.0/0（开发环境临时放开，上线前收紧）。
部署后 curl -I http://localhost 返回 500 怎么快速定位？
不是看浏览器白屏，而是直接查日志链路：
- 先看 PHP 错误：进入容器执行
tail -f /var/log/apache2/error.log或docker logs <web-container> --since 5m</web-container>； - 如果是 Fatal error，大概率是扩展缺失（如
Class 'PDO' not found）—— 检查php -m | grep pdo； - 如果日志空但返回 500，检查
DocumentRoot下是否有index.php，且文件权限是www-data可读（chmod 644，非600）； - 别忽略 SELinux（CentOS/RHEL）：运行
ausearch -m avc -ts recent | audit2why，若提示 denied “getattr” on “/var/www/html”，执行setsebool -P httpd_read_user_content 1。
真正麻烦的从来不是装 PHP 8.2，而是当 phpinfo() 显示 OPcache enabled，但页面仍慢得像没开——这时候得去查 opcache.revalidate_freq 是不是设成了 0（开发友好，生产灾难）。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
