Method parse_and_cache_file

src/resolution.rs:259–295

Parse a PHP file from disk (or from a phar archive), cache the results, and return the extracted classes. Convenience wrapper around [`parse_and_cache_content`] that reads the file and derives a URI from the path. Used by [`find_or_load_class`] (Phases 1.5 and 2) and by the go-to-implementation scanner. Phar support:** when `file_path` contains a `!` separator (e.g. `/path/to/phpstan.phar!src/T

(&self, file_path: &Path)

    /// of reading from disk.  The URI uses a `phar://` scheme so that
    /// go-to-definition can distinguish phar-sourced classes.
    pub(crate) fn parse_and_cache_file(&self, file_path: &Path) -> Option<Vec<Arc<ClassInfo>>> {
        let path_str = file_path.to_str().unwrap_or_default();

        // ── Phar path: "archive.phar!internal/path.php" ─────────
        if let Some(sep) = path_str.find('!') {
            let phar_path = Path::new(&path_str[..sep]);
            let internal_path = &path_str[sep + 1..];

            let uri = format!("phar://{}/{}", phar_path.display(), internal_path);

            // Deduplicate concurrent parses of the same phar entry.
            if !self.parse_inflight.lock().insert(uri.clone()) {
                return self.wait_for_cached_result(&uri);
            }
            let result = (|| {
                let archives = self.phar_archives.read();
                let archive = archives.get(phar_path)?;
                let bytes = archive.read_file(internal_path)?;
                let content = std::str::from_utf8(bytes).ok()?;
                self.parse_and_cache_content(content, &uri)
            })();
            self.parse_inflight.lock().remove(&uri);
            return result;
        }

        // ── Regular file path ───────────────────────────────────
        let uri = crate::util::path_to_uri(file_path);

        // Deduplicate concurrent parses of the same file.
        if !self.parse_inflight.lock().insert(uri.clone()) {
            return self.wait_for_cached_result(&uri);
        }
        let content = std::fs::read_to_string(file_path).ok();
        let result = content.and_then(|c| self.parse_and_cache_content(&c, &uri));
        self.parse_inflight.lock().remove(&uri);
        result
    }

    /// Spin-wait for another thread to finish parsing a file and return
    /// the cached result from `uri_classes_index`.