Struct ProjectAnalyzer 

pub struct ProjectAnalyzer {
    pub on_file_done: Option<Arc<dyn Fn() + Send + Sync>>,
    pub psr4: Option<Arc<Psr4Map>>,
    pub find_dead_code: bool,
    pub php_version: Option<PhpVersion>,
    pub stub_files: Vec<PathBuf>,
    pub stub_dirs: Vec<PathBuf>,
    /* private fields */
}

Batch-oriented analyzer: file discovery, parsing, and analysis.

ProjectAnalyzer is the primary entry point for analyzing a project as a whole. It orchestrates parallel file discovery and parsing, using the same core analysis engine as AnalysisSession (salsa database and Pass 2 driver).

Unified Design: ProjectAnalyzer and AnalysisSession now share the same database management via [SharedDb]. ProjectAnalyzer is the batch API (all files at once), while AnalysisSession is the incremental API (file-by-file). Both use Pass2Driver, the same definition collection logic, and identical database operations, eliminating code duplication.

Fields

on_file_done: Option<Arc<dyn Fn() + Send + Sync>>

Called once after each file completes Pass 2 (used for progress reporting).

psr4: Option<Arc<Psr4Map>>

PSR-4 autoloader mapping from composer.json, if available.

find_dead_code: bool

When true, run dead code detection at the end of analysis.

php_version: Option<PhpVersion>

Target PHP language version. None means “not configured”; resolved to PhpVersion::LATEST when passed down to StatementsAnalyzer.

stub_files: Vec<PathBuf>

Additional stub files to parse before analysis (absolute paths).

stub_dirs: Vec<PathBuf>

Additional stub directories to walk and parse before analysis (absolute paths).

Implementations

impl ProjectAnalyzer

pub fn new() -> Self

pub fn with_cache(cache_dir: &Path) -> Self

Create a ProjectAnalyzer with a disk-backed cache stored under cache_dir.

pub fn set_cache_dir(&mut self, cache_dir: &Path)

Enable the disk-backed cache for an already-constructed analyzer.

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

Create a ProjectAnalyzer from a project root containing composer.json. Returns the analyzer (with psr4 set) and the Psr4Map so callers can call map.project_files() / map.vendor_files().

pub fn with_php_version(self, version: PhpVersion) -> Self

Builder method: set the target PHP version.

pub fn with_dead_code(self, enabled: bool) -> Self

Builder method: enable dead-code detection at the end of analysis.

pub fn with_progress_callback( self, callback: Arc<dyn Fn() + Send + Sync>, ) -> Self

Builder method: set a progress callback invoked once per analyzed file.

pub fn with_stub_files(self, files: Vec<PathBuf>) -> Self

Builder method: add user stub files.

pub fn with_stub_dirs(self, dirs: Vec<PathBuf>) -> Self

Builder method: add user stub directories.

pub fn with_cache_dir(self, cache_dir: &Path) -> Self

Builder method: configure a disk-backed cache at the given directory.

pub fn with_psr4(self, map: Arc<Psr4Map>) -> Self

Builder method: attach a PSR-4 autoloader map.

pub fn contains_function(&self, fqn: &str) -> bool

Returns true if a function with fqn is registered and active.

pub fn contains_class(&self, fqcn: &str) -> bool

Returns true if a class / interface / trait / enum is registered.

pub fn contains_method(&self, class: &str, name: &str) -> bool

Returns true if class has a method named name (case-insensitive).

pub fn definition_of( &self, symbol: &Symbol, ) -> Result<Location, SymbolLookupError>

Resolve a symbol to its declaration location.

Mirrors crate::AnalysisSession::definition_of.

pub fn references_to(&self, symbol: &Symbol) -> Vec<(Arc<str>, Range)>

All recorded references to a symbol, as (file, range) pairs.

Mirrors crate::AnalysisSession::references_to.

pub fn load_stubs(&self)

Load PHP built-in stubs. Called automatically by analyze if not done yet. Stubs are filtered against the configured target PHP version (or PhpVersion::LATEST if none was set).

pub fn analyze(&self, paths: &[PathBuf]) -> AnalysisResult

Run the full analysis pipeline on a set of file paths.

pub fn re_analyze_file( &self, file_path: &str, new_content: &str, ) -> AnalysisResult

Re-analyze a single file within the existing codebase.

This is the incremental analysis API for LSP:

1. Removes old definitions from this file
2. Re-runs Pass 1 (definition collection) on the new content
3. Resolves any newly-collected @psalm-import-type declarations
4. Re-runs Pass 2 (body analysis) on this file
5. Returns the analysis result for this file only

pub fn analyze_source(source: &str) -> AnalysisResult

Analyze a PHP source string without a real file path. Useful for tests and LSP single-file mode.

pub fn discover_files(root: &Path) -> Vec<PathBuf>

Discover all .php files under a directory, recursively.

pub fn collect_types_only(&self, paths: &[PathBuf])

Pass 1 only: collect type definitions from paths into the codebase without analyzing method bodies or emitting issues. Used to load vendor types.

Trait Implementations

impl Default for ProjectAnalyzer

fn default() -> Self

Returns the “default value” for a type.