验证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免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











