include/require 报 404 实为 php 文件未找到警告，非 http 404；应使用 dir 拼接绝对路径，避免相对路径依赖易变的工作目录，并用 file_exists() 和 is_readable() 验证文件存在且可读。
include/require 报 404 是因为路径没走 Web 服务器，而是走 PHP 解析器
PHP 的 include、require 等函数不经过 Apache/Nginx 路由，也不触发 HTTP 请求，所谓“404”其实是 PHP 报的 Warning: include(...): failed to open stream: No such file or directory，但浏览器显示 404 往往是上层框架或路由拦截了错误页。本质是文件根本没找到，不是 HTTP 层面的 404。
用 __DIR__ 或 dirname(__FILE__) 拼路径最稳
相对路径（如 include "inc/config.php"）依赖当前工作目录（getcwd()），而该目录可能随 CLI 调用、Web 入口不同剧烈变化，极易出错。绝对路径才是唯一可靠解法，且必须基于文件自身位置，而非执行入口。
-
__DIR__是当前文件所在目录的绝对路径（PHP 5.3+），推荐首选 -
dirname(__FILE__)功能等价，兼容老版本但略啰嗦 - 避免用
$_SERVER['DOCUMENT_ROOT']—— 它依赖 Web 服务器配置，CLI 下为空，多子域名或别名目录时不可靠
include __DIR__ . '/inc/config.php'; include __DIR__ . '/../lib/Database.php';
require_once 和 include_once 不解决路径问题，只防重复加载
很多人以为加 once 能绕过路径错误，其实不然：只要第一次路径错，照样报错终止；只有路径对、文件存在时，once 才起作用。它不参与路径解析，也不修复路径逻辑。
- 路径错 → 直接 fatal error 或 warning，
once完全不生效 - 路径对但多次包含同一文件 →
once防止重复执行，避免函数重定义等错误 - 调试时可临时改
include为require，让错误立刻暴露，别等运行到某处才崩
上线前务必检查 realpath() 是否返回 false
路径拼出来只是字符串，不代表文件真实存在。尤其在部署后因大小写、软链接、权限或跨平台（Windows vs Linux）导致路径“看起来对，实际打不开”。
立即学习“PHP免费学习笔记（深入）”；
- 用
realpath($path)验证路径是否解析成功，返回false就说明有问题 - 配合
file_exists()和is_readable()做双保险 - Linux 下
inc/config.php和INC/CONFIG.PHP是两个文件，Windows 可能不报错，Linux 直接失败
$path = __DIR__ . '/inc/config.php';
if (!file_exists($path) || !is_readable($path)) {
throw new Exception('Config file missing or unreadable: ' . $path);
}
include $path;
路径错的本质是 PHP 找不到物理文件，不是 URL 映射问题；所有“以当前脚本为基准”的路径计算，都得靠 __DIR__ 打底，再手动拼。别信文档根目录，别赌工作目录，也别把 Web 路径和文件系统路径混为一谈。 
