PHP绑定域名错出404怎么办_PHP域名绑定404更正法【注意点】

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 配置漏了 DocumentRootServerName

常见错误是只改了 httpd-vhosts.conf,但没启用虚拟主机、没指定根目录,或域名拼写不一致(比如少写 www. 却在浏览器里带 www 访问)。

  • 确认 httpd.conf 中已取消注释:Include conf/extra/httpd-vhosts.conf
  • ServerName 必须和浏览器地址栏完全一致(example.comwww.example.com),建议同时加 ServerAlias www.example.com
  • DocumentRoot 路径末尾不要加斜杠,且需确保路径真实存在、有读取权限
  • 重启 Apache:sudo apachectl restart(macOS)或 sudo systemctl restart apache2(Ubuntu)

Nginx 的 server_nameroot 不匹配项目实际路径

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 规则。

  • 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 +shortnslookup example.com)。否则,请求根本没到你的服务器,自然不会触发任何配置逻辑。