When building tools that inspect PHP code, ReflectionConstant::getShortName() helps answer a focused question: returns a global constant name without its namespace prefix.
Reflection is useful in framework tooling, dependency injection, testing, code inspection and debugging.
What Is ReflectionConstant::getShortName()?
Returns a global constant name without its namespace prefix.
Its method signature is:
public function getShortName(): string
This method has no required arguments.
Return value: string
Example 1: Inspect the basic behavior
Start with a self-contained PHP declaration and inspect the method result.
<?php
declare(strict_types=1);
const GUIDE_LEVEL = 7;
const GUIDE_LIMIT = 12;
$constantReflection = new ReflectionConstant("GUIDE_LEVEL");
$result = $constantReflection->getShortName();
var_dump($result);
Output:
string(11) "GUIDE_LEVEL"
Explanation: Returns a global constant name without its namespace prefix.
Example 2: Compare a second case
Next, change the reflected declaration or parameter to observe a related situation.
<?php
declare(strict_types=1);
const GUIDE_LEVEL = 7;
const GUIDE_LIMIT = 12;
$constantReflection = new ReflectionConstant("PHP_VERSION_ID");
$result = $constantReflection->getShortName();
var_dump($result);
// Check the returned value type before using the result.
echo "\nResult type: " . get_debug_type($result);
Output:
string(14) "PHP_VERSION_ID"
Result type: string
Explanation: Different namespaces can declare constants with the same short name.
Practical Example: Apply the operation in context
This final case shows how the same API can be used when inspecting application definitions.
<?php
declare(strict_types=1);
const GUIDE_LEVEL = 7;
const GUIDE_LIMIT = 12;
$constantReflection = new ReflectionConstant("GUIDE_LIMIT");
$result = $constantReflection->getShortName();
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:
string(11) "GUIDE_LIMIT"
Reflection result available
Explanation: getName retains the namespace information.
Important Behavior and Edge Cases
- Different namespaces can declare constants with the same short name.
- getName retains the namespace information.
- 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 |
|---|---|
ReflectionConstant::getShortName() | Returns a global constant name without its namespace prefix. |
Related API | getName retains the namespace information. |
Common Beginner Mistakes
| Mistake | Correct Approach |
|---|---|
| Ignoring this condition: Different namespaces can declare constants with the same short name. | Handle the specific limitation: Different namespaces can declare constants with the same short name. |
| Confusing this method with Related API | getName retains the namespace information. |
Key Takeaways
- Returns a global constant name without its namespace prefix.
- Different namespaces can declare constants with the same short name.
- getName retains the namespace information.
Use ReflectionConstant::getShortName() when you need the precise metadata or behavior demonstrated above. Keep the target declaration and relevant PHP version in mind when adapting the examples.