Content · Web Development · PHP

PHP ReflectionClass::hasProperty() Method: Usage and Examples

PHP ReflectionClass::hasProperty() Method: Usage and Examples: Checks whether a named property exists, including inherited properties.

1 views Published Oct 17, 2026 Updated Oct 17, 2026 admin

ReflectionClass inspects the definition of a class, rather than running its constructor or calling its methods.

What Is ReflectionClass::hasProperty in PHP?


Checks whether a named property exists, including inherited properties.

ReflectionClass::hasProperty(string $name)

Parameters:

  • $name — Required. The exact class-member name (method, property or constant) to inspect.

Example 1: Understanding the Basic Behavior


<?php

class Report { public const VERSION = 2; public string $title = 'Draft'; protected int $pages = 10; public static string $category = 'docs'; public function publish(): void {} }
$reflectionClass = new ReflectionClass(Report::class);
$result = $reflectionClass->hasProperty("title");
var_dump($result);

Output:

bool(true)

Explanation: Checks whether a named property exists, including inherited properties.

Example 2: Testing Another Case


<?php

interface Exportable { public function export(): string; }
trait HasId { public function getId(): int { return 12; } }
class Invoice implements Exportable { use HasId; public string $name = 'Invoice'; public const STATE = 'open'; public function export(): string { return 'invoice'; } }
$reflectionClass = new ReflectionClass(Invoice::class);
$result = $reflectionClass->hasProperty("name");
var_dump($result);

Output:

bool(true)

Explanation: The method checks property declaration, not whether a typed property is initialized on a particular object.

Practical Example: Applying the Operation


<?php

abstract class BaseJob { protected string $name = 'job'; abstract public function run(): void; }
class CompletedJob extends BaseJob { public function run(): void {} }
$reflectionClass = new ReflectionClass(CompletedJob::class);
$result = $reflectionClass->hasProperty("name");
var_dump($result);

Output:

bool(true)

Explanation: The returned metadata may be false, null, an array, or a Reflection object depending on the requested property.

Important Behavior and Edge Cases


  • The method checks property declaration, not whether a typed property is initialized on a particular object.
  • The returned metadata may be false, null, an array, or a Reflection object depending on the requested property.

Comparison With Related Approaches


ApproachWhen to Use It
ReflectionClass::hasPropertyChecks whether a named property exists, including inherited properties.
ReflectionClass::getProperty()hasProperty() checks a declared/inherited property; getProperty() returns the descriptor or throws.

Common Beginner Mistakes


MistakeCorrect Approach
Confusing a class-declaration check by ReflectionClass::hasProperty() with an invocation of the class itself.The method checks property declaration, not whether a typed property is initialized on a particular object.
Choosing ReflectionClass::getProperty() without checking whether it provides the same result.hasProperty() checks a declared/inherited property; getProperty() returns the descriptor or throws.

Key Takeaways


  • Checks whether a named property exists, including inherited properties.
  • The method checks property declaration, not whether a typed property is initialized on a particular object.
  • The returned metadata may be false, null, an array, or a Reflection object depending on the requested property.

The examples demonstrate where ReflectionClass::hasProperty fits within reflection and metadata. Verify the relevant preconditions whenever you adapt the code to real data.

Share this resourceSend this page to someone who may find it useful.