使用ReflectionClass的getMethods()可获取类的所有方法，结合位掩码筛选特定权限或特性方法，适用于ORM、依赖注入等动态场景。
使用PHP的反射（Reflection）API是获取一个类的所有方法的标准且强大的方式。它允许你在运行时检查类、接口、函数和扩展，包括它们的方法、属性、参数、注释等，就像代码本身在“审视”自己一样。这不仅仅是获取一个方法列表那么简单，它揭示了类内部的结构和行为，为动态编程提供了无限可能。
解决方案
要获取一个PHP类的所有方法，你需要使用
ReflectionClass。这个类提供了对任何给定类的详细信息访问。
首先，实例化
ReflectionClass，传入你想要检查的类名或对象。接着，调用其
getMethods()方法。这个方法会返回一个
ReflectionMethod对象的数组，每个对象都代表类中的一个方法。
getMethods();
echo "类 'MyExampleClass' 的所有方法:\n";
foreach ($methods as $method) {
echo "- " . $method->getName() . " (";
if ($method->isPublic()) {
echo "public";
} elseif ($method->isProtected()) {
echo "protected";
} elseif ($method->isPrivate()) {
echo "private";
}
if ($method->isStatic()) {
echo ", static";
}
if ($method->isAbstract()) {
echo ", abstract";
}
if ($method->isFinal()) {
echo ", final";
}
if ($method->isConstructor()) {
echo ", constructor";
}
echo ")\n";
}
?>运行这段代码，你会看到
MyExampleClass中定义的所有方法，包括它们的可见性（public, protected, private）以及是否为静态方法等信息。
getMethods()默认返回所有可见性的方法，这是它的强大之处。
立即学习“PHP免费学习笔记（深入）”；
反射机制在哪些实际场景中能派上用场？
反射机制在日常开发中可能不是随处可见，但它在构建复杂、灵活的系统时，简直就是一把瑞士军刀。我个人觉得，它最闪光的地方在于那些需要“自省”或者“元编程”的场景。比如，你正在开发一个框架或者一个需要高度可配置的库：
首先，ORM（对象关系映射）框架会大量使用反射。想象一下，你定义了一个User类，ORM需要知道User类有哪些属性，以及这些属性对应数据库的哪个字段，甚至需要知道它们的类型。反射可以帮助ORM在运行时读取这些信息，自动完成数据库到对象的映射，而不需要你手动写大量的配置。
再比如，依赖注入（DI）容器。当容器需要创建一个类的实例时，它会检查这个类的构造函数需要哪些参数。通过反射，容器可以识别出这些参数的类型提示，然后自动从容器中解析并注入相应的依赖。这让代码的耦合度大大降低，测试也更方便。
还有，API文档生成工具。如果你想根据代码自动生成API文档，反射可以遍历你的控制器类，获取所有公共方法（通常代表API端点），并读取它们上面的PHPDoc注释，从而生成详细的API说明。这比手写文档效率高太多了。
甚至在单元测试中，虽然不推荐，但有时为了测试私有或保护方法，反射也提供了一条途径。当然，更好的做法是测试公共接口，但如果确实需要深入到内部，反射能让你突破访问限制。
总的来说，任何需要动态分析代码结构、动态调用方法、或者根据代码结构生成其他代码或配置的场景，反射都是不可或缺的工具。它让你的代码能够理解和操作自身的结构，从而实现更高级别的抽象和自动化。
如何精确地筛选出特定访问权限或特性的类方法？
ReflectionClass的
getMethods()方法非常灵活，它允许你传入一个可选的参数来筛选出特定访问权限或特性的方法。这比获取所有方法后再手动遍历检查要高效和优雅得多。这个参数是一个位掩码（bitmask），你可以通过组合
ReflectionMethod类中定义的常量来实现。
这些常量包括：
ReflectionMethod::IS_PUBLIC
：公共方法ReflectionMethod::IS_PROTECTED
：保护方法ReflectionMethod::IS_PRIVATE
：私有方法ReflectionMethod::IS_STATIC
：静态方法ReflectionMethod::IS_ABSTRACT
：抽象方法ReflectionMethod::IS_FINAL
：最终方法ReflectionMethod::IS_CONSTRUCTOR
：构造函数ReflectionMethod::IS_DESTRUCTOR
：析构函数
你可以使用位或运算符
|来组合这些常量，以筛选出符合多种条件的方法。
getMethods(ReflectionMethod::IS_PUBLIC);
foreach ($publicMethods as $method) {
echo "- " . $method->getName() . "\n";
}
echo "\n只获取静态方法:\n";
$staticMethods = $reflector->getMethods(ReflectionMethod::IS_STATIC);
foreach ($staticMethods as $method) {
echo "- " . $method->getName() . "\n";
}
echo "\n获取公共或保护方法:\n";
$publicProtectedMethods = $reflector->getMethods(ReflectionMethod::IS_PUBLIC | ReflectionMethod::IS_PROTECTED);
foreach ($publicProtectedMethods as $method) {
echo "- " . $method->getName() . "\n";
}
echo "\n获取公共静态方法:\n";
$publicStaticMethods = $reflector->getMethods(ReflectionMethod::IS_PUBLIC | ReflectionMethod::IS_STATIC);
foreach ($publicStaticMethods as $method) {
echo "- " . $method->getName() . "\n";
}
echo "\n获取构造函数:\n";
$constructors = $reflector->getMethods(ReflectionMethod::IS_CONSTRUCTOR);
foreach ($constructors as $method) {
echo "- " . $method->getName() . "\n";
}
?>通过这种方式，你可以非常精确地控制
getMethods()返回的结果集，避免了不必要的循环和条件判断，让代码更简洁，也更符合预期。这对于那些需要处理特定类型方法的工具或框架来说，简直是核心功能。
除了方法名，反射还能提供哪些关于方法的详细信息？
ReflectionMethod对象远不止能告诉你方法的名字和可见性。它是一个包含了方法所有元数据的宝库，可以让你深入了解方法的方方面面。我经常会用它来检查方法的参数、返回类型，甚至方法的具体定义位置。
以下是一些
ReflectionMethod对象能提供的重要信息：
-
方法名 (
getName()
): 这是最基本的，获取方法的字符串名称。 -
声明类 (
getDeclaringClass()
): 返回一个ReflectionClass
对象，代表定义这个方法的类。这在处理继承关系时非常有用，可以知道方法是在哪个类中首次声明的。 -
参数信息 (
getParameters()
): 这是一个非常强大的方法，它返回一个ReflectionParameter
对象的数组。通过遍历这些对象，你可以获取每个参数的名字、类型提示、是否可选、默认值、是否引用传递等。这对于构建依赖注入容器或自动生成表单非常关键。 -
返回类型 (
getReturnType()
): 如果方法定义了返回类型（PHP 7+），这个方法会返回一个ReflectionType
对象，你可以从中获取返回类型的名称。 -
可见性判断 (
isPublic()
,isProtected()
,isPrivate()
): 这些布尔方法告诉你方法的访问权限。 -
特性判断 (
isStatic()
,isAbstract()
,isFinal()
,isConstructor()
,isDestructor()
): 同样是布尔方法，判断方法是否为静态、抽象、最终、构造函数或析构函数。 -
方法定义位置 (
getFileName()
,getStartLine()
,getEndLine()
): 告诉你方法定义在哪个文件、从哪一行开始到哪一行结束。这在调试或代码分析工具中非常有用。 -
PHPDoc注释 (
getDocComment()
): 如果方法上方有PHPDoc注释块，这个方法会返回注释的字符串内容。这对于自动文档生成工具来说是核心数据。 -
方法体 (
getClosure()
): 对于非静态方法，你可以获取一个Closure闭包，允许你以绑定到特定对象的方式调用该方法。
getMethod('getUserInfo');
echo "方法名: " . $method->getName() . "\n";
echo "声明类: " . $method->getDeclaringClass()->getName() . "\n";
echo "是否公共: " . ($method->isPublic() ? '是' : '否') . "\n";
echo "是否静态: " . ($method->isStatic() ? '是' : '否') . "\n";
echo "定义文件: " . $method->getFileName() . "\n";
echo "起始行: " . $method->getStartLine() . "\n";
echo "结束行: " . $method->getEndLine() . "\n";
echo "PHPDoc注释:\n" . $method->getDocComment() . "\n";
echo "参数信息:\n";
foreach ($method->getParameters() as $param) {
echo " - 参数名: " . $param->getName() . "\n";
echo " 类型提示: " . ($param->hasType() ? $param->getType()->getName() : '无') . "\n";
echo " 是否可选: " . ($param->isOptional() ? '是' : '否') . "\n";
if ($param->isOptional()) {
echo " 默认值: " . var_export($param->getDefaultValue(), true) . "\n";
}
}
echo "返回类型: " . ($method->hasReturnType() ? $method->getReturnType()->getName() : '无') . "\n";
?>这些丰富的信息使得反射成为PHP中进行元编程、构建框架、工具和高级库不可或缺的特性。当然，反射操作本身会有一定的性能开销，所以在高性能要求的循环中频繁使用时需要注意，但在大多数场景下，其带来的灵活性和强大功能远超这点开销。
