Method update_ast

src/parser/ast_update.rs:35–81

Update the uri_classes_index, use_map, and namespace_map for a given file URI by parsing its content. Returns `true` when at least one class signature in this file changed (or a class was added/removed), meaning other open files that reference those classes may have stale diagnostics.

(&self, uri: &str, content: &str)

    /// changed (or a class was added/removed), meaning other open files
    /// that reference those classes may have stale diagnostics.
    pub fn update_ast(&self, uri: &str, content: &str) -> bool {
        // Invalidate thread-local mixin cache so stale ClassInfo is not
        // served after a file changes.
        crate::virtual_members::phpdoc::bump_mixin_generation();

        let content_to_parse = if self.is_blade_file(uri) {
            let (virtual_php, source_map) = crate::blade::preprocessor::preprocess(content);
            self.blade_source_maps
                .write()
                .insert(uri.to_string(), source_map);
            self.blade_virtual_content
                .write()
                .insert(uri.to_string(), virtual_php.clone());
            virtual_php
        } else {
            content.to_string()
        };

        // The mago-syntax parser contains `unreachable!()` and `.expect()`
        // calls that can panic on malformed PHP (e.g. partially-written
        // heredocs/nowdocs, which are common while editing).  Wrap the
        // entire parse + extraction in `catch_unwind` so a parser panic
        // doesn't crash the LSP server and produce a zombie process.
        //
        // On panic the file is simply skipped — no maps are updated, and
        // the user gets stale (but not missing) completions until the
        // file is saved in a parseable state.
        let content_owned = content_to_parse;
        let uri_owned = uri.to_string();

        let result = crate::util::catch_panic_unwind_safe("parse", uri, None, || {
            self.update_ast_inner(&uri_owned, &content_owned)
        });

        match result {
            Some(changed) => changed,
            None => {
                // Parser panicked — store a single "Parse failed" error
                // so the syntax-error diagnostic collector can report it.
                self.parse_errors.write().insert(
                    uri.to_string(),
                    vec![("Parse failed (internal error)".to_string(), 0, 0)],
                );
                false
            }
        }
    }

    /// Inner implementation of [`update_ast`] that performs the actual
    /// parsing and map updates.  Separated so that [`update_ast`] can