Struct ProjectAnalyzer 

pub struct ProjectAnalyzer {
    pub cache: Option<AnalysisCache>,
    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 */
}

Fields

cache: Option<AnalysisCache>

Optional cache — when Some, Pass 2 results are read/written per file.

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 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

Set the target PHP version.

pub fn member_location(&self, fqcn: &str, member_name: &str) -> Option<Location>

Look up the source location of a class member (method, property, or class constant / enum case) by walking the inheritance chain through the salsa db. Returns None if no member with that name exists, or if the member has no recorded location.

pub fn symbol_location(&self, symbol: &str) -> Option<Location>

pub fn reference_locations( &self, symbol: &str, ) -> Vec<(Arc<str>, u32, u16, u16)>

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.