shipfastlabs/parsel

해결하는 문제

Parsel은 Markdown, 일반 텍스트, 구조화된 데이터와 같은 형식으로 문서를 파싱하기 위한 통합 PHP API를 제공합니다. 다양한 문서 파싱 도구에 대해 별도의 통합을 작성할 필요 없이, 여러 교체 가능한 드라이버 간에서 작동하는 단일하고 표현력이 풍부한 인터페이스를 제공합니다.

작동 방식

Parsel은 다양한 문서 파싱 엔진(드라이버)을 래핑하는 역할을 합니다. 로컬 드라이버인 LiteParse와 AnyDoc를 지원하며, 전용 설치 프로그램을 통해 설치할 수 있습니다. 사용자는 드라이버를 전환하거나 프로세스 전역 기본값을 설정하여 PDF, DOCX, EPUB, CSV 등의 다양한 파일 형식과 출력 형식을 처리할 수 있습니다. 또한 Driver 계약을 통해 사용자 정의 드라이버를 구현할 수 있어 원격 API나 다른 도구와의 통합이 가능합니다.

대상 사용자

특정 파서나 제공자에 종속되지 않고 애플리케이션에 문서 파싱 및 OCR 기능을 통합하고자 하는 PHP 개발자.

주요 특징

• 교체 가능한 드라이버: LiteParse와 AnyDoc를 기본으로 지원하며, 사용자 정의 드라이버를 위한 확장 가능한 아키텍처를 제공합니다.
• 유연한 출력: 문서를 Markdown, 일반 텍스트, JSON, 또는 좌표가 포함된 구조화된 페이지로 변환할 수 있습니다.
• 고급 파싱 옵션: OCR, DPI 설정, 페이지 범위 선택, 문서에서 스크린샷 생성을 지원합니다.
• 세부 제어: LiteParseOptions와 같은 타입 안정적인 옵션을 제공하여 이미지 삽입, 헤더/푸터 보존과 같은 세부 동작을 관리할 수 있습니다.
• 지연 로딩: lazyPages()를 사용해 대용량 문서를 스트리밍 처리하여 메모리 오버헤드를 방지할 수 있습니다.
• 테스트 유틸리티: 테스트를 위해 파싱 응답을 모킹할 수 있는 Parsel::fake() 메서드를 제공합니다.