PHP运行后显示网页无法访问的常见原因

Question

PHP运行后显示网页无法访问的常见原因之一是Web服务器配置错误。例如，Apache未正确加载PHP模块或虚拟主机未指向正确的网站根目录，会导致PHP文件无法解析，直接返回404或500错误。此外，Nginx若未配置fastcgi_pass指向PHP-FPM服务，也会造成页面无法响应。检查服务器配置文件、确认PHP模块已启用，并确保端口与权限设置正确，是排查此类问题的关键步骤。

Answer 1

一、问题现象与初步诊断

当PHP脚本部署后出现“网页无法访问”时，最常见的表现形式是浏览器返回 404 Not Found 或 500 Internal Server Error。这类错误往往并非PHP语法问题所致，而是Web服务器未能正确解析或响应请求。

• Apache 返回 404：可能未启用 mod_php 模块或 DocumentRoot 配置错误
• Nginx 显示空白页或 502 Bad Gateway：通常因未正确连接 PHP-FPM 进程
• 请求直接下载 .php 文件：说明 PHP 解析器未被调用

二、常见配置错误分类

服务器类型	典型配置错误	对应错误码	影响范围
Apache	未加载 php_module	404 / 下载文件	全局站点失效
Apache	VirtualHost 路径错误	404	特定域名不可达
Nginx	缺失 fastcgi_pass 指令	502	所有 PHP 请求失败
Nginx	root 目录权限不足	403 Forbidden	静态资源+动态脚本均受限
PHP-FPM	监听端口不匹配	502	网关通信中断

三、深入排查流程图

graph TD
    A[用户访问 index.php] --> B{HTTP 状态码?}
    B -->|404| C[检查 DocumentRoot / root 路径]
    B -->|500/502| D[查看 error_log 日志]
    D --> E[确认 PHP 模块是否加载]
    E --> F[Apache: LoadModule php_module?]
    E --> G[Nginx: 是否配置 fastcgi_pass?]
    G --> H[PHP-FPM 是否运行?]
    H --> I[ps aux | grep php-fpm]
    I --> J[检查 listen 地址与 Nginx 一致]
    J --> K[验证 sock 权限和用户组]
    

四、Apache 配置深度分析

在 Apache 中，PHP 的集成依赖于模块化机制。若 mod_php 未启用，则服务器将把 .php 文件视为静态资源处理，导致直接下载或 404 错误。

# 检查模块是否加载
httpd -M | grep php
# 启用模块（Debian系）
a2enmod php8.1
# 确保虚拟主机配置正确
<VirtualHost *:80>
DocumentRoot /var/www/html/myapp
<Directory "/var/www/html/myapp">
AllowOverride All
Require all granted
</Directory>
</VirtualHost>

五、Nginx + PHP-FPM 协作机制详解

Nginx 本身不能执行 PHP 脚本，必须通过 FastCGI 接口转发给 PHP-FPM 处理。关键在于 fastcgi_pass 指令的准确性。

location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.1-fpm.sock; # 必须与 php-fpm pool 配置一致
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}

此处的 socket 路径需与 /etc/php/8.1/fpm/pool.d/www.conf 中的 listen = ... 完全匹配。

六、权限与端口校验清单

1. 检查网站根目录是否对 www-data 用户可读：ls -ld /var/www/html
2. 确认 PHP-FPM socket 文件权限：srw-rw---- 1 www-data www-data
3. 测试 PHP-FPM 是否监听：netstat -tlnp | grep php-fpm
4. 防火墙是否放行 80/443 端口：ufw status
5. SELinux 是否阻止访问（RHEL/CentOS）：ausearch -m avc -ts recent
6. systemd 服务状态：systemctl status apache2 || systemctl status nginx
7. 日志追踪路径：tail -f /var/log/nginx/error.log
8. 临时关闭安全模块测试：setsebool -P httpd_can_network_connect 1
9. 使用 curl 测试本地响应：curl -I http://localhost/index.php
10. 验证 PHP CLI 可用性：php -v（排除安装损坏）