1. 打印绝对路径：
   var_dump(realpath(__DIR__ . '/your-file.php'));
   若返回 false，说明文件根本不在你以为的位置。

2. 确认运行身份：
   echo exec('whoami');
   看当前系统用户是否有读权限。

3. 排查隐藏语法错误：
   某些文件不是“不存在”，而是语法错误导致加载失败。
   用命令行执行：php -l filename.php。

4. 检查 PHP 开始标签：
   文件应以 <?php 开头。若短标签关闭而你写了 <?，后续可能出现各种诡异问题（如 header 已发送）。

更专业的加载封装示例

不要长期依赖裸 var_dump。建议用结构化日志和统一包装。

<?php
/**
 * 带可观测性的文件加载器
 * 开发环境要“响亮失败”，生产环境可控降级。
 */
function load_component(string $filePath, array $context = []): mixed
{
    $absolutePath = realpath($filePath);
    if (!$absolutePath || !file_exists($absolutePath)) {
        error_log(sprintf(
            "[FileLoader] Failure: %s | CWD: %s | User: %s",
            $filePath,
            getcwd(),
            get_current_user()
        ));

        if (getenv('APP_DEBUG') === 'true') {
            throw new \Exception("组件不存在: {$filePath}");
        }

        return null; // 生产环境按约定降级
    }

    extract($context);
    return require $absolutePath;
}

常见问题

Q：require_once 一定比 require 更好吗？

不一定。require_once 更像是组织不清晰时的安全网。依赖关系明确、自动加载健全时，require 更直接、性能更好。

Q：可以根据数据库值动态 include 文件吗？

可以，但必须非常谨慎。推荐白名单映射：数据库只存 ID，代码里把 ID 映射到固定路径，不要把路径原文存进数据库后直接加载。

Q：加载大文件会拖慢应用吗？

开启 OPcache 后，首次之后基本没有“解析”成本；但文件中的业务逻辑仍要执行，依旧消耗 CPU 和内存。文件内容要聚焦，避免把大量无关逻辑塞在一起。

Q：模板文件适合用 include 吗？

小项目可以。中大型系统建议使用成熟模板方案，能在安全性和复用性上更稳。

结语

把 include 和 require 用好，不只是语法问题，而是工程能力问题。

你的代码运行在操作系统、权限模型、缓存机制和部署流水线共同构成的环境里。只理解“本地能跑”，远远不够。

最佳实践小结