include将文件内容原样插入当前作用域，变量和函数定义遵循所在作用域规则；重复包含会导致重定义错误；推荐用return方式获取配置以规避作用域污染。
include 会把代码原样塞进当前作用域
PHP 的 include 不是“调用”，也不是“导入模块”，它只是把目标文件的内容复制粘贴到执行位置。这意味着：变量、函数定义、类声明，全部按字面意义混入当前作用域。
常见错误现象：include 同一个定义函数的文件两次，直接报 Fatal error: Cannot redeclare my_func()；或者在函数内部 include 一个带 $tmp = 123; 的文件，结果 $tmp 在函数里生效，但外面访问不到——因为函数有自己的局部作用域，而 include 的变量遵循该作用域规则。
- 函数体内
include→ 所有变量/函数定义都落在该函数作用域（局部） - 全局作用域
include→ 所有内容进入全局作用域 -
include的文件里再include，嵌套层级不改变作用域归属逻辑
函数内定义的函数不会自动提升到全局
如果在函数 A 里写 function helper() { }，再执行 include 'file.php'，而 file.php 里也定义了 function helper() { }，那第二次定义仍会触发重定义错误——哪怕它出现在另一个函数体内。因为 PHP 解析时已将函数声明“注册”进符号表，和声明位置是否在函数内无关（只要执行到了）。
使用场景：想动态加载辅助函数？别指望靠“只在需要时 include”来规避冲突。更稳妥的做法是加一层存在性检查：
立即学习“PHP免费学习笔记（深入）”；
if (!function_exists('my_util')) {
include 'util.php';
}
注意：function_exists() 检查的是当前作用域可见的函数，包括全局和已执行过的嵌套定义。
require_once 和 include_once 不解决作用域混淆
require_once 只保证文件最多加载一次，但它不隔离作用域。很多人误以为用了 _once 就能放心在多个地方 include 同一个函数库，结果发现变量意外覆盖、常量重复定义、甚至 class_exists() 返回 true 却 new 失败——原因往往是：第一次 include 在全局，第二次在函数里，类定义进了局部作用域，导致后续全局 new 找不到。
参数差异：没有参数可调。它的行为完全由文件路径字符串决定（路径需完全一致才判为“同一文件”），注意 Windows 大小写不敏感、Linux 敏感，软链接处理也可能导致 _once 失效。
- 绝对路径比相对路径更可靠（避免因
getcwd()变化导致重复加载） - 不要依赖
_once来“保护”变量赋值，它不阻止多次执行赋值语句 - 类/接口/trait 的定义一旦发生作用域错位，
new或extends会直接失败，错误信息往往不提示作用域问题
替代方案：用 return 从 include 获取值，主动控制作用域
这是最被低估也最实用的技巧：include 的返回值就是被包含文件中最后一个表达式的值。你可以让 config.php 写成 <?php return ['db_host' => 'localhost']; ?>，然后在任何地方安全地 $cfg = include 'config.php'; —— 它不会污染当前作用域，也不会引发重定义。
性能影响几乎为零，兼容性从 PHP 4.0.1 就支持，且天然规避所有作用域陷阱。
- 返回数组、对象、闭包均可，但不能返回
void（否则值为null） - 文件中除
return外不应有输出或副作用语句（如echo、define()），否则行为不可控 - 若需同时加载多个配置，建议统一用此模式，避免混用
include和return include
真正难处理的从来不是语法，而是人习惯性把 include 当成“黑盒加载器”，却忘了它连换行符都照单全收。作用域不是抽象概念，是每一行代码实际落脚的位置。
