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）是按需自动加载类。两者共存很常见，但要注意顺序和职责。
UQCMS云商是一款B2B2C电子商务软件 ，非常适合初创的创业者，个人及中小型企业。程序采用PHP+MYSQL,模板采用smarty模板，二次开发，简单方便，无需学习其他框架就可以自行模板设计。永久免费使用，操作简单，安全稳定。支持PC+WAP+微信三种浏览方式，支持微信公众号。
立即学习“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()); 能帮你快速看清实际加载链。
