使用PHP反射API可获取类的所有方法，通过ReflectionClass创建实例并调用getMethods()返回ReflectionMethod对象数组，支持按访问修饰符和静态等属性筛选。结合位掩码如IS_PUBLIC、IS_STATIC可精准过滤目标方法，适用于API文档生成或框架开发。ReflectionMethod还提供方法所在类、参数类型、默认值、注释、文件位置等详细元数据，便于元编程与自动化处理。需注意getMethods()默认包含父类方法，可通过getDeclaringClass()过滤仅保留当前类定义的方法。反射性能较低，不宜在高频执行路径使用，且应避免滥用setAccessible()破坏封装性，主要用于初始化、调试或测试等场景。
在PHP中，要获取一个类的所有方法，最直接且强大的方式就是利用PHP的反射（Reflection）API。它允许你在运行时检查类、接口、函数、方法和扩展，而无需实际实例化它们。核心思想是，你通过
ReflectionClass来“解剖”一个类，然后从中提取出所有的方法信息。
解决方案
要获取一个类的所有方法，你需要先创建一个
ReflectionClass的实例，然后调用它的
getMethods()方法。这个方法会返回一个
ReflectionMethod对象的数组，每个对象都代表类中的一个方法。
getMethods(); // 获取所有方法
echo "Class '{$className}' has the following methods:\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)";
}
echo "\n";
}
} catch (ReflectionException $e) {
echo "Error reflecting class: " . $e->getMessage();
}
?>这段代码会遍历
MyService类的所有方法，并打印出它们的名称以及访问修饰符。你会发现，
getMethods()默认会返回包括公共、保护和私有在内的所有方法，甚至包括构造函数等特殊方法。
立即学习“PHP免费学习笔记（深入）”；
PHP反射机制如何精准筛选特定类型的类方法？
在很多实际场景中，我们可能并不需要一个类的所有方法，比如，我们只想获取所有的公共方法来构建一个API接口文档，或者只关注静态方法来查找工具函数。
ReflectionClass::getMethods()方法允许你通过传递一个可选的位掩码参数来筛选方法。
这些位掩码常量定义在
ReflectionMethod类中：
ReflectionMethod::IS_PUBLIC
：公共方法ReflectionMethod::IS_PROTECTED
：保护方法ReflectionMethod::IS_PRIVATE
：私有方法ReflectionMethod::IS_STATIC
：静态方法ReflectionMethod::IS_ABSTRACT
：抽象方法ReflectionMethod::IS_FINAL
：最终方法
你可以通过按位或（
|）操作符组合这些常量来指定多种筛选条件。
getMethods(ReflectionMethod::IS_PUBLIC);
foreach ($publicMethods as $method) {
echo "- " . $method->getName() . "\n";
}
echo "\n--- Static Methods ---\n";
$staticMethods = $reflector->getMethods(ReflectionMethod::IS_STATIC);
foreach ($staticMethods as $method) {
echo "- " . $method->getName() . "\n";
}
echo "\n--- Public and Static Methods ---\n";
$publicAndStaticMethods = $reflector->getMethods(ReflectionMethod::IS_PUBLIC | ReflectionMethod::IS_STATIC);
foreach ($publicAndStaticMethods as $method) {
echo "- " . $method->getName() . "\n";
}
} catch (ReflectionException $e) {
echo "Error reflecting class: " . $e->getMessage();
}
?>通过这种方式，你可以非常灵活地根据你的需求来筛选出目标方法。这在构建框架、自动化测试、或者实现某些高级的依赖注入容器时，都显得尤为实用。我个人在处理一些遗留系统，需要动态调用特定类型方法时，就经常会用到这种筛选能力，省去了很多手动检查的麻烦。
除了方法名，PHP反射还能提供哪些关于类方法的详细信息？
ReflectionMethod对象远不止能告诉你方法的名字和访问修饰符。它是一个宝库，提供了关于方法本身的几乎所有元数据。这包括但不限于：
-
方法所属的类：
$method->getDeclaringClass()->getName()
可以告诉你这个方法是在哪个类中声明的，这对于处理继承链中的方法非常有用。 -
参数信息：
$method->getParameters()
返回一个ReflectionParameter
对象数组，你可以通过它们获取参数名、类型提示、默认值、是否可选等。 -
文档注释：
$method->getDocComment()
可以获取方法上方的PHPDoc注释块。这对于自动生成API文档或者运行时检查注释中的元数据（比如路由注解）非常关键。 -
文件和行号：
$method->getFileName()
、$method->getStartLine()
和$method->getEndLine()
可以精确地定位方法在源文件中的位置。 -
是否为构造函数/析构函数：
$method->isConstructor()
和$method->isDestructor()
。 -
是否可以被调用：
$method->isCallable()
。 -
是否为用户定义的方法：
$method->isUserDefined()
（区别于PHP内置方法）。
getMethods();
echo "\n--- Detailed Method Information ---\n";
foreach ($methods as $method) {
echo "Method Name: " . $method->getName() . "\n";
echo " Declaring Class: " . $method->getDeclaringClass()->getName() . "\n";
echo " Is Public: " . ($method->isPublic() ? 'Yes' : 'No') . "\n";
echo " Is Static: " . ($method->isStatic() ? 'Yes' : 'No') . "\n";
echo " Is Constructor: " . ($method->isConstructor() ? 'Yes' : 'No') . "\n";
$parameters = $method->getParameters();
if (!empty($parameters)) {
echo " Parameters:\n";
foreach ($parameters as $param) {
echo " - " . $param->getName();
if ($param->hasType()) {
echo " (Type: " . $param->getType()->getName() . ")";
}
if ($param->isOptional()) {
echo " (Optional, Default: " . var_export($param->getDefaultValue(), true) . ")";
}
echo "\n";
}
}
$docComment = $method->getDocComment();
if ($docComment) {
echo " Doc Comment: " . substr($docComment, 0, 50) . "...\n"; // 只显示部分
}
echo "-----------------------------------\n";
}
} catch (ReflectionException $e) {
echo "Error reflecting class: " . $e->getMessage();
}
?>这些详细信息使得反射成为PHP中进行元编程（metaprogramming）不可或缺的工具。当你需要动态地理解和操作代码结构时，它就是你的瑞士军刀。
在使用PHP反射获取类方法时，可能遇到哪些常见问题或性能考量？
反射虽然强大，但在使用时也有一些需要注意的地方。
一个常见的疑问是，
getMethods()会返回父类的方法吗？是的，默认情况下，
getMethods()会返回当前类及其所有父类中定义的所有可访问方法。如果你只想获取当前类（不包括父类）自身定义的方法，你需要手动过滤：
getMethods(); // 包含 parentMethod 和 childMethod
echo "\n--- Methods declared in ChildService itself ---\n";
foreach ($allMethods as $method) {
if ($method->getDeclaringClass()->getName() === $reflector->getName()) {
echo "- " . $method->getName() . "\n"; // 只输出 childMethod
}
}
?>另一个需要考虑的是性能。反射操作本质上是对PHP内部结构进行检查，这比直接调用方法或访问属性要慢。对于那些在请求生命周期中会频繁执行的普通业务逻辑，尽量避免过度使用反射。它更适合在启动阶段、配置加载、框架初始化或调试工具等场景中使用，在这些场景下，性能开销通常是可接受的。
错误处理也需要注意。如果你尝试反射一个不存在的类，
new ReflectionClass()会抛出一个
ReflectionException。因此，在实际应用中，务必使用
try-catch块来捕获这类异常，确保程序的健壮性。
最后，虽然反射可以让你获取到私有和保护方法，甚至通过
setAccessible(true)来调用它们，但这通常被视为一种“黑魔法”。它绕过了PHP的访问控制机制，可能破坏封装性，增加代码的复杂性和维护难度。除非有非常明确且充分的理由（例如，实现一个测试框架或者某些高级调试工具），否则应尽量避免直接调用私有或保护方法。这就像是给了你一把万能钥匙，虽然能开所有门，但如果滥用，可能会导致整个房子的结构不稳定。
