PHP获取和检查类名、函数名与方法名的常用内置函数详解

为什么需要动态获取名称？

在实际开发中，尤其是在进行日志记录、调试输出、权限校验或编写通用类库时，我们往往需要知道“当前正在执行的是哪个函数”或“某个依赖的类是否已经加载”。硬编码字符串不仅容易出错且缺乏灵活性，而利用PHP提供的内置函数可以自动捕获上下文信息。

基础：检查元素是否存在

在进行任何操作前，确认目标对象是否存在是防止报错的最佳实践。以下是四个最核心的检查函数：

第1步：检查普通函数是否存在

目的：验证一个全局函数是否已被定义，避免调用未声明函数导致的致命错误。

入口：使用 function_exists() 函数。

参数：传入函数名字符串（不含括号）。

<?php
// 示例：检查 var_dump 函数是否存在
if (function_exists('var_dump')) {
    echo "var_dump 函数可用";
}

第2步：检查类及其方法是否存在

目的：确保类已加载，且特定实例方法可被调用。

入口：使用 class_exists() 和 method_exists()。

重要参数： - class_exists($name, $autoload)：第二个参数默认为true，如果为false则不会触发自动加载。

<?php
class MyTest {
    public function run() {}
}

// 检查类是否存在
if (class_exists('MyTest')) {
    // 进一步检查方法是否存在
    if (method_exists('MyTest', 'run')) {
        echo "MyTest 类拥有 run 方法";
    }
}

第3步：检查可调用结构

目的：当需要传递回调函数（包括静态方法、闭包等）时，is_callable() 比简单的 function_exists 更全面。

场景：常用于配置系统中验证用户输入的回调函数是否合法。

<?php
$func = 'strtoupper';
if (is_callable($func)) {
    echo strtoupper('hello');
}

进阶：获取当前的名称信息

当我们需要知道“我是谁”时，可以使用魔术常量和特定的反射函数。这些通常用于生成动态错误或日志信息。

第4步：使用魔术常量获取定义时的名称

自 PHP 5 起，以下常量返回的是定义时的大小写敏感的名称，非常适合用于日志追踪：

• __FUNCTION__：返回当前所在函数的名称。
• __CLASS__：返回当前所在类的完整名称。
• __METHOD__：返回当前类的方法全称（例如：ClassName::methodName）。

注意：这些常量前后均有双下划线。

<?php
class Logger {
    public function logInfo() {
        echo sprintf(
            "日志 [%s] : 正在执行 %s\n",
            __CLASS__,
            __METHOD__
        );
    }
}

$obj = new Logger();
$obj->logInfo();
// 输出: 日志 [Logger] : 正在执行 Logger::logInfo

第5步：运行时动态获取类与方法集合

目的：获取某种类的所有属性、方法，用于反射分析或自动生成文档。

入口：使用 get_class 系列函数。

动作与结果：

• get_class($object)：返回给定对象的类名。
• get_class_methods($object_or_class)：返回指定类的所有方法名数组。
• get_class_vars($class_name)：返回指定类的公共属性名数组。

<?php
class SampleClass {
    public $prop1 = 'value1';
    protected $prop2 = 'value2';
    private $prop3 = 'value3';

    public function funcA() {}
    public function funcB() {}
}

$methods = get_class_methods('SampleClass');
print_r($methods);
// 输出包含 ['funcA', 'funcB']

$vars = get_class_vars('SampleClass');
print_r($vars);
// 仅包含 public 属性

总结与注意事项

掌握这些内置函数能让你的PHP代码更具弹性。在使用时请注意：

1. 性能开销：反射类函数（如get_class_methods）相比直接调用有一定性能损耗，不要在高频率循环中使用。
2. 可见性限制：get_class_vars 等函数通常只返回 public 成员，如需获取私有/受保护成员，建议使用ReflectionClass扩展功能。
3. 自动加载：检查类是否存在时，注意 class_exists 可能触发的自动加载副作用，如有必要请设置第二个参数为 false。