NextPDF 시작하기

한눈에 보기

NextPDF는 ISO 32000-2로 정의된 파일 형식인 PDF 2.0 문서를 생성하고 검사하는 PHP 8.4 엔진입니다. 타입이 지정된 플루언트 API로 문서를 구성합니다. HTML과 CSS를 페이지로 렌더링합니다. 출력물에 서명하고 보관하며, 구조화된 콘텐츠를 다시 읽어 들입니다. 이 모든 작업은 PHP에서 실행되며, 핵심 경로에는 외부 바이너리가 필요하지 않습니다.

이 프로젝트는 네 가지 배포판으로 제공됩니다. 각 배포판은 내부적으로 동일한 엔진을 공유하므로, 작업 방식에 맞는 배포판을 설치하면 됩니다.

배포판	패키지	설치 시점
NextPDF 코어 (OSS)	`nextpdf/core`	PHP를 작성하며, 프레임워크와 함께 또는 단독으로 엔진을 직접 사용하려는 경우.
NextPDF 서버 (OSS)	`nextpdf/server`	MCP, REST, gRPC를 통해 엔진을 노출하는 독립형 서비스를 원하는 경우.
NextPDF Pro 에디션	`nextpdf/premium` (Pro 등급)	디지털 서명, PDF/A 보관 또는 전자 송장 출력이 필요한 경우.
NextPDF Enterprise 에디션	`nextpdf/premium` (Enterprise 등급)	하드웨어 기반 서명, 적격 서명, 전체 규정 준수 기능이 필요한 경우.

NextPDF Pro와 NextPDF Enterprise는 동일한 nextpdf/premium 패키지의 두 가지 라이선스 등급입니다. 코어 엔진은 해당 패키지의 존재 여부와 관계없이 동일하게 실행됩니다.

한 줄로 설치하기

순수 PHP 프로젝트라면 Composer로 코어 엔진을 설치합니다.

composer require nextpdf/core

이 단일 패키지만으로 추가 설정 없이 PDF를 생성하고 검사할 수 있습니다. 프레임워크 통합, HTML 렌더러, 서버, Python SDK는 각각 그 위에 패키지 하나를 추가하는 방식입니다. 설치 가이드에 모든 명령어가 정리되어 있습니다.

경로 선택

NextPDF는 기존 코드에 맞춰 사용할 수 있습니다. 스택에 맞는 진입점을 선택한 다음 해당 타일을 따라가세요.

설치 전체 설치 매트릭스: 코어, 프레임워크 통합, HTML 렌더러, 서버, 그리고 Python SDK.

첫 PDF 만들기 PHP 에서 PDF 를 생성한 다음 HTML 을 PDF 로 렌더링하는 짧은 튜토리얼.

경로 선택하기 코어, 프레임워크, 서버 중 무엇을 선택할지, 그리고 어떤 HTML 렌더러를 사용할지에 대한 결정 가이드.

통합 프레임워크 어댑터, 브라우저 렌더러, 엣지 서비스, 그리고 마이그레이션 패키지.

다음 단계

첫 문서를 생성한 후에는 다음 세 가지가 문서의 주요 영역입니다.

가이드 및 통합 프레임워크, 렌더러, 런타임, 또는 마이그레이션 대상에 맞는 패키지를 운영하세요 — Laravel, Symfony, CodeIgniter, Artisan, Cloudflare, Gotenberg.

API 레퍼런스 검증된 엔진 기능: 클래스, 메서드, 구성 키, 그리고 CSS 지원 매트릭스.

쿡북 작업 중심의 레시피 — HTML 을 PDF 로 렌더링하고, CSS 로 스타일을 지정하고, 표를 배치하고, 긴 콘텐츠를 페이지로 나눕니다.

왜 별도의 서버인가요?

서버 배포판인 NextPDF Server는 PHP가 아닌 서비스, 에이전트 또는 다른 런타임이 라이브러리를 링크하는 대신 네트워크 프로토콜을 통해 엔진을 호출해야 할 때 설치하세요. Python SDK는 해당 서버를 위한 타입이 지정된 클라이언트입니다.