include语句无报错但变量/函数不可用，通常因被包含文件执行失败（语法错误、PHP版本不兼容）或被include_once/require_once跳过；更隐蔽的是作用域问题（如在函数内include导致变量仅限局部作用域）。
include 语句没报错但变量/函数不可用
这通常不是路径没找到，而是文件被包含但执行失败（比如语法错误、PHP 版本不兼容），或被 include_once/require_once 重复跳过。更隐蔽的情况是：文件确实加载了，但里面定义的变量作用域仅限于包含语句所在的局部作用域（尤其在函数内 include 时）。
验证是否真“生效”：
- 在被包含文件开头加 echo "loaded\n"; exit;，看是否输出；
- 检查目标文件是否有 ?><?php 混用、BOM 头、短标签（）未开启等导致解析中断；
- 若在函数中 include，其内部定义的变量默认不会自动导入到函数外，需显式 global 或返回值传递。
include_path 设置了却还是找不到文件
PHP 只在传入**纯文件名**（如 'config.php'）时才按 include_path 搜索；一旦路径含 ./、../ 或 /，就跳过 include_path，直接解析该路径。
常见误操作：
- 写成 include './lib/db.php'; → 强制从当前工作目录找，无视 include_path；
- 写成 include 'lib/db.php'; → 才会依次查找 include_path 中的每个目录；
- set_include_path() 必须在 include 前调用，且不能被后续代码覆盖；
- 用 var_dump(get_include_path()); 确认生效值，注意 . 表示当前工作目录（getcwd()），不是当前文件目录（__DIR__）。
用 __DIR__ 拼接绝对路径仍失败
__DIR__ 是最可靠的锚点，但拼接后路径可能因以下原因失效：
- 路径字符串里混入空格或全角字符（如中文顿号、空格），导致实际路径与预期不符；
- 斜杠方向错误：Windows 下写 __DIR__ . '\config.php' 可能出问题，统一用 /（PHP 兼容）；
- 上级目录回溯越界：如 __DIR__ . '/../config.php' 在项目根目录时会变成 /config.php，但该文件未必存在；
- 文件权限不足：即使路径对，PHP 进程用户（如 www-data）对目标文件无读权限（chmod 644）或对中间目录无执行（x）权限（Linux 必需）；
- open_basedir 限制：用 ini_get('open_basedir') 查看，若返回非空，所有路径必须落在该范围内，否则直接拒绝访问。
动态路径拼接时容易忽略的安全与健壮性
用户输入参与路径构造（如 include $_GET['file']）是高危行为，但即使自己拼接，也常漏掉基础校验：
立即学习“PHP免费学习笔记（深入）”；
- 不检查文件是否存在：if (!file_exists($path)) { die("File missing: $path"); }；
- 不用 realpath() 规范路径：防止 ../../../etc/passwd 类绕过（开发期可加，线上应禁用用户可控路径）；
- 忘记处理路径中的 .. 回溯：用 str_starts_with($path, '..') 或白名单过滤；
- 把 include 当 require 用：关键配置文件缺失时，include 只警告继续执行，可能导致后续 fatal error，建议用 require_once。
真正卡住人的，往往不是“怎么写路径”，而是没意识到 __DIR__ 和 getcwd() 根本不是一回事，也没想到 open_basedir 或文件权限会在路径完全正确时突然拦截——这些点不手动验证，光改写法没用。
