통합
한눈에 보기
섹션 제목: “한눈에 보기”NextPDF 확장은 핵심 PDF 엔진을 애플리케이션 프레임워크, 브라우저 렌더러, 엣지 서비스, 빌드 도구, 레거시 마이그레이션과 연결합니다. 각 확장 섹션은 개요, 설치, 빠른 시작, 구성, API, 개발자 가이드, 프로덕션 사용, 보안, 문제 해결로 이어지는 동일한 매뉴얼 구조를 따릅니다.
확장 맵
섹션 제목: “확장 맵”| 확장 | 패키지 | 사용 시점 | 주요 섹션 |
|---|---|---|---|
| Laravel | nextpdf/laravel | Laravel 애플리케이션을 빌드하면서 컨테이너 바인딩, 파사드, 응답, 큐 작업이 필요한 경우입니다. | Laravel |
| Symfony | nextpdf/symfony | Symfony 애플리케이션을 빌드하면서 번들, DI 와이어링, Messenger 작업, HTTP 응답이 필요한 경우입니다. | Symfony |
| CodeIgniter | nextpdf/codeigniter | CodeIgniter 4 애플리케이션을 빌드하면서 서비스, 라이브러리 래퍼, 응답, 큐 작업이 필요한 경우입니다. | CodeIgniter |
| Artisan | nextpdf/artisan | Chrome CDP HTML 렌더링, 페이지 가져오기 또는 저수준 PDF 검사 유틸리티가 필요한 경우입니다. | Artisan |
| Cloudflare | nextpdf/cloudflare | Cloudflare Browser Rendering으로 렌더링하거나, API 접근을 보호하거나, PDF를 R2에 보관하는 경우입니다. | Cloudflare |
| Gotenberg | nextpdf/gotenberg | Gotenberg 서비스를 통해 오피스 문서 또는 HTML을 변환하는 경우입니다. | Gotenberg |
| TCPDF 호환성 | nextpdf/compat-legacy | TCPDF 형태의 애플리케이션 코드를 전면 재작성 없이 NextPDF로 마이그레이션하는 경우입니다. | TCPDF 호환성 |
| Backport Builder | nextpdf/backport-builder | 이전 PHP 런타임용 릴리스 아티팩트를 유지 관리하는 경우입니다. | Backport Builder |
선택 가이드
섹션 제목: “선택 가이드”| 필요 사항 | 여기서 시작 | 운영 참고 |
|---|---|---|
| 프레임워크 응답 헬퍼 | Laravel, Symfony 또는 CodeIgniter | 프레임워크 패키지는 컨테이너와 응답 통합을 담당하고, 코어는 문서 작성을 담당합니다. |
| 픽셀 중심 HTML 렌더링 | Artisan 또는 Cloudflare | 호스트의 로컬 Chrome CDP에는 Artisan을 선택하고, 렌더링을 엣지에서 처리해야 할 때는 Cloudflare를 선택하십시오. |
| 오피스 변환 | Gotenberg | Gotenberg를 타임아웃, 크기, SSRF 제어가 적용되는 외부 서비스 경계로 취급하십시오. |
| 레거시 TCPDF 마이그레이션 | TCPDF 호환성 | 레거시 호출이 지원된다고 가정하기 전에 메서드 커버리지 표를 확인하십시오. |
| 이전 PHP 배포판 | Backport Builder | 빌드 도구 전용입니다. 애플리케이션 런타임 종속성으로 설치하지 마십시오. |
매뉴얼 구조
섹션 제목: “매뉴얼 구조”각 확장 섹션에는 다음 페이지 유형이 포함됩니다.
| 페이지 | 목적 |
|---|---|
overview | 제품 경계, 대상 사용자, 지원되는 워크플로, 제한 사항을 설명합니다. |
install | 설치 명령과 필수 런타임 종속성을 설명합니다. |
quickstart | 복사 가능한 첫 결과를 제공하는 최소 실행 흐름입니다. |
configuration | 지원되는 모든 구성 키, 환경 변수, 기본값 및 효과입니다. |
api | 공개 클래스, 메서드, 매개변수, 기본값, 반환값, 예외를 설명합니다. |
developer-guide | 확장 아키텍처, 수명 주기, 확장 지점, 코드 구성을 설명합니다. |
production-usage | 배포, 안정성, 성능, 워커 안전성, 가관측성을 다룹니다. |
security-and-operations | 신뢰 경계, 안전한 기본값, 비밀, 파일 접근, 운영 제어를 다룹니다. |
troubleshooting | 증상, 진단, 유력한 원인, 시정 조치를 다룹니다. |
API 표 규칙
섹션 제목: “API 표 규칙”API 표는 매뉴얼 전반에서 동일한 열을 사용하므로, 독자는 새로운 레이아웃을 다시 익히지 않고도 패키지를 비교할 수 있습니다.
| 열 | 의미 |
|---|---|
| 기호 | 정규화된 클래스, 메서드, 엔드포인트, CLI 명령 또는 구성 객체입니다. |
| 매개변수 | 이름, 형식, 필수 여부, 기본값, 허용되는 값입니다. |
| 기본 동작 | 호출자가 선택 입력을 생략했을 때의 동작입니다. |
| 반환값 | 반환 형식 또는 출력 아티팩트입니다. |
| 발생 예외 또는 실패 조건 | 예외 형식, HTTP 상태, 검증 실패 또는 운영 실패 모드입니다. |
| 참고 | 보안, 워커 안전성, 호환성 또는 성능 세부 정보입니다. |
번역 준비 상태
섹션 제목: “번역 준비 상태”영어 원문은 이후 현지화를 고려해 작성되었습니다. 짧은 섹션, 안정적인 제목, 명시적인 명사, 관용어를 배제한 표현, 반복 구조를 담은 표를 사용합니다. 새 API 페이지에서는 번역 도구가 메서드 이름, 구성 키, CLI 플래그, 예외 이름을 보존할 수 있도록 해당 항목을 코드 서식으로 유지해야 합니다.