require 本身不返回值，真正返回数组的是被引入文件末尾的 return 语句；若未写 return，结果为 1 或 null，而非数组。
require 返回数组的写法必须用 return
PHP 的 require 本身不返回值，它只是加载并执行文件；真正返回数组的是被引入文件末尾的 return 语句。如果没写 return，哪怕文件里定义了数组变量，require 的结果也是 null（或 1，表示成功加载但无返回值）。
常见错误：在配置文件里只写 $config = ['db_host' => 'localhost'];，然后指望 $cfg = require 'config.php'; 能拿到这个数组 —— 实际上 $cfg 是 1，不是数组。
- 配置文件（如
config.php）最后一行必须是return $array; - 不能有输出（如
echo、print、空白行后的换行）、不能有语法错误，否则require会报错或返回失败 - 推荐只做数据声明，不执行逻辑（如不连接数据库、不调用函数），保持纯配置语义
/* config.php */
return [
'db_host' => 'localhost',
'db_port' => 3306,
'debug' => true,
];require 和 require_once 在配置场景下没本质区别
多数情况下用 require_once 更安全，避免重复加载导致“Cannot redeclare”或意外覆盖 —— 但前提是你的配置文件里没有函数/类定义，只有 return 数组。这时候重复 require 不会报错，但第二次执行仍会重新计算（比如含 time() 或 getenv() 的动态值），而 require_once 确保只执行一次。
- 如果配置完全静态（纯字面量），
require和require_once行为一致 - 如果配置含运行时表达式（如
'cache_ttl' => getenv('CACHE_TTL') ?: 3600），用require_once可避免多次求值带来的不一致 - 不要在配置文件里写
__DIR__或__FILE__相关逻辑后直接return，它们的值取决于被谁require，不是配置文件自身路径
require 失败时不会返回数组，而是触发致命错误
require 找不到文件或解析出错时，直接 Fatal error 中断执行，不会返回空数组或 false。想兜底处理，必须改用 include（但它返回 false，且后续代码继续执行，容易埋隐患）。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
立即学习“PHP免费学习笔记（深入）”；
- 生产环境应确保配置文件路径正确、权限可读，不依赖运行时判断是否存在
- 调试时可用
file_exists()+is_readable()提前检查，但别用include替代require来“静默失败” - 错误信息典型如：
PHP Fatal error: require(): Failed opening required 'config.php'，注意看完整路径是否拼错（比如漏了.php后缀）
数组结构嵌套和类型要和使用方预期一致
PHP 不校验配置数组结构，但下游代码（如数据库初始化、路由匹配）往往依赖特定 key 和类型。例如 'port' 写成字符串 '3306' 可能导致 PDO 连接失败，'debug' 写成 'true' 字符串而非布尔值会让条件判断失效。
- 建议在配置文件中显式类型转换，如
(int) getenv('DB_PORT')或filter_var($val, FILTER_VALIDATE_BOOLEAN) - 深层嵌套（如
['database' => ['connections' => [...]]]）没问题，但访问时注意空键检查，避免Notice: Undefined index - 避免在配置中用常量（如
DB_NAME）代替字符串字面量，除非已提前定义；否则require时会报Use of undefined constant
实际用的时候，最常卡住的不是语法，而是忘了最后一行的 return，或者返回了变量但变量没定义、作用域不对。配置文件看着简单，错一个字符就整个崩。
