require用于关键文件(如config.php),失败则fatal error终止执行;include用于非关键文件(如analytics.php),失败仅warning继续执行;动态路径和条件加载必须用include;require_once/include_once按路径字符串判重,不感知内容变更。

文件加载失败时,require 会直接终止脚本,include 只发 warning 并继续执行——选哪个,取决于“挂了能不能忍”。
require 找不到文件就 Fatal error,后续代码全不执行
这是最直接影响线上行为的点:require 在编译期尝试加载文件,一旦失败(路径错、权限不足、语法错误),立刻抛出 Fatal error,PHP 进程终止,echo、try 块外逻辑、甚至页面 footer 都不会输出。
-
require 'config.php'是合理选择——如果数据库配置都读不到,后面所有业务逻辑都没意义 -
require错误无法被try/catch捕获,因为它是编译期错误,不是运行时异常 - 错误信息里明确带
Failed opening required,比如:Fatal error: require(): Failed opening required 'missing.php'
include 找不到文件只 Warning,脚本照常往下跑
include 是运行期解析,失败只触发 E_WARNING,默认不显示在浏览器(display_errors=Off 时),但会记进错误日志;主流程不受影响。
-
include 'analytics.php'更合适——埋点脚本挂了,不影响用户下单 - Warning 可用
@include 'file.php'抑制,但注意:它压不住文件内部的parse error,那种依然 fatal - 典型错误提示是:
Warning: include(missing.php): failed to open stream
动态路径和条件加载只能用 include
require 是语言结构,在编译阶段就确定要加载什么,不支持变量插值或运行时拼接;include 在运行时才读取路径,更灵活。
- 下面这行会报错(实际尝试加载字面量
file_{$i}.php):require "file_{$i}.php" - 正确写法是:
include "file_{$i}.php",或更安全地先判断:if (file_exists("file_{$i}.php")) { include "file_{$i}.php"; } - 条件分支中也必须用
include:if ($env === 'dev') { include 'debug.php'; }——require虽语法合法,但无法跳过加载
require_once 和 include_once 的“已加载”判断很粗糙
它们都靠 realpath 展开后的字符串路径做哈希比对,不是按文件内容或 inode 判断。这意味着:
-
require_once 'config.php'和require_once __DIR__ . '/config.php'会被当成两个文件,重复加载 - 软链接指向同一文件,但路径不同,也会加载两次
- 改了文件内容,opcode 缓存(如 opcache)不清理,新代码不会生效——开发时记得关
opcache.enable或手动 clear
线上部署后静态环境用 _once 版本防重复定义没问题,但别指望它自动感知文件变更。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











