Cấu hình Laravel

Mọi tùy chọn nằm trong config/tcpdf-next.php. Publish bằng lệnh:

php artisan vendor:publish --tag=tcpdf-next-config

Mặc định trang

'page' => [
    'format'      => env('TCPDF_PAGE_FORMAT', 'A4'),
    'orientation'  => 'portrait',   // 'portrait' | 'landscape'
    'unit'         => 'mm',         // 'mm' | 'pt' | 'cm' | 'in'
    'margin'       => ['top' => 20.0, 'right' => 15.0, 'bottom' => 20.0, 'left' => 15.0],
],

Key	Biến Env	Mặc định	Mô tả
page.format	TCPDF_PAGE_FORMAT	A4	Kích thước trang ISO (A4, Letter, Legal, v.v.)
page.orientation	--	portrait	Hướng trang mặc định
page.unit	--	mm	Đơn vị cho mọi giá trị tọa độ

Cấu hình Font

'fonts' => [
    'directory'      => resource_path('fonts'),
    'cache'          => storage_path('framework/cache/tcpdf-next/fonts'),
    'default_family' => 'Helvetica',
    'default_size'   => 11.0,
    'subset'         => true,
],

Key	Mặc định	Mô tả
fonts.directory	resource_path('fonts')	Đường dẫn tới file font TTF/OTF tùy chỉnh
fonts.cache	storage_path('.../fonts')	Cache font metric đã biên dịch
fonts.default_family	Helvetica	Font family khi không chỉ định
fonts.default_size	11.0	Kích thước font mặc định tính bằng point
fonts.subset	true	Chỉ nhúng glyph đã dùng để giảm kích thước file

Tuân thủ PDF/A

'pdfa' => [
    'enabled'       => env('TCPDF_PDFA', false),
    'version'       => 'PDF/A-4',
    'output_intent' => 'sRGB',
],

Key	Biến Env	Mặc định	Mô tả
pdfa.enabled	TCPDF_PDFA	false	Bật tuân thủ PDF/A
pdfa.version	--	PDF/A-4	Phiên bản PDF/A đích
pdfa.output_intent	--	sRGB	ICC output intent profile

Cài đặt mã hóa

'encryption' => [
    'level'       => 'aes-256',
    'user_pass'   => env('TCPDF_USER_PASS', ''),
    'owner_pass'  => env('TCPDF_OWNER_PASS', ''),
    'permissions' => ['print', 'copy'],
],

Key	Mặc định	Mô tả
encryption.level	aes-256	Thuật toán: aes-256, aes-128, rc4-128
encryption.user_pass	''	Mật khẩu để mở document
encryption.owner_pass	''	Mật khẩu để thay đổi quyền
encryption.permissions	['print', 'copy']	Cho phép: print, copy, modify, annotate

Cài đặt chữ ký số

'signature' => [
    'enabled'   => env('TCPDF_SIGN_ENABLED', false),
    'cert_path' => env('TCPDF_SIGN_CERT', ''),
    'key_path'  => env('TCPDF_SIGN_KEY', ''),
    'key_pass'  => env('TCPDF_SIGN_KEY_PASS', ''),
    'level'     => env('TCPDF_SIGN_LEVEL', 'B-B'),
    'tsa_url'   => env('TCPDF_TSA_URL', ''),
],

Key	Biến Env	Mặc định	Mô tả
signature.enabled	TCPDF_SIGN_ENABLED	false	Bật ký tự động
signature.cert_path	TCPDF_SIGN_CERT	''	Đường dẫn tới certificate PEM
signature.key_path	TCPDF_SIGN_KEY	''	Đường dẫn tới private key PEM
signature.level	TCPDF_SIGN_LEVEL	B-B	Cấp PAdES (B-B, B-T, B-LT, B-LTA)
signature.tsa_url	TCPDF_TSA_URL	''	URL timestamp authority RFC 3161

Cấu hình Queue

'queue' => [
    'connection' => env('TCPDF_QUEUE_CONNECTION', null),
    'queue'      => env('TCPDF_QUEUE', 'pdf'),
    'disk'       => env('TCPDF_DISK', 'local'),
    'tries'      => 3,
    'backoff'    => 30,
    'timeout'    => 120,
],

Key	Biến Env	Mặc định	Mô tả
queue.connection	TCPDF_QUEUE_CONNECTION	null	Queue connection (null = mặc định)
queue.queue	TCPDF_QUEUE	pdf	Tên queue cho PDF job
queue.disk	TCPDF_DISK	local	Filesystem disk mặc định cho output
queue.tries	--	3	Số lần retry tối đa
queue.backoff	--	30	Giây giữa các lần retry
queue.timeout	--	120	Timeout job tính bằng giây

Bước tiếp theo

• Tổng quan — Kiến trúc package và service provider binding
• Pdf Facade — Cách giá trị config áp dụng cho document mới
• Queue Job — Cấu hình queue trong thực tế