Function resolve_class_path

src/composer.rs:392–427

Resolve a fully-qualified PHP class name to a file path using PSR-4 mappings. The `class_name` should be the namespace-qualified name (e.g. `"Klarna\\Customer"` or `"Klarna\\Rest\\Order"`). A leading `\` is stripped if present (PHP fully-qualified syntax). Returns the first path that exists on disk, or `None` if no mapping matches or the resolved file doesn't exist.

(
    mappings: &[Psr4Mapping],
    workspace_root: &Path,
    class_name: &str,
)

/// Returns the first path that exists on disk, or `None` if no mapping
/// matches or the resolved file doesn't exist.
pub fn resolve_class_path(
    mappings: &[Psr4Mapping],
    workspace_root: &Path,
    class_name: &str,
) -> Option<PathBuf> {
    let name = class_name;

    // Skip built-in type keywords that are never real classes
    if crate::php_type::is_keyword_type(name) {
        return None;
    }

    // Try each mapping (already sorted longest-prefix-first)
    for mapping in mappings {
        let relative = if mapping.prefix.is_empty() {
            // Empty prefix matches everything (root namespace fallback)
            Some(name)
        } else {
            name.strip_prefix(&mapping.prefix)
        };

        if let Some(relative_class) = relative {
            // Convert namespace separators to directory separators
            let relative_path = relative_class.replace('\\', "/");
            let file_path = workspace_root
                .join(&mapping.base_path)
                .join(format!("{}.php", relative_path));

            if file_path.is_file() {
                return Some(file_path);
            }
        }
    }

    None
}

/// Extract file paths from `require_once` statements in PHP source content.
///