如何在PHP7中正确引入其他类文件

在PHP项目开发中，引入其他类文件是个基础操作，但做不对的人真不少。特别到了PHP7时代，很多老习惯该改一改了。下面直接从几个核心问题入手，把这件事彻底说清楚。

PHP7中require和include还能用吗？

能用，但别直接裸写路径就完事了。PHP7本身没有废除这两个语句，可硬编码路径（比如require './lib/Database.php';）在小项目里还能应付，项目稍微大一点就容易出问题——路径拼错、Linux下大小写敏感、相对路径基准混乱，随便一个都能触发Fatal error: require(): Failed opening required。

真正正确的做法是统一入口，搭配合理的目录结构，用__DIR__来锚定位置：

• __DIR__永远返回当前文件所在目录的绝对路径，比dirname(__FILE__)更简洁，也更安全。
• 避免用.或..拼接路径，改用__DIR__ . '/../src/Helper.php'这种写法。
• 如果类文件包含命名空间，光require还不够，还得配合use或者全限定名来调用。

为什么autoloader是PHP7项目的标配？

手动require几十个类文件，既重复、又容易漏掉。PHP7的spl_autoload_register()机制正好解决这个问题——按需加载，类名一出现，系统自动去找对应的文件，不用提前写一堆require。

给你一个最小可用的示例：

// 在入口文件（如 index.php）中注册
spl_autoload_register(function ($class_name) {
    $file = __DIR__ . '/src/' . str_replace('\\', '/', $class_name) . '.php';
    if (file_exists($file)) {
        require $file;
    }
});

这里有几点需要特别留意：

• 命名空间分隔符\一定要替换成/，否则路径会出错（Windows下也建议统一用/）。
• 确保$file路径真实存在，否则会静默失败——加个file_exists()判断，比让PHP直接报Class not found更容易定位问题。
• 不要在spl_autoload_register()里抛异常，它的职责只负责加载，不负责验证类是否被正确定义。

Composer autoload配置怎么写才不踩坑？

如果你在用Composer，就别手写autoload逻辑了。它的composer.json已经提供了成熟方案，但配错的人不在少数：

• "psr-4"映射必须以\\结尾（比如"App\\": "src/"），少一个反斜杠会导致类名解析错位。
• 目录路径是相对于composer.json位置的，不是相对于webroot或入口文件。
• 改完composer.json后必须运行composer dump-autoload，否则新规则不会生效。
• 如果类文件名和类名不严格匹配（比如MyHelper.php里定义了class MyHelper），PSR-4就失效了。这时候要么切换回"classmap"，要么手动require。

PHP7里require_once还有必要吗？

有必要，但应用场景已经非常窄了。PHP7的opcode缓存（OPcache）虽然能让多次require变快，但无法防止重复定义类——Fatal error: Cannot declare class XXX, because the name is already in use这个错误依然会冷不丁地出现。

所以说：

• 配置文件、函数库这类无类定义的脚本，用require_once防止重复加载是合理的。
• 类文件优先走autoloader，而不是靠require_once来兜底——后者往往会掩盖设计上的缺陷。
• 测试时临时引入某个类，可以用require_once快速验证，但上线前一定要移入autoload体系。

最容易被忽略的一点是：autoloader函数里千万不要用require_once。它和spl_autoload_register的语义是冲突的——loader的本意就是“保证只加载一次”，再套一层_once反而会干扰调试，排查问题时让人摸不着头脑。