Method load_stub_class

src/resolution.rs:213–242

Try to load a class from the embedded stub index only. This is the in-memory-only counterpart of [`find_or_load_class`]. It checks the `uri_classes_index` first (O(1) via the FQN index), and if the class hasn't been parsed yet, looks it up in the in-memory `stub_index`. When found there, it parses and caches the stub under a `phpantom-stub://` URI so subsequent lookups are free. No disk I/O is

(&self, class_name: &str)

    /// PSR-4, vendor) are not resolved — callers that need those should
    /// use [`find_or_load_class`] instead.
    pub(crate) fn load_stub_class(&self, class_name: &str) -> Option<Arc<ClassInfo>> {
        let last_segment = short_name(class_name);

        // Fast path: already parsed and cached.
        if let Some(cls) = self.find_class_in_uri_classes_index(class_name) {
            return Some(cls);
        }

        // Look up in the in-memory stub index.
        let stub_idx = self.stub_index.read();
        let stub_content = if class_name.contains('\\') {
            // Namespaced lookup (e.g. "BcMath\\Number").
            stub_idx.get(class_name).copied()
        } else {
            // Global-namespace lookup (e.g. "PDO").
            stub_idx.get(last_segment).copied()
        };

        if let Some(content) = stub_content {
            let stub_uri = format!("phpantom-stub://{}", class_name);
            let ver = Some(self.php_version());
            if let Some(classes) = self.parse_and_cache_content_versioned(content, &stub_uri, ver)
                && let Some(cls) = classes.iter().find(|c| c.name == last_segment)
            {
                return Some(Arc::clone(cls));
            }
        }

        None
    }

    /// Parse a PHP file from disk (or from a phar archive), cache the
    /// results, and return the extracted classes.