require报错白屏是因为触发fatal error且错误被屏蔽；它强制加载失败则中止脚本，而include仅警告；常见原因包括文件缺失、路径错误、open_basedir限制及display_errors=off等配置。
require 报错直接白屏，是因为它触发了 Fatal error
require 和 include 的核心区别就在这里：require 是“必须加载成功”，一旦失败（比如文件不存在、权限不足、路径错误），PHP 立即抛出 Fatal error 并中止整个脚本执行。浏览器收不到任何输出，页面就是纯白。
而 include 只报 Warning，脚本还能往下走——哪怕后续逻辑崩了，至少可能输出点 HTML 或错误提示。
- 常见触发场景：
require 'config.php';中的config.php被误删、改名、或路径写成Config.php（Linux 下大小写敏感） - 更隐蔽的情况：文件存在，但被
open_basedir拦截，报错是require(): open_basedir restriction in effect—— 这类错误默认也不显示，直接白屏 - 注意：
require_once同样属于“强制加载”，行为和require一致，只是多了一层已加载检查
为什么你根本看不到错误信息？
不是没报错，而是 PHP 默认把致命错误也给藏起来了。关键配置有三个：
-
display_errors = Off（php.ini）：这是最常见原因，错误被屏蔽，不输出到页面 -
error_reporting = 0或error_reporting(0)（代码里）：比 php.ini 优先级更高，入口文件如index.php开头就写了这句，直接关死所有提示 -
@require(...)：错误抑制符@会吞掉所有错误，连日志都不记，只剩白屏
只要其中任一条件成立，Fatal error 就不会出现在浏览器里，你只能靠查日志或手动开提示。
快速定位 require 白屏的三步操作
别猜，直接动手验证：
- 第一步：在出问题的 PHP 文件最开头加两行：
error_reporting(E_ALL); ini_set('display_errors', '1');确保它在任何require之前执行 - 第二步：检查 PHP 错误日志路径，用命令看实时错误：
tail -f /var/log/php_errors.log（路径以phpinfo()输出的error_log值为准） - 第三步：如果日志里出现
open_basedir相关报错，立刻检查php.ini或 Web 服务器配置里的open_basedir值，确保它包含你要require的文件所在目录（比如从/var/www/html/public/改成/var/www/html/）
require 路径写法不当，白屏风险极高
相对路径是白屏高频诱因，尤其在 CLI 和 Web 环境混用时：
-
require 'lib/utils.php';依赖当前工作目录（cwd），而 Apache/Nginx 和命令行的 cwd 往往不同 - 正确做法是锚定到文件自身位置：
require __DIR__ . '/lib/utils.php';——__DIR__永远返回当前文件所在目录，不随执行环境变化 - 避免用
$_SERVER['DOCUMENT_ROOT']拼路径，它可能为空或不可靠；也别依赖include_path，除非你明确维护过它
白屏真正难缠的地方，往往不在 require 本身，而在它加载的文件里又嵌套了另一个 require —— 错误层层下沉，不打开日志根本找不到源头。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
