realpath()是PHP中将相对路径转为规范化绝对路径的首选函数，它解析符号链接、处理./和../并校验路径存在性，失败时返回false而非抛异常。
用 realpath() 获取绝对路径最可靠
PHP 里把相对路径转成绝对路径，realpath() 是首选——它不只是拼接当前工作目录，还会真实解析符号链接、处理 ../ 和 ./，最后返回规范化的绝对路径。
注意：如果路径不存在或权限不足，realpath() 返回 false，不是抛异常，得手动检查。
- 对不存在的文件/目录，它不会自动创建，只做解析
- 路径中含
~（如~/config.php）不支持，需先替换为$_SERVER['HOME'] - Windows 下返回带盘符的路径（如
C:\project\file.txt），Linux/macOS 返回以/开头的路径 - 若传入空字符串或
null，直接返回false，别忘了判空
$rel = 'data/../config.php';
$abs = realpath($rel);
if ($abs === false) {
throw new RuntimeException("路径无效: {$rel}");
}
// $abs => /var/www/project/config.php（实际路径）
用 __DIR__ 或 dirname(__FILE__) 拼接更可控
当你要基于当前 PHP 文件位置构造路径（比如加载同级或子目录下的配置），硬拼比依赖当前工作目录更安全——因为 getcwd() 可能被 chdir() 改动，而 __DIR__ 总是稳定指向当前文件所在目录。
-
__DIR__是魔术常量，PHP 5.3+ 推荐，比dirname(__FILE__)少一次函数调用 - 拼接时用
DIRECTORY_SEPARATOR更跨平台，但多数情况直接用/也没问题（PHP 内部会自动转换） - 避免写成
__DIR__ . '/../lib'后再丢给realpath()——可以一步到位：realpath(__DIR__ . '/../lib')
// 在 /var/www/app/index.php 中 $configPath = __DIR__ . '/config/database.php'; // 等价于 /var/www/app/config/database.php
为什么不用 getcwd() . '/path'？
很多人第一反应是拼 getcwd()，但它极不可靠：CLI 下执行位置可能在任意目录；Web 服务器（如 Apache 的 mod_php）下 getcwd() 常是文档根目录，但 FPM 模式下可能变成脚本所在目录；Swoole 或协程环境还可能动态切换。
立即学习“PHP免费学习笔记（深入）”；
-
getcwd()返回的是进程当前工作目录，和代码位置无关 - 即使加了
chdir()保护，也挡不住外部调用方的 cwd 变更 - 唯一适合它的场景：你明确要操作「当前命令行所处目录」下的文件（如 CLI 工具读取用户当前目录的
.env）
遇到 realpath(): open_basedir restriction 怎么办
这个错误不是路径写错了，是 PHP 配置限制了可访问的根目录范围。此时 realpath() 直接失败，连 false 都不返回，而是报 Warning 并返回 false。
- 先确认
open_basedir设置（phpinfo()或ini_get('open_basedir')） - 如果路径确实在允许范围内但仍报错，可能是路径包含符号链接且目标超出范围，
realpath()会全程校验每级路径 - 临时绕过方法（仅调试）：
ini_set('open_basedir', '')，但生产环境严禁这么做 - 更稳妥的做法：改用
__DIR__拼接，并确保所有路径都在open_basedir白名单内
路径解析看着简单，但实际踩坑多在环境差异和配置限制上——别默认路径存在，也别假设 cwd 可控，realpath() 加存在性检查，再配合 __DIR__ 定位基准，基本覆盖 95% 场景。
