Method parse

src/phar.rs:31–132

Parse a phar archive from raw bytes. Returns `None` if the format is invalid or unsupported.

(data: Vec<u8>)

    /// Parse a phar archive from raw bytes.
    /// Returns `None` if the format is invalid or unsupported.
    pub fn parse(data: Vec<u8>) -> Option<Self> {
        // 1. Find the stub end marker.
        let marker_pos = find_marker(&data)?;

        // The manifest starts after the marker + a line ending (\r\n or \n).
        let after_marker = marker_pos + HALT_COMPILER_MARKER.len();
        let manifest_start = if data.get(after_marker..after_marker + 2) == Some(b"\r\n") {
            after_marker + 2
        } else if data.get(after_marker..after_marker + 1) == Some(b"\n") {
            after_marker + 1
        } else {
            return None;
        };

        let mut cursor = manifest_start;

        // 2. Parse the manifest header.
        let manifest_length = read_u32(&data, &mut cursor)? as usize;
        let manifest_end = manifest_start + 4 + manifest_length;
        if manifest_end > data.len() {
            return None;
        }

        let file_count = read_u32(&data, &mut cursor)? as usize;
        let _api_version = read_u16(&data, &mut cursor)?;
        let _global_flags = read_u32(&data, &mut cursor)?;

        // Alias: 4-byte length + alias bytes.
        let alias_len = read_u32(&data, &mut cursor)? as usize;
        if cursor + alias_len > data.len() {
            return None;
        }
        cursor += alias_len; // skip alias bytes

        // Metadata: 4-byte length + metadata bytes.
        let metadata_len = read_u32(&data, &mut cursor)? as usize;
        if cursor + metadata_len > data.len() {
            return None;
        }
        cursor += metadata_len; // skip metadata bytes

        // 3. Parse each file entry and build the index.
        //    We collect entries first, then compute offsets into the data area.
        struct RawEntry {
            filename: String,
            uncompressed_size: usize,
            compressed_size: usize,
            flags: u32,
        }

        let mut entries = Vec::with_capacity(file_count);

        for _ in 0..file_count {
            let filename_len = read_u32(&data, &mut cursor)? as usize;
            if cursor + filename_len > data.len() {
                return None;
            }
            let filename =