Safe库是提供命名空间隔离、返回对象或抛出异常的替代函数，需主动调用safe\file_get_contents()等而非自动劫持原生函数；仅支持PHP 7.4+，须按需安装子包如php-safe/file，并显式使用safe\前缀及对应异常类捕获错误。
Safe 库是什么，为什么它不直接替换原生函数
Safe 库不是“自动劫持” fopen、file_get_contents 这类函数的运行时补丁，它提供的是**命名空间隔离的、返回值为对象或抛出异常的替代函数**。你得主动用 safe\file_get_contents() 替代 file_get_contents()，而不是让 PHP 自动重写调用。
安装 Safe 库并确认版本兼容性
Safe 库目前（v1.x）仅支持 PHP 7.4+，且每个子库（如 safe/file）需单独安装。直接 composer require php-safe/safe 会装全部子包，但多数项目只需部分——比如只处理文件操作，就该按需引入：
-
composer require php-safe/file（覆盖fopen、file_get_contents等） -
composer require php-safe/proc（覆盖proc_open、exec等） - 不要装
php-safe/safe元包，它已废弃且与新版冲突
装完后检查 vendor/php-safe/file/src/ 是否存在，确认 autoloader 已注册对应命名空间 safe\。
如何正确调用 Safe 函数并捕获异常
Safe 函数在失败时抛出 Safe\Exceptions\XXXException（如 Safe\Exceptions\FileException），而非返回 false。关键点是：必须显式使用 safe\ 命名空间前缀，且不能依赖全局函数自动降级：
立即学习“PHP免费学习笔记（深入）”；
// ✅ 正确：显式调用 safe 版本，失败抛异常
try {
$content = safe\file_get_contents('/path/to/file');
} catch (Safe\Exceptions\FileException $e) {
// 处理读取失败，$e->getPrevious() 可拿到原生 error
}
常见错误：
- 漏写
safe\前缀，结果调用的仍是原生file_get_contents()，依然返回false - 未声明
use Safe\Exceptions\FileException;，却直接catch (FileException $e)—— 因命名空间不匹配而捕获不到 - 误以为
safe\file_get_contents()会静默转换原生调用，实际它完全不干涉全局函数行为
无法全局替换原生函数，别试图 hack autoloader
有人想通过 Composer 的 autoload.files 或 classmap 强制重定义 file_get_contents，这不可行：
- PHP 不允许运行时重定义已存在的内置函数
- Safe 库本身没提供函数别名机制（如
function file_get_contents() { return safe\file_get_contents(...); }），因为这会破坏可预测性 - 即使借助
uopz扩展强行 hook，也仅限开发环境，生产部署风险极高
真正可行的路径只有两条：一是在新代码中统一用 safe\*；二是用静态分析工具（如 PHPStan + 自定义规则）扫描出所有裸调用，逐步迁移。别指望一键切换。
