require_once在入口文件中能防止重复加载配置和类定义，因其兼具缺失报错与避免重载的双重优势，且配合__DIR__使用可确保路径可靠，但需注意其返回值在多次加载时恒为1的副作用。
require_once在入口文件里能防止重复加载配置和类定义
PHP入口文件（比如index.php）通常会集中加载框架核心、配置、自动加载器、路由等关键逻辑。如果这些文件被多次引入，轻则变量/函数重定义报错，重则配置覆盖、类加载冲突、数据库连接重复初始化。用require_once是第一道防线。
- 例如
config.php里定义了$db_config，若被两次require，第二次会触发“Cannot redeclare”或静默覆盖值 - 自动加载器（如
autoload.php）注册spl_autoload_register()，重复注册会导致同一类被尝试加载多次，甚至抛出Fatal error: Cannot declare class -
require_once内部会维护一个已加载文件哈希表，每次调用前查表，命中就跳过——这个开销远小于重复解析和执行文件本身
为什么不用include_once或require？
入口文件对稳定性要求极高，不能容忍“文件不存在却继续执行”的情况。include_once遇到路径错误只发E_WARNING，脚本照常往下跑，可能直到后续某处才因class not found崩溃，排查困难；而require虽能中止，但若入口中多处加载同一文件（比如多个模块都直接require 'common.php'），就会直接报错退出。
-
require→ 文件缺失 =Fatal error+ 中止，安全但不防重载 -
include_once→ 文件缺失 =Warning+ 继续，防重载但不保关键依赖 -
require_once→ 兼具两者：缺失即致命，存在则只加载一次
绝对路径比相对路径更可靠
入口文件常被不同路径的脚本（如 CLI 命令、子目录下的 API 路由）通过require链式调用，此时getcwd()可能变化，相对路径极易失效。硬编码绝对路径又不利于部署迁移。
- 正确做法是用
__DIR__或dirname(__FILE__)动态拼接：require_once __DIR__ . '/bootstrap.php'; - 避免写成
require_once './bootstrap.php'或require_once 'bootstrap.php'——前者跳过include_path但依赖当前工作目录，后者依赖include_path顺序，查找次数多且不可控 - PHP 5.3+ 支持
__DIR__，比dirname(__FILE__)更简洁，也更明确表示“当前文件所在目录”
require_once返回值容易被忽略的副作用
require_once成功时返回1，失败时无返回（脚本已终止）。但如果把它赋值给变量，第二次加载会得到1而非文件实际返回值，这在需要捕获文件返回值的场景下很危险。
立即学习“PHP免费学习笔记（深入）”；
- 比如
settings.php末尾有return ['debug' => true];，第一次$cfg = require_once 'settings.php';得到数组，第二次得到1 - 入口文件一般不依赖这类返回值，但若封装了配置加载函数，需显式判断
is_array($cfg)或改用include_once并自行处理错误 - 更稳妥的做法是：入口中只用
require_once加载无返回值的启动脚本；有返回值的配置文件，改用include并配合file_exists()校验
