PHP应用绑定域名后返回404,根本原因是Web服务器(Apache/Nginx)未正确路由域名至项目目录:Apache需检查VirtualHost的DocumentRoot、ServerName/ServerAlias及启用httpd-vhosts.conf;Nginx需确保server_name匹配、root路径准确、PHP location块配置正确;还需启用URL重写(.htaccess或try_files)并确认DNS已解析到服务器IP。

PHP 应用绑定域名后返回 404,通常不是 PHP 本身的问题,而是 Web 服务器(如 Apache 或 Nginx)未正确将该域名路由到你的项目目录。PHP 不处理域名解析或路由分发,它只响应服务器转发过来的请求。
Apache 的 VirtualHost 配置漏了 DocumentRoot 或 ServerName
常见错误是只改了 httpd-vhosts.conf,但没启用虚拟主机、没指定根目录,或域名拼写不一致(比如少写 www. 却在浏览器里带 www 访问)。
- 确认
httpd.conf中已取消注释:Include conf/extra/httpd-vhosts.conf -
ServerName必须和浏览器地址栏完全一致(example.com≠www.example.com),建议同时加ServerAlias www.example.com -
DocumentRoot路径末尾不要加斜杠,且需确保路径真实存在、有读取权限 - 重启 Apache:
sudo apachectl restart(macOS)或sudo systemctl restart apache2(Ubuntu)
Nginx 的 server_name 和 root 不匹配项目实际路径
Nginx 对大小写、斜杠、通配符更敏感;一旦 server_name 不匹配或 root 指向错误目录,就会直接返回 404,甚至不进 PHP-FPM。
-
server_name example.com www.example.com;—— 多个域名用空格分隔,别用逗号 -
root值应为项目完整绝对路径,例如/var/www/myapp,不是/var/www/myapp/public(除非你的入口文件index.php确实在那) - 检查
location ~ \.php$块是否包含fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;(推荐用$realpath_root避免符号链接问题) - 重载配置:
sudo nginx -t && sudo nginx -s reload
PHP 项目自身要求入口路径(如 Laravel、ThinkPHP)被 Web 服务器重写
很多框架依赖 URL 重写把所有请求导向 index.php。如果 .htaccess(Apache)或 try_files(Nginx)没配,静态资源可能 404,但更常见的是整个站点 404 —— 因为服务器找不到对应物理文件,又没 fallback 规则。
立即学习“PHP免费学习笔记(深入)”;
- Apache:确保
AllowOverride All在对应Directory块中启用,且.htaccess存在并含标准重写规则 - Nginx:在
server块内加location / { try_files $uri $uri/ /index.php?$query_string; } - 验证是否生效:访问一个不存在的路径(如
/abc123),若返回框架的 404 页面(而非 Nginx/Apache 默认 404),说明重写已工作
server {
listen 80;
server_name example.com;
root /var/www/myapp/public;
index index.php;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
include fastcgi_params;
}
}
最容易被忽略的是:DNS 解析是否真的指向了你这台服务器的 IP。本地 hosts 文件可临时测试,但上线前务必确认域名 DNS 的 A 记录已生效(dig example.com +short 或 nslookup example.com)。否则,请求根本没到你的服务器,自然不会触发任何配置逻辑。











