When building tools that inspect PHP code, ReflectionMethod::isPublic() helps answer a focused question: reports whether the method is public.
Reflection is useful in framework tooling, dependency injection, testing, code inspection and debugging.
What Is ReflectionMethod::isPublic()?
Reports whether the method is public.
Its method signature is:
public function isPublic(): bool
This method has no required arguments.
Return value: bool
Example 1: Inspect a reflected method
Start with a self-contained PHP declaration and inspect the method result.
<?php
declare(strict_types=1);
#[Attribute(Attribute::TARGET_METHOD)]
class ActionLabel { public function __construct(public string $label) {} }
interface Action { public function execute(string $message): string; }
abstract class AbstractAction { abstract public function perform(): void; }
class MailAction implements Action {
public function __construct(public string $name = 'Mail') {}
#[ActionLabel('send')]
public function execute(string $message): string { return $this->name . ': ' . $message; }
protected function verify(): bool { return true; }
private function internal(): string { return 'secret'; }
final public function finalize(): string { return 'complete'; }
public static function version(): int { return 2; }
public function __destruct() {}
}
class SmsAction extends MailAction { public function execute(string $message): string { return parent::execute($message); } }
class VerifiedAction extends MailAction { protected function verify(): bool { return false; } }
$methodReflection = new ReflectionMethod(MailAction::class, "execute");
$result = $methodReflection->isPublic();
var_dump($result);
Output:
bool(true)
Explanation: Reports whether the method is public.
Example 2: Compare an inherited method
Next, change the reflected declaration or parameter to observe a related situation.
<?php
declare(strict_types=1);
#[Attribute(Attribute::TARGET_METHOD)]
class ActionLabel { public function __construct(public string $label) {} }
interface Action { public function execute(string $message): string; }
abstract class AbstractAction { abstract public function perform(): void; }
class MailAction implements Action {
public function __construct(public string $name = 'Mail') {}
#[ActionLabel('send')]
public function execute(string $message): string { return $this->name . ': ' . $message; }
protected function verify(): bool { return true; }
private function internal(): string { return 'secret'; }
final public function finalize(): string { return 'complete'; }
public static function version(): int { return 2; }
public function __destruct() {}
}
class SmsAction extends MailAction { public function execute(string $message): string { return parent::execute($message); } }
class VerifiedAction extends MailAction { protected function verify(): bool { return false; } }
$methodReflection = new ReflectionMethod(SmsAction::class, "execute");
$result = $methodReflection->isPublic();
var_dump($result);
// Check the returned value type before using the result.
echo "\nResult type: " . get_debug_type($result);
Output:
bool(true)
Result type: bool
Explanation: A public method can also be static or final.
Practical Example: Inspect application method metadata
This final case shows how the same API can be used when inspecting application definitions.
<?php
declare(strict_types=1);
#[Attribute(Attribute::TARGET_METHOD)]
class ActionLabel { public function __construct(public string $label) {} }
interface Action { public function execute(string $message): string; }
abstract class AbstractAction { abstract public function perform(): void; }
class MailAction implements Action {
public function __construct(public string $name = 'Mail') {}
#[ActionLabel('send')]
public function execute(string $message): string { return $this->name . ': ' . $message; }
protected function verify(): bool { return true; }
private function internal(): string { return 'secret'; }
final public function finalize(): string { return 'complete'; }
public static function version(): int { return 2; }
public function __destruct() {}
}
class SmsAction extends MailAction { public function execute(string $message): string { return parent::execute($message); } }
class VerifiedAction extends MailAction { protected function verify(): bool { return false; } }
$methodReflection = new ReflectionMethod(MailAction::class, "execute");
$result = $methodReflection->isPublic();
var_dump($result);
// Use the reflection result in a simple decision.
if (is_bool($result)) {
echo "\nStatus: " . ($result ? "yes" : "no");
} elseif (is_array($result)) {
echo "\nEntries: " . count($result);
} elseif ($result === null) {
echo "\nNo value returned";
} else {
echo "\nReflection result available";
}
Output:
bool(true)
Status: yes
Explanation: getModifiers returns all method modifiers as a bitmask.
Important Behavior and Edge Cases
- A public method can also be static or final.
- getModifiers returns all method modifiers as a bitmask.
- Reflection describes declarations and runtime state; requesting metadata does not automatically validate or sanitize application input.
Comparison With Related Approaches
| Approach | When to Use It |
|---|---|
ReflectionMethod::isPublic() | Reports whether the method is public. |
Related API | getModifiers returns all method modifiers as a bitmask. |
Common Beginner Mistakes
| Mistake | Correct Approach |
|---|---|
| Ignoring this condition: A public method can also be static or final. | Handle the specific limitation: A public method can also be static or final. |
| Confusing this method with Related API | getModifiers returns all method modifiers as a bitmask. |
Key Takeaways
- Reports whether the method is public.
- A public method can also be static or final.
- getModifiers returns all method modifiers as a bitmask.
Use ReflectionMethod::isPublic() when you need the precise metadata or behavior demonstrated above. Keep the target declaration and relevant PHP version in mind when adapting the examples.