Struct Psr4Map 

pub struct Psr4Map { /* private fields */ }

PSR-4 / PSR-0 / classmap / files autoload mapping, built from composer.json and vendor/composer/installed.json.

project_entries covers autoload.psr-4 / autoload-dev.psr-4 for the project itself; project_psr0_entries covers autoload.psr-0 / autoload-dev.psr-0 (kept separate because PSR-0 file-path construction differs from PSR-4 — see Self::resolve). vendor_entries / vendor_psr0_entries cover the same keys from each installed package. project_extra_paths and vendor_extra_paths collect the (prefix-less) classmap and files entries as raw paths, plus the PSR-0 dirs themselves (for bulk file-list walking) — files are kept as-is, dirs are walked when assembling the file list.

All prefix lists are sorted longest-prefix-first for correct prefix matching.

Implementations

impl Psr4Map

pub fn from_composer(root: &Path) -> Result<Self, ComposerError>

pub fn project_files(&self) -> Vec<PathBuf>

pub fn vendor_files(&self) -> Vec<PathBuf>

pub fn resolve(&self, fqcn: &str) -> Option<PathBuf>

Resolve a fully-qualified class name to a file path using longest-prefix-first matching. Returns None if no prefix matches or the mapped file does not exist on disk.

Resolution order:

1. PSR-4 project entries (longest-prefix-first).
2. PSR-4 vendor entries (longest-prefix-first).
3. PSR-0 project entries (longest-prefix-first).
4. PSR-0 vendor entries (longest-prefix-first).
5. Classmap from vendor/composer/autoload_classmap.php — exact FQCN match.

PSR-4 wins over PSR-0 wins over classmap because Composer’s runtime resolver uses the same order; this matches what the PHP code being analyzed actually sees.

pub fn vendor_eager_files(&self) -> Vec<PathBuf>

Vendor files that must be eagerly parsed in lazy mode: autoload.files entries from composer. These hold globals (functions, constants, polyfills) that the FQCN-based lazy resolver cannot reach because they have no namespace mapping.

Returns just the existing .php files; missing entries (stale generated file) are dropped.

pub fn all_vendor_files(&self) -> Vec<PathBuf>

Every vendor file the analyzer should index eagerly, for the rust-analyzer-style static-input model: the union of

1. Self::vendor_files — PSR-4 / PSR-0 walked directories + extra paths,
2. classmap file targets — packages that use classmap: autoload (no PSR-4 prefix), which Self::vendor_files does NOT walk, and
3. Self::vendor_eager_files — autoload.files globals.

Deduplicated by path. Non-existent classmap targets (stale generated file) are skipped. This is the work-list a consumer feeds to the chunked background indexer (crate::AnalysisSession::index_batch).

pub fn classmap_len(&self) -> usize

Number of FQCN entries known to the classmap. Used by callers that want to log/verify the classmap loaded successfully.

Trait Implementations

impl ClassResolver for Psr4Map

fn resolve(&self, fqcn: &str) -> Option<PathBuf>

Resolve fqcn to the file that defines it. Returning None causes the analyzer to fall back to emitting UndefinedClass.

impl Clone for Psr4Map

fn clone(&self) -> Psr4Map

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.