Installation

Prérequis système

Prérequis	Version	Objectif
PHP	^8.5	Readonly classes, backed enums, pipe operator, #[\SensitiveParameter]
ext-openssl	*	Chiffrement AES-256, signatures PKCS#7, requêtes OCSP/TSA
ext-zlib	*	Compression Flate pour les flux PDF
ext-mbstring	*	Gestion des chaînes Unicode
ext-gd	*	Traitement d'images (JPEG, PNG, WebP, AVIF)
ext-curl	*	Requêtes HTTP vers les répondeurs OCSP et serveurs TSA
ext-intl	*	Césure ICU et formatage locale

Vérifiez toutes les extensions :

php -r "foreach(['openssl','zlib','mbstring','gd','curl','intl'] as \$e){echo \$e.': '.(extension_loaded(\$e)?'OK':'MISSING').PHP_EOL;}"

Installation rapide

Core uniquement

composer require yeeefang/tcpdf-next

+ Laravel

composer require yeeefang/tcpdf-next yeeefang/tcpdf-next-laravel

+ Symfony

composer require yeeefang/tcpdf-next yeeefang/tcpdf-next-symfony

+ Artisan

composer require yeeefang/tcpdf-next yeeefang/tcpdf-next-artisan

Stack complet

composer require yeeefang/tcpdf-next yeeefang/tcpdf-next-pro yeeefang/tcpdf-next-artisan yeeefang/tcpdf-next-laravel

Package Core

composer require yeeefang/tcpdf-next

Dépendances : phpseclib/phpseclib ^3.0 (RSASSA-PSS, ASN.1, X.509)

Extensions fonctionnelles

Package Artisan (Chrome CDP)

composer require yeeefang/tcpdf-next-artisan

Prérequis supplémentaires :

• chrome-php/chrome ^1.15
• Navigateur Chrome ou Chromium installé sur le système

# Ubuntu/Debian
apt-get install chromium-browser

# macOS
brew install --cask chromium

# Ou utilisez une variable d'environnement
export CHROME_PATH=/usr/bin/google-chrome

Package Pro (Commercial)

composer require yeeefang/tcpdf-next-pro

Licence : 1 000 $ USD par application, perpétuelle par version majeure.

Dépendances supplémentaires : phpseclib/phpseclib ^3.0 | Optionnel : ext-pkcs11

Définissez votre clé de licence :

# .env
TCPDF_PRO_LICENSE_KEY=your-license-key

Intégrations framework

Package Laravel

composer require yeeefang/tcpdf-next-laravel

Prérequis : Laravel ^12.0

Le ServiceProvider est auto-découvert. Publiez la configuration :

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

Package Symfony

composer require yeeefang/tcpdf-next-symfony

Prérequis : Symfony ^7.0

Le Bundle est auto-configuré. Enregistrez manuellement si nécessaire :

// config/bundles.php
return [
    // ...
    Yeeefang\TcpdfNext\Symfony\TcpdfNextBundle::class => ['all' => true],
];

Package CodeIgniter

composer require yeeefang/tcpdf-next-codeigniter

Prérequis : CodeIgniter ^4.0

Enregistrez le service dans votre app/Config/Services.php ou utilisez l'auto-découverte.

Compatibilité

Package Adaptation (Migration TCPDF)

composer require yeeefang/tcpdf-next-adaptation

Adaptateur de remplacement plug-and-play pour TCPDF 6.2.13 — mappe 252 méthodes legacy vers l'API moderne de TCPDF-Next. Supporte les overrides Header() / Footer() via une classe non-final et les classes helper legacy (TCPDF_STATIC, TCPDF_FONTS, TCPDF_COLORS, TCPDF_IMAGES).

Configuration Docker

🐳 Docker for Legacy PHP Environments

Si votre serveur de production exécute PHP < 8.5, utilisez Docker pour isoler TCPDF-Next.

FROM php:8.5-cli

RUN apt-get update && apt-get install -y \
    libicu-dev libpng-dev libjpeg-dev libwebp-dev libzip-dev \
    && docker-php-ext-configure gd --with-jpeg --with-webp \
    && docker-php-ext-install gd intl zip

COPY --from=composer:latest /usr/bin/composer /usr/bin/composer

COPY . /app
WORKDIR /app
RUN composer install --no-dev --optimize-autoloader

Pour Chrome (package Artisan) :

FROM php:8.5-cli

RUN apt-get update && apt-get install -y \
    libicu-dev libpng-dev libjpeg-dev libwebp-dev chromium \
    && docker-php-ext-configure gd --with-jpeg --with-webp \
    && docker-php-ext-install gd intl

ENV CHROME_PATH=/usr/bin/chromium

COPY --from=composer:latest /usr/bin/composer /usr/bin/composer
COPY . /app
WORKDIR /app
RUN composer install --no-dev --optimize-autoloader

Vérifier l'installation

<?php
require 'vendor/autoload.php';

use Yeeefang\TcpdfNext\Core\Document;

$pdf = Document::createStandalone()->addPage()->setFont('Helvetica', '', 12)->cell(0, 10, 'OK');
echo "TCPDF-Next is working. Classes loaded: " . count(get_declared_classes()) . "\n";