require_once 是确保PHP文件在整个请求中只被加载执行一次的语句，它在require基础上增加去重逻辑，防止函数/类重复声明错误，推荐用于含声明的文件，路径应使用__DIR__拼接以避免解析错误。

require_once 是什么，为什么不能只用 require

require_once 的核心作用是：**确保一个 PHP 文件在整个请求生命周期中只被加载并执行一次**。它和 require 行为一致（出错时致命报错、立即执行），但多了“去重”逻辑——PHP 会记录已包含的文件路径，再次遇到相同路径时直接跳过。

初学者常误以为 require 也能防重复，但实际不是：如果两个不同文件都 require 同一个 config.php，而该文件里定义了函数或类，就会触发 Fatal error: Cannot redeclare function_name()。

• 只在需要“绝对不重复加载”的场景用 require_once，比如含 function、class、const 声明的文件
• 纯执行型配置文件（如只设 $db_host = 'localhost';）理论上可用 require，但保险起见仍推荐 require_once
• 性能上，require_once 比 require 略慢（需查内部文件列表），但对现代 PHP 影响微乎其微，别为此妥协可维护性

require_once 的路径解析容易踩哪些坑

路径写错是初学者最常遇到的失败原因，错误现象通常是：Warning: require_once(): Failed opening required 'xxx' 或静默失效（因路径未匹配，PHP 认为是“另一个文件”）。

• 相对路径基于 当前正在执行的脚本，不是 require_once 所在文件。例如 include/a.php 里写 require_once 'config.php'，PHP 会去找 include/config.php，而非项目根目录下的 config.php
• 避免裸字符串路径，优先用 __DIR__ . '/path/to/file.php' —— __DIR__ 返回当前文件所在目录的绝对路径，稳定可靠
• 不要混用斜杠：__DIR__ . '/lib/helper.php' 正确；__DIR__ . '\lib\helper.php' 在 Linux 下会失败

require_once 和 autoloader 冲突吗

不冲突，但有明确分工：require_once 是手动加载，autoloader（如 Composer 的 autoload.php）是按需自动加载类。两者共存很常见，但要注意顺序和职责。

linux-performance-analyzer

Linux 性能分析与调优专家，覆盖 CPU、内存、磁盘 I/O、网络、内核参数、编译优化、容器/K8s。适用场景：系统卡顿/高负载、内存不足/OOM/Swap 高、CPU 异常/iowait 高。

下载

立即学习“PHP免费学习笔记（深入）”；

• 必须先 require_once 引入 autoloader（如 require_once __DIR__ . '/vendor/autoload.php';），再 new 类，否则类找不到
• 不要对已由 autoloader 管理的类文件再用 require_once —— 多余且可能破坏命名空间逻辑
• 工具类、函数库（非 class 定义）仍需 require_once，autoloader 不处理它们

一个典型安全用法示例

以下结构能避免重复、路径错、声明冲突三类问题：

/* index.php */
<?php
// 正确：用 __DIR__ 锚定路径，且只引入一次
require_once __DIR__ . '/config.php';
require_once __DIR__ . '/helpers/functions.php';
require_once __DIR__ . '/vendor/autoload.php';
<p>// 此后可安全使用 config 中的常量、functions.php 中的函数、以及 composer 包里的类
echo DB_HOST;
my_helper_function();
new GuzzleHttp\Client();

真正复杂的地方不在语法，而在理解「谁在什么时候加载了什么」——尤其是当项目引入多个第三方包、自定义库、测试引导文件时，require_once 的路径和顺序一旦错位，错误信息往往不直接指向根源。多打几次 var_dump(get_included_files()); 能帮你快速看清实际加载链。