Function php_resolve_class_name

internal/cbm/lsp/php_lsp.c:201–254

Resolve a class identifier to a fully-qualified registry key. * - Fully-qualified ("\\Foo\\Bar"): FOO.BAR — strip leading slash. * - Aliased / single segment matches a use: the use target. * - First segment matches a use: substitute and append remainder. * - Otherwise: prefix with current_namespace_qn (or module). * * Returns an ar

 *
 * Returns an arena-allocated string in dotted form. May return NULL for builtins. */
const char *php_resolve_class_name(PHPLSPContext *ctx, const char *name) {
    if (!name || !*name)
        return NULL;

    /* Self / static / parent are class-relative pseudo-types and must be
     * checked BEFORE the builtin-name check, since they're listed as
     * builtins above for type-parsing purposes. */
    if (strcmp(name, "self") == 0 || strcmp(name, "static") == 0) {
        return ctx->enclosing_class_qn;
    }
    if (strcmp(name, "parent") == 0) {
        return ctx->enclosing_parent_qn;
    }
    if (php_is_builtin_type_name(name))
        return NULL;

    /* Fully-qualified — leading backslash. */
    if (name[0] == '\\') {
        return php_ns_to_dot(ctx->arena, name + 1);
    }

    /* Split first segment. */
    const char *sep = name;
    while (*sep && *sep != '\\')
        sep++;
    char *first;
    if (*sep) {
        first = cbm_arena_strndup(ctx->arena, name, (size_t)(sep - name));
    } else {
        first = cbm_arena_strdup(ctx->arena, name);
    }

    const char *use_target = find_use(ctx, first, CBM_PHP_USE_CLASS);
    if (use_target) {
        if (*sep) {
            /* use App\\Models as M;  M\\User -> App.Models.User */
            return cbm_arena_sprintf(ctx->arena, "%s%s", use_target,
                                     php_ns_to_dot(ctx->arena, sep));
        }
        return use_target;
    }

    /* Fallback for a same-file class reference: prefer module_qn-prefixed QN
     * because that's what the unified extractor records. The PHP namespace
     * declaration is *not* incorporated into the unified extractor's QNs
     * (defs are keyed by file path + class name), so building from
     * current_namespace_qn here would diverge and miss every same-file
     * lookup. */
    if (ctx->module_qn && ctx->module_qn[0]) {
        return cbm_arena_sprintf(ctx->arena, "%s.%s", ctx->module_qn,
                                 php_ns_to_dot(ctx->arena, name));
    }
    return php_ns_to_dot(ctx->arena, name);
}

/* Try to find a registered type for a "namespaced" QN.
 *