require_once报错“failed to open stream”是因文件路径错误导致找不到文件，而非语法问题；相对路径始终以执行脚本目录为基准，需用__dir__与realpath()组合构建可靠绝对路径，并严格校验大小写及扩展名。
require_once 报错“failed to open stream”说明文件根本没被找到
这不是语法错误，而是 PHP 在文件系统里翻箱倒柜也没找到你写的那个路径。它连文件是否存在都确认不了，更别说执行了。报错里那句 Failed opening required './Users/yp/Sites/test' 就是铁证——PHP 把你给的路径当真了，但那里要么是目录、要么压根不存在、要么名字拼错了。
相对路径在 require_once 里永远相对于当前执行脚本，不是写它的那个文件
这是最常踩的坑。比如你在 user.class.php 里写了 require_once("../config/db.php")，然后在 index.php 里 require_once("class/user.class.php")。看起来很合理？错。PHP 执行到 index.php 时，所有 require_once 的相对路径，都是以 index.php 所在目录为起点算的，不是 user.class.php 的位置。
- 如果
index.php在网站根目录，而db.php在/config/db.php，那user.class.php里的"../config/db.php"实际查的是/config/db.php（没错，碰巧对了） - 但如果
index.php在/admin/index.php，那同一行代码就会去查/admin/../config/db.php→/config/db.php，还是对的 - 可一旦
index.php在/api/v1/index.php，"../config/db.php"就变成/api/config/db.php，必然失败
用 realpath() + __DIR__ 组合能避开大部分路径陷阱
硬写绝对路径不现实，但靠 __DIR__（当前文件所在目录）加 realpath() 就稳得多。它把相对路径转成真实存在的绝对路径，再传给 require_once，基本不会迷路。
例如，在 user.class.php 里要加载同级目录下的 db.php：
$dbPath = realpath(__DIR__ . '/../config/db.php');
if (!$dbPath) {
die('db.php not found');
}
require_once($dbPath);
注意：realpath() 返回 false 表示路径无效，必须检查；__DIR__ 结尾不含斜杠，拼接时要手动加 / 或 .。
大小写敏感和文件扩展名漏写是静默杀手
Linux 服务器上，require_once('UploadHandler.php') 和实际文件名 uploadhandler.php 完全不匹配，PHP 就当它不存在。Windows 开发机上跑得好好的，一上生产环境就崩，就是这个原因。
- 检查报错信息里写的文件名，和你文件管理器里看到的**逐字母比对**，尤其首字母大小写
- 确认扩展名：是
.php还是.inc？少写一个p就找不到 - 用
ls -la（Linux/macOS）或dir（Windows）直接看目标目录下到底有什么文件
路径问题从来不是“差不多就行”的事，差一个点、一个斜杠、一个字母，就彻底断掉。别猜，直接用 file_exists() 或 realpath() 验证，比反复改路径快得多。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
