require失败会终止脚本执行，include仅警告并继续运行；关键配置用require确保加载，可选模块用include实现容错；路径必须用__DIR__构造绝对路径避免漂移。
require 和 include 的错误行为差异最直接影响你调试体验
初学者最容易卡在“为什么脚本突然不输出了？”——往往就是把 include 写成 require，又恰好引入了一个拼错路径的文件。结果不是报错提示，而是整个页面空白：require 触发的是 E_COMPILE_ERROR，PHP 直接终止，连 echo 都没机会执行；而 include 只报 E_WARNING，比如：
include 'config.php'; echo "我还在运行";
哪怕 config.php 不存在，你仍能看到这行输出（只是浏览器或日志里多一条警告）。反过来：
require 'config.php'; echo "这行永远不会出现";
一旦失败，后续所有代码全部失效。
- 开发时想快速验证某段逻辑是否跑通？优先用
include，避免因一个模板缺失导致整页挂掉 - 上线前必须确保关键配置加载成功？必须用
require，让问题在启动阶段暴露，而不是藏在某个分支里悄悄出错 - 注意：PHP 8+ 默认关闭警告显示，
include失败可能“静默”发生，务必检查错误日志或开启error_reporting(E_ALL)
什么时候该用 _once 版本？不是“用了更安全”，而是“不用就崩”
当你定义函数、类或常量时，重复包含同一文件会直接触发致命错误：Cannot redeclare my_function()。这时候 include_once 和 require_once 不是可选项，是必需项。
立即学习“PHP免费学习笔记（深入）”；
但要注意一个常见误区：很多人以为只要加了 _once 就万事大吉，其实 PHP 是按“文件路径字符串”做去重判断的。下面两行会被视为不同文件：
require_once 'helper.php'; require_once './helper.php';
即使它们指向同一个物理文件，PHP 也会重复加载并报错。所以实操中：
- 统一用
__DIR__构建绝对路径：require_once __DIR__ . '/lib/database.php'; - 避免混用相对路径、点号路径、斜杠方向不一致写法
-
require_once比include_once更常用——因为核心类库/配置几乎从不“可选”，缺了就得停
别被“编译时 vs 运行时”说法带偏，真正影响你的是加载时机和条件判断能力
网上常说 require 在“编译时”包含、include 在“运行时”包含，这个说法容易误导。实际上两者都在运行期解析，区别在于：include 支持作为表达式使用，并能返回布尔值；require 不能。
这意味着你可以这样写：
if ($debug_mode) {
include 'debug_toolbar.php';
}
但下面这段语法合法，却毫无意义（require 没有返回值，无法参与判断）：
if (require 'auth.php') { // ❌ 无效写法，require 不返回布尔值
start_session();
}
- 需要动态加载（如按角色加载不同工具）、或容错降级（加载失败就跳过某模块）？只能用
include - 想在 if 分支里引入关键校验逻辑？不行——
require必须放在顶层作用域，否则会报 Parse error - 性能上差异极小，OPcache 启用后基本无差别，不必为此纠结
路径写错是新手最高频问题，绝对路径才是稳解
相对路径依赖当前工作目录（getcwd()），而它可能被 chdir()、框架路由、CLI 调用等随意改变。一个 include 'config.php' 在本地测试好好的，部署到 Nginx + FastCGI 环境就报错，大概率是路径漂移。
正确做法只有一条：所有包含语句都基于 __DIR__ 或 dirname(__FILE__) 构造绝对路径：
require __DIR__ . '/../config/database.php'; include __DIR__ . '/templates/header.php';
- 永远不要写
include '../config.php'或include 'inc/functions.php' - 项目根目录建议定义一个常量，比如
define('ROOT', __DIR__);，后续统一用require ROOT . '/config.php'; - 如果真要用
include_path，请确认 php.ini 中已设置且未被框架覆盖——对新手来说，这条路太绕，不推荐
最关键的其实是习惯：看到 require 就立刻问自己“这个文件要是没了，整个功能还成立吗？”；看到 include 就检查“它失败了，会不会让页面部分区域空白却不报错？”。这两句话比任何语法总结都管用。
