예제 개요
실제 시나리오에서 TCPDF-Next를 사용하는 방법을 보여주는 실용적이고 복사-붙여넣기 가능한 예제를 탐색합니다. 모든 예제는 플루언트 API 패턴을 사용하며 PHP 8.5+를 대상으로 합니다.
시작하기
예제를 실행하기 전에 TCPDF-Next가 설치되어 있는지 확인하세요:
bash
composer require tcpdf-next/tcpdf-next모든 예제는 다음 기본 임포트를 가정합니다:
php
use TcpdfNext\Document;기본 예제 초급
기본적인 PDF 작업 -- 첫 TCPDF-Next 프로젝트에 완벽합니다.
| 예제 | 설명 |
|---|---|
| Hello World | 단일 플루언트 체인으로 첫 PDF를 생성 |
| 텍스트 서식 | Alignment enum을 통한 폰트, 크기, 스타일, 색상, 정렬 |
| 테이블 | writeHtml()로 스타일이 적용된 헤더, colspan / rowspan이 있는 HTML 테이블 렌더링 |
| 이미지 | 위치 지정 및 스케일링으로 JPEG, PNG, SVG 이미지 임베딩 |
| 다중 페이지 문서 | 자동 페이지 나누기, 수동 페이지, 머리글, 바닥글, 페이지 번호 매기기 |
중급 예제 중급
머리글, 워터마크, HTML 변환, 바코드로 기본을 확장합니다.
| 예제 | 설명 |
|---|---|
| 머리글 & 바닥글 | 콜백을 통한 커스텀 반복 머리글 및 바닥글 |
| 워터마크 | 투명도가 있는 텍스트 및 이미지 워터마크 |
| 목차 | 북마크를 사용한 자동 생성 목차 |
| HTML to PDF | 리치 HTML/CSS 콘텐츠를 PDF로 변환 |
| 바코드 & QR 코드 | 1D 및 2D 바코드 생성 |
고급 예제 고급
프로덕션급 기능: 디지털 서명, 암호화, 아카이브 규정 준수, 대화형 폼.
| 예제 | 설명 |
|---|---|
| 디지털 서명 | PKCS#12 인증서를 사용한 PAdES B-B 서명 |
| PAdES B-LTA 워크플로 | 타임스탬프를 사용한 장기 검증 |
| PDF/A-4 아카이브 | ISO 19005-4 준수 아카이브 문서 |
| AES-256 암호화 | 비밀번호 기반 AES-256 문서 암호화 |
| 폼 필드 | 대화형 텍스트 필드, 체크박스, 드롭다운 |
Laravel 예제 Laravel
파사드, 응답, 큐 잡으로 TCPDF-Next를 Laravel 애플리케이션에 통합합니다.
| 예제 | 설명 |
|---|---|
| 인보이스 생성 | Pdf 파사드를 통한 전문 인보이스 PDF |
| 차트가 있는 리포트 | 다중 페이지 리포트에 차트 이미지 임베딩 |
| 배치 PDF 큐 | GeneratePdfJob을 사용한 큐 기반 배치 생성 |
| 서명된 계약서 | 계약서 생성 및 디지털 서명 |
플루언트 API
이 사이트의 모든 예제는 TCPDF-Next의 플루언트 메서드 체이닝 API를 사용합니다. 모든 setter 및 action 메서드는 static을 반환하므로, 표현력 있고 읽기 쉬운 PDF 생성 코드를 작성할 수 있습니다:
php
Document::create()
->setTitle('My Document')
->addPage()
->setFont('helvetica', size: 14)
->cell(0, 10, 'Hello World')
->save('output.pdf');