验证PHP环境需三步：创建info.php并访问确认PHP版本及pdo_mysql等扩展加载；检查$_SERVER['SERVER_SOFTWARE']值确认Web服务器与PHP打通；排查常见坑如mod_php未启用、php-fpm未启动或SELinux拦截。
怎么确认 PHP 环境真就绪了
别信“装了就行”，本地或服务器上必须亲手验证三件事：
• 创建 info.php 放在 Web 根目录（如 /var/www/html/info.php），内容只有 <?php phpinfo(); ?>
• 浏览器访问 http://你的IP/info.php，页面必须完整显示 PHP 版本、已加载扩展（尤其确认 pdo_mysql、mysqli 出现在列表里）
• 查看页面底部的 $_SERVER['SERVER_SOFTWARE'] 值：如果是 Apache/2.4.x 或 nginx/x.x.x，说明 Web 服务器和 PHP 已打通；如果空白或报 500，说明模块没加载或权限不对
• 常见坑：libapache2-mod-php 没装（Ubuntu）、php-fpm 服务没启动（Nginx 场景）、SELinux 拦截（CentOS）
上传代码后页面空白或下载 .php 文件
这是部署中最高频的失败现象，本质是 Web 服务器没把 .php 当脚本执行，而是当普通文件返回了。
• Apache 场景：检查 a2enmod php 是否执行过，确认 /etc/apache2/mods-enabled/php*.load 存在；再查 DocumentRoot 路径是否和你放代码的路径完全一致（注意末尾斜杠、大小写）
• Nginx 场景：重点核对 location ~ \.php$ 块里的 fastcgi_pass——它必须指向正在运行的 PHP-FPM socket 或端口，比如 unix:/run/php/php8.1-fpm.sock；用 sudo systemctl status php8.1-fpm 看服务状态
• 权限问题：www-data（Ubuntu）或 apache（CentOS）用户必须对整个项目目录有读+执行权（chmod -R 755），对 config.php 等敏感文件可设为 644
• 错误日志永远比浏览器提示有用：tail -f /var/log/apache2/error.log 或 /var/log/nginx/error.log
数据库连不上，但配置明明是对的
错误信息里出现 Connection refused 或 Access denied，90% 不是密码输错，而是网络或权限隔离导致。
• 先确认 MySQL 服务在运行：sudo systemctl status mysql
• 登录 MySQL 控制台：mysql -u root -p，然后执行：
SELECT host, user FROM mysql.user WHERE user = 'your_app_user'; —— 如果 host 是 localhost，那 PHP 用 127.0.0.1 连就会被拒（Unix socket 和 TCP 的区别）；改成 % 或具体 IP 才行
SHOW DATABASES LIKE 'your_db_name'; —— 确认库存在且名字拼写完全一致（区分大小写！）
• PDO 连接字符串里，host 写 127.0.0.1 强制走 TCP，比写 localhost 更可靠
• 密码含特殊字符（如 @、/）必须 URL 编码，否则 new PDO("mysql:host=localhost;dbname=test", $user, $pass) 会解析失败
部署后功能异常但没报错
比如表单提交后页面刷新但数据没入库、图片上传失败、分页链接带错参数——这类问题往往藏在细节里，而不是大框架。
• 检查 php.ini 关键项：upload_max_filesize 和 post_max_size 必须大于你要传的文件；max_execution_time 别设成 1（某些共享主机默认值）
• .htaccess 文件只对 Apache + AllowOverride All 生效；Nginx 完全不认它，重写规则得写进 server 块里
• 时区必须显式设置：date_default_timezone_set('Asia/Shanghai'); 放在入口文件最开头，否则 date()、MySQL 的 NOW() 可能差 8 小时
• 所有外部路径（如图片上传目录、缓存路径）用绝对路径定义：define('UPLOAD_DIR', __DIR__ . '/uploads');，避免相对路径在 CLI 和 Web 下行为不一致
立即学习“PHP免费学习笔记（深入）”；
真实部署里最耗时间的，从来不是写哪行配置，而是确认“PHP 解析器到底有没有读到这个文件”“MySQL 的那个用户到底能不能从这个 IP 连进来”“这个 403 错误到底是 Nginx 配置还是 Linux 文件权限”。每次卡住，先看日志，再缩小范围，别猜。
