[JGamboa]

Summary

Third family of the missing-builtins PR from the #1886 split (review item 19). Before this PR, get_debug_type() was undefined. It is now a real builtin:

• it has a shared contract, so it gets generated docs, get_defined_functions()['internal'] lists it, and ReflectionFunction::isInternal() returns true;
• it has a builtin! home (src/builtins/types/get_debug_type.rs);
• it has a native runtime helper, __rt_debug_type_name, on AArch64 and x86_64;
• it has a Magician eval implementation.

It follows PHP 8.5 for every kind of value:

• Scalars and arrays use the zend type names: null, bool, int, float, string, array.
• An object reports its class name. Closures and first-class callables report Closure, enums report the enum name, and generators report Generator. An incomplete unserialized object reports __PHP_Incomplete_Class.
• A resource reports resource (stream), resource (stream filter) or resource (stream-context), and resource (closed) once it has been closed, whether the value is boxed or not.
• An anonymous class gets php-src's prefix: its parent, else its first declared interface, else class, followed by @anonymous. That gives class@anonymous, App\Base@anonymous and App\Shape@anonymous. The implicit Stringable that a __toString() method adds does not count.

Anonymous-class names in the runtime metadata

elephc names anonymous classes class@anonymous#N (namespaced, e.g. App\class@anonymous#0). The flattened interface list cannot tell a declared Stringable apart from the implicit one. To keep the change small:

• ClassInfo gets one field, anonymous_debug_name: Option<String>. The checker computes it from the declared extends/implements and leaves it None for named classes.
• The runtime data gets one dense table, _class_debug_name_entries. It has the same row shape and bound (_class_name_count) as _class_name_entries. A named class reuses its existing _class_name_<id> bytes. Only an anonymous class adds its own literal. The cost is 16 bytes per emitted class id.

get_class(), var_dump() and Reflection are unchanged.

Eval

• Inside eval, get_debug_type() names eval-declared anonymous classes from their EvalClass parent and interfaces.
• For compiled objects, eval reads the new table through __elephc_eval_value_object_debug_class_name. This is a twin of the existing class-name wrapper; both are now emitted by one parametrized function per target.
• Compiled code with a persistent eval context sends object and boxed operands through the existing __elephc_eval_object_class_name bridge with a new lookup kind (get_debug_type). Objects of eval-declared classes, which own no generated class id, are therefore named correctly.

Repro (no issue yet)

No issue lists get_debug_type() (#859 covers preg_quote, version_compare, uniqid and stristr).

<?php
echo get_debug_type(1), " ", get_debug_type(new class extends ArrayObject {}), "\n";
// PHP 8.5: int ArrayObject@anonymous
// main:    Undefined function: get_debug_type

Known differences

• PHP spells the anonymous-class prefix as it is written in the source (new class extends arrayobject {} gives arrayobject@anonymous). elephc uses the declared spelling of the class (ArrayObject@anonymous), because name resolution canonicalizes names before the checker sees them.
• These answers come from existing resource typing that this PR does not change, and get_resource_type() agrees with them:
  • stream_context_create() is typed as a stream resource, so it reports resource (stream);
  • a resource stored in an array literal next to stream_context_create() is boxed as an int.

Tests

On main 0842fca every new test fails with Undefined function (or, for Reflection, Function get_debug_type() does not exist). On this branch they pass:

• codegen::casts_and_constants::get_debug_type::test_get_debug_type_names_scalars_arrays_and_objects
• codegen::casts_and_constants::get_debug_type::test_get_debug_type_names_anonymous_classes_like_php
• codegen::casts_and_constants::get_debug_type::test_get_debug_type_names_open_and_closed_resources
• codegen::casts_and_constants::get_debug_type::test_get_debug_type_is_an_internal_function. It covers eval in both directions, string callables, call_user_func, array_map, first-class callables, case-insensitive and namespaced calls, get_defined_functions()['internal'] and isInternal().
• error_tests::misc::string_and_type_builtins::test_error_get_debug_type_wrong_args

Every expected output was measured on PHP 8.5.10. Other changes:

• The contract-count gates were updated (+1).
• The builtin docs and registries were regenerated with the upstream scripts.
• examples/core-introspection shows the builtin.
• The x86_64 and Linux AArch64 runtime helpers and data were assembled with clang, but were only run on macOS AArch64. CI covers Linux execution.

This PR and the open #1924 / #1925 builtin PRs are independent; each is based on main. They bump the same contract counts (registry.rs/support.rs) and regenerate the same docs, so whichever lands later needs a rebase and a fresh docs regeneration. I will do it.

Refs #1886

AI assistance

This PR was prepared with substantial help from Claude Code (Anthropic). The behavior for each value kind was checked against PHP 8.5 before and after implementation.

🤖 Generated with Claude Code

[greptile-apps]

Confidence Score: 4/5

[Medium impact] The change reaches PHP programs that call the new builtin in compiled code or `eval()`.

Fix runtime callback names for eval-created objects before merging.

Findings

1.  Callbacks lose eval class names ▶

Fix with agent prompt

### Issue 1
src/ir/runtime_fn.rs:2108
A runtime-selected `get_debug_type` callback reports `stdClass` instead of `class@anonymous` for an object returned by `eval('return new class {};')`. The newly enabled callback uses a generated wrapper without an eval context. It therefore reads the native backing class instead of the eval-declared class, giving logs and error messages the wrong type.

Make the wrapper consult the object's eval context and add a regression test with an eval-created object.

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

Summary

Adds get_debug_type() to compiled PHP and eval.

• get_debug_type() returns PHP-style names for values, objects, and resources.
• Anonymous classes get debug names from their parent or first declared interface.
• eval() can name values with the same debug-type rules as compiled code.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["get_debug_type(value)"] --> B{"Call path"}
    B --> C["Direct call with eval context"]
    C --> D["Read eval class name"]
    B --> E["Runtime-selected callback"]
    E --> F["Generated wrapper without eval context"]
    F --> G["Read native backing class name"]

Loading

_{Reviews (4) · Last reviewed commit: "docs(builtins): regenerate builtin docs ..." · Reviewed by Greptile}

[greptile-apps]

Callbacks lose eval class names

A runtime-selected get_debug_type callback reports stdClass instead of class@anonymous for an object returned by eval('return new class {};'). The newly enabled callback uses a generated wrapper without an eval context. It therefore reads the native backing class instead of the eval-declared class, giving logs and error messages the wrong type.

Make the wrapper consult the object's eval context and add a regression test with an eval-created object.

Prompt To Fix With AI

This is a comment left during a code review.
Path: src/ir/runtime_fn.rs
Line: 2108

Comment:
**Callbacks lose eval class names**

A runtime-selected `get_debug_type` callback reports `stdClass` instead of `class@anonymous` for an object returned by `eval('return new class {};')`. The newly enabled callback uses a generated wrapper without an eval context. It therefore reads the native backing class instead of the eval-declared class, giving logs and error messages the wrong type.

Make the wrapper consult the object's eval context and add a regression test with an eval-created object.

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.