include()报错主因是路径错误而非语法问题，PHP按绝对路径→相对路径→include_path等顺序查找；应统一用__DIR__拼接绝对路径并慎用_once和作用域控制。
路径写错是include()报错的最常见原因
绝大多数 include() 报错（比如 Warning: include(): Failed opening 'xxx.php' for inclusion）根本不是语法问题，而是路径没找对。PHP 查找文件的顺序很具体：先看是不是绝对路径（以 / 或盘符开头），是就直接用；否则，如果路径以 ./ 或 ../ 开头，就只在当前工作目录（getcwd() 返回的路径）下找，完全忽略 include_path；其他情况才按 include_path → 执行脚本所在目录 → 当前工作目录的顺序挨个试。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
访问全球海洋潮汐模型。功能包括查询指定日期、时间和地点的潮高、潮汐极值及格点天气数据。
- 永远优先用
__DIR__拼接路径，比如include __DIR__ . '/config/database.php';，这样路径和当前文件位置强绑定，不随chdir()或 CLI 工作目录变化而失效 - 避免裸写
include 'config.php';，它依赖运行时的当前工作目录，Web 和 CLI 下行为可能不一致 - 调试时加一句
echo getcwd(), "\n", __DIR__, "\n";，一眼看清两个关键路径差在哪
include() 和 require() 别混着用，得看错误容忍度
include() 和 require() 本质是同一套机制，唯一实质区别就是出错时的处理方式：include() 报 E_WARNING，脚本继续跑；require() 报 E_COMPILE_ERROR，立刻中止。这不是“严格/宽松”的风格选择，而是语义差异。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 加载配置、核心类、数据库连接等「缺了就无法运行」的文件，必须用
require()，别让脚本带病执行 - 加载页脚、侧边栏、可选功能模块这类「缺了不影响主流程」的文件，才考虑
include() - 不要因为「想让脚本不死」就滥用
include()，掩盖真实错误反而更难排查
重复包含导致函数重定义，用 _once 系列不是万能解药
include_once() 和 require_once() 的判断依据是「文件路径字符串是否完全相同」，而不是文件内容或逻辑含义。这意味着 include_once 'foo.php' 和 include_once __DIR__ . '/foo.php' 在 PHP 看来是两个不同文件，都会被加载。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 一旦用了
_once，所有地方都必须用统一路径写法，推荐全用__DIR__绝对路径 -
_once不能解决跨目录同名文件冲突，比如lib/A/Config.php和app/B/Config.php同时被require_once，照样会报重定义 - 真正可靠的防重载方案是命名空间 + 自动加载（
spl_autoload_register()），_once只适合小项目快速兜底
include() 内部变量作用域容易引发污染
include() 不是沙盒，被包含文件里的变量会直接注入到当前作用域。如果在函数里 include() 一个定义了 $user 的文件，那这个 $user 就成了该函数的局部变量；如果在全局作用域 include()，那 $user 就成了全局变量——后者极易造成意外覆盖。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 被包含文件尽量只做三件事：定义函数、定义类、返回值（用
return $config;），避免直接声明变量 - 如果必须导出数据，统一用
return，调用方接收为变量：$config = include __DIR__ . '/config.php'; - 别在
include()后面紧跟着unset()清理变量，这治标不治本，且容易漏掉
