PHP先include再require_once会怎样-php教程-PHP中文网

include 和 require_once 混用同一文件会触发“cannot redeclare”错误，因 include 不参与_once缓存机制，require_once 无法识别此前 include 加载过的文件。

php先include再require_once会怎样

只要 include 进来的文件里定义了函数、类或常量，后续再用 require_once 包含同一个文件，PHP 就会触发致命错误——因为 require_once 的“已加载检查”只针对它自己和其它 *_once 调用，include 完全不参与这个检查机制。

常见错误信息是：Fatal error: Cannot redeclare xxx() (previously declared in ...) 或 Cannot declare class YYY。

include 每次都无条件加载并执行，不管是否重复
require_once 内部维护一个已加载文件的哈希表，但只记录它自己或 include_once 加载过的路径（按 realpath() 归一化）
哪怕两次写的是同一字符串路径（如 'lib/helper.php'），只要前面用 include 加载过，require_once 仍会二次加载、二次执行

require_once 和 include_once 使用同一套内部缓存，但 include 和 require 完全绕过这套机制。也就是说：

include_once 'a.php'; require_once 'a.php'; → 安全，第二次被跳过
include 'a.php'; require_once 'a.php'; → 危险，第二次仍执行，导致重定义
require 'a.php'; include_once 'a.php'; → 同样危险，include_once 不知道 require 已经干过这事

这个行为不是 bug，是 PHP 引擎设计使然：*_once 只保证“自己人不重复”，不负责跨语句类型去协调。

访问全球海洋潮汐模型。功能包括查询指定日期、时间和地点的潮高、潮汐极值及格点天气数据。

下载

有人以为换成绝对路径就能让 require_once “认出”之前 include 过的文件，其实不一定：

如果 include 用的是相对路径（如 include 'config.php'），而 require_once 用的是 require_once __DIR__ . '/config.php'，PHP 内部会算出两个不同的 realpath（尤其在符号链接或 chdir 后），缓存就对不上
即使路径完全一致，include 本身不注册进 once 缓存，所以毫无意义
真正可靠的解法是统一使用 include_once 或 require_once，而不是混用

这类问题多出现在动态加载逻辑里，比如框架自动扫描插件目录时用 include，而插件内部又习惯性写 require_once 'vendor/autoload.php' ——结果 autoload.php 被执行两遍，PSR-4 映射冲突、类加载器重复注册。

不要在自动加载器（spl_autoload_register）回调里用 include + 外部再调 require_once
避免在条件分支里用 include，然后在公共初始化段用 require_once 加同一组基础文件
调试时用 get_included_files() 查看当前已包含哪些文件，但它不显示 include_once 是否“生效”，只列路径；想确认 once 是否起效，得加日志或断点看执行次数

核心记住一点：once 机制只在同类语句间有效，混用 include 和 require_once 等于主动放弃防重机制。