시작하기

TCPDF-Next는 PDF 2.0 문서를 생성하기 위한 모던 PHP 8.5+ 라이브러리입니다. 이 가이드는 처음부터 첫 번째 PDF까지 5분 만에 안내합니다.

요구사항

요구사항	최소 버전
PHP	8.5+
확장	openssl, zlib, mbstring, gd, curl, intl
Composer	2.x

설치

composer require yeeefang/tcpdf-next

220개 이상의 소스 파일이 포함된 Core 패키지가 설치됩니다.

선택적 패키지

# Chrome CDP HTML 렌더러 (픽셀 퍼펙트 CSS3)
composer require yeeefang/tcpdf-next-artisan

# 프레임워크 통합
composer require yeeefang/tcpdf-next-laravel        # Laravel 12
composer require yeeefang/tcpdf-next-symfony         # Symfony 7
composer require yeeefang/tcpdf-next-codeigniter     # CodeIgniter 4

# TCPDF 6.2.13 하위 호환 어댑터
composer require yeeefang/tcpdf-next-adaptation

# 프로페셔널 기능 (상용 라이선스)
composer require yeeefang/tcpdf-next-pro

첫 번째 PDF

<?php

require 'vendor/autoload.php';

use Yeeefang\TcpdfNext\Core\Document;

$pdf = Document::createStandalone()
    ->setTitle('My First PDF')
    ->setAuthor('TCPDF-Next')
    ->addPage()
    ->setFont('Helvetica', '', 16)
    ->cell(0, 10, 'Hello, PDF 2.0!')
    ->ln()
    ->setFont('Helvetica', '', 12)
    ->cell(0, 10, 'Generated with TCPDF-Next')
    ->save('hello.pdf');

echo "PDF saved to hello.pdf\n";

실행:

php hello.php

PDF 생성 흐름

graph LR
    A[Create Document] --> B[Set Metadata]
    B --> C[Add Page]
    C --> D[Set Font]
    D --> E[Draw Content]
    E --> F{More Pages?}
    F -->|Yes| C
    F -->|No| G[Save / Output]

다음 단계

• 설치 — 시스템 요구사항, 확장 검증, Docker 설정
• 설정 — 기본 설정, 폰트 경로, 암호화 옵션
• 기본 사용법 — 페이지, 텍스트, 폰트, 이미지, 출력
• Core 패키지 — 220개 이상 소스 파일 전체 문서
• Laravel 통합 — Facade, 응답, 큐 작업
• Symfony 통합 — Bundle, PdfFactory, Messenger
• CodeIgniter 통합 — Services, Library, Queue
• TCPDF 마이그레이션 — TCPDF 6.2.13 드롭인 어댑터