PHP 怎么Hook原生函数

本文目录导读：

1. 命名空间覆盖（最常用）
2. uopz 扩展（专业 Hook 工具）
3. runkit7 扩展（PHP 7+ 兼容）
4. 使用 Facade/代理模式（面向对象方式）
5. 使用 Composer 包进行自动加载覆盖
6. 实际应用场景

在 PHP 中“Hook 原生函数”通常指拦截或修改 PHP 内置函数（如 file_get_contents、strlen 等）的行为，PHP 本身没有像 JavaScript 那样的原生函数覆盖机制，但有几种常见的实现方式，我为你详细介绍：

命名空间覆盖（最常用）

利用 PHP 的命名空间解析规则：当在命名空间内调用未限定类名的函数时，会先在当前命名空间查找，找不到才去全局查找。

<?php
// 在命名空间内定义同名函数
namespace MyNamespace;
function file_get_contents($filename) {
    // 调用真正的原版函数（加反斜杠）
    $data = \file_get_contents($filename);
    echo "文件读取: " . $filename . "\n";
    return $data;
}
// 使用时
echo file_get_contents('/etc/hostname');  // 会调用我们的版本
echo \file_get_contents('/etc/hostname'); // 调用原版

局限性：只能在定义覆盖函数的命名空间内生效，其他命名空间不受影响。

uopz 扩展（专业 Hook 工具）

uopz 是专门用于操作 PHP 内部函数的扩展：

<?php
// 安装: pecl install uopz
// 1. 重命名原函数
uopz_rename('strlen', 'original_strlen');
// 2. 定义新函数
uopz_function('strlen', function($str) {
    echo "被 Hook 的 strlen 调用\n";
    return original_strlen($str);
});
// 3. 测试
echo strlen("hello"); // 输出："被 Hook 的 strlen 调用" 和 5
// 恢复原函数
uopz_unset_return('strlen');

高级用法 - 修改返回值：

<?php
uopz_set_return('time', 1000000000);
echo time(); // 输出 1000000000
uopz_set_return('strlen', 999);
echo strlen("abc"); // 输出 999
// 带回调
uopz_set_return('date', function($format) {
    return "自定义日期: " . date($format);
});
echo date('Y-m-d');

runkit7 扩展（PHP 7+ 兼容）

<?php
// 安装: pecl install runkit7
// 覆盖函数
runkit7_function_rename('strlen', 'original_strlen');
runkit7_function_add('strlen', '$str', 'return "Custom: " . original_strlen($str);');
echo strlen("test"); // 输出 "Custom: 4"
// 移除覆盖
runkit7_function_remove('strlen');
runkit7_function_rename('original_strlen', 'strlen');

使用 Facade/代理模式（面向对象方式）

创建一个代理类来模拟 Hook：

<?php
class StringHelper {
    private static $original = [];
    public static function hook($func, $callback) {
        self::$original[$func] = $callback;
    }
    public static function __callStatic($name, $args) {
        if (isset(self::$original[$name])) {
            return call_user_func_array(self::$original[$name], $args);
        }
        // 默认为原生调用
        return call_user_func_array($name, $args);
    }
}
// 使用
StringHelper::hook('strlen', function($str) {
    return "自定义长度: " . \strlen($str);
});
echo StringHelper::strlen("hello"); // 输出 "自定义长度: 5"

使用 Composer 包进行自动加载覆盖

创建自定义 Autoload 来实现全局覆盖：

<?php
// composer.json 中的 autoload 配置
{
    "autoload": {
        "files": ["src/hooks.php"]
    }
}
// src/hooks.php
namespace Global\Hooks;
// 使用 PHP 预加载 (preload) 功能
if (PHP_VERSION_ID >= 70400) {
    // 通过 preload.php 实现
    opcache_compile_file(__DIR__ . '/original_functions.php');
}

实际应用场景

• 性能监控：Hook file_get_contents、DB 查询 函数统计耗时
• 安全审计：拦截敏感操作如 eval()、exec()
• 测试 Mock：在单元测试中替换外部服务调用
• 框架集成：在 Laravel 中通过 Container::instance() 替换服务

注意事项：

• 生产环境谨慎使用,可能导致性能损耗
• 命名空间覆盖在 PHP 8+ 中行为可能有变化
• 安全软件可能会检测到函数被修改

根据你的具体需求选择合适的方案,如果只是做局部修改，推荐命名空间方式；做全局监控推荐 uopz 扩展。