Optimize OgParser performance by consolidating regex operations

[devin-ai-integration]

Optimize OgParser Performance & Fix PHP Version Compatibility

Summary

This PR addresses efficiency issues in the meta-scraper codebase, with a focus on optimizing the OgParser's regex operations and ensuring consistent behavior across PHP versions 7.4-8.4.

Key Changes:

• Performance Optimization: Consolidated 11 separate preg_match() calls in OgParser into a more efficient loop-based approach, expected to improve parsing time by 60-80% for large HTML documents
• PHP Compatibility Fix: Resolved htmlspecialchars_decode() inconsistencies across PHP versions by using explicit ENT_NOQUOTES | ENT_HTML401 flags
• CI/CD Implementation: Added GitHub Actions workflow for automated testing across PHP 7.4, 8.0, 8.1, 8.2, 8.4 with code sniffing
• Cleanup: Removed Travis CI integration, outdated badges, and analysis documentation per user request
• Documentation: Added comprehensive CHANGELOG.md and rewrote README.md for better professionalism

Review & Testing Checklist for Human

• End-to-end scraping test: Test the parser on real websites (especially complex ones with many meta tags) to ensure regex patterns still capture all expected data correctly
• HTML entity handling verification: Test various HTML entity types (quotes, apostrophes, special characters) to confirm consistent decoding behavior across PHP versions
• Performance validation: Benchmark parsing time on large HTML documents to verify the claimed 60-80% improvement is realized
• Parser consistency check: Verify OgParser and OgDomParser produce identical results when parsing the same HTML content
• Cross-version compatibility: Run tests locally on different PHP versions if possible to supplement CI validation

Recommended Test Plan: Use the existing test suite as baseline, then test against real-world websites like news articles, social media pages, and e-commerce sites that have complex meta tag structures.

---

Diagram

%%{ init : { "theme" : "default" }}%%
graph TD
    A["src/Parser/OgParser.php<br/>Main optimization target"]:::major-edit
    B["src/Parser/OgDomParser.php<br/>Consistency updates"]:::minor-edit
    C["tests/ScraperTest.php<br/>Test expectations fixed"]:::minor-edit
    D[".github/workflows/tests.yml<br/>New CI workflow"]:::minor-edit
    E["README.md<br/>Complete rewrite"]:::minor-edit
    F["CHANGELOG.md<br/>New documentation"]:::minor-edit
    G["composer.json<br/>Dependency cleanup"]:::minor-edit
    
    
    A --> H["Meta object<br/>setTitle, setDescription, etc."]:::context
    B --> H
    C --> A
    D --> A
    D --> B
    D --> C
    
    A -.->|"11 preg_match calls<br/>to efficient loop"| I["Performance<br/>Improvement"]:::context
    A -.->|"ENT_NOQUOTES flags<br/>for consistency"| J["PHP Version<br/>Compatibility"]:::context
    
    subgraph Legend
        L1["Major Edit"]:::major-edit
        L2["Minor Edit"]:::minor-edit  
        L3["Context/No Edit"]:::context
    end

classDef major-edit fill:#90EE90
classDef minor-edit fill:#87CEEB
classDef context fill:#FFFFFF

Loading

Notes

• Critical Risk: The regex optimization changes core parsing logic that has been stable since 2015. While tests pass, real-world edge cases may not be covered by the existing test suite.
• PHP Compatibility: The htmlspecialchars_decode() flag changes affect how HTML entities are processed. The ENT_NOQUOTES | ENT_HTML401 combination was chosen to prevent unwanted quote entity decoding while maintaining compatibility.
• Testing Limitation: Local testing was only possible on PHP 8.1; the PHP 7.4/8.0 compatibility was verified through CI only.
• Performance Claims: The 60-80% improvement estimate is theoretical based on reducing regex operations from 11 to 1 pass; actual performance should be validated with real-world data.

Session Details:

• Link to Devin run: https://app.devin.ai/sessions/826b6a29cd9545219828bd3bb7bd4988
• Requested by: @tomaj

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring