Présentation de pdf-service : Un microservice de génération PDF avec Symfony 7

03 janvier 2025

Disponible en :

Je suis ravi de vous présenter aujourd'hui pdf-service, un nouveau projet open source que je viens de publier sur GitHub. Il s'agit d'un microservice moderne et performant pour la génération de PDFs à partir de contenu HTML, construit avec Symfony 7.2 et Chrome Headless.

🚀 Principales caractéristiques

Basé sur Symfony 7.2 et FrankenPHP
Utilise Chrome Headless via browserless/chrome
Architecture Hexagonale
API REST simple et intuitive
Conteneurisation complète avec Docker
Application de démo Next.js 15 incluse

💡 Cas d'utilisation

Génération de factures
Export de rapports
Création de documents à partir de templates HTML
Archivage de pages web en PDF
Génération de bulletins et attestations

🛠️ Technologies utilisées

Backend : Symfony 7.2, PHP 8.2+
Serveur : FrankenPHP
PDF : Chrome Headless (browserless)
Demo : Next.js 15 avec Bun
Conteneurisation : Docker & Docker Compose

🔧 Installation rapide

bash
1# Cloner le repository
2git clone https://github.com/offroadlabs/pdf-service.git
3cd pdf-service
4
5# Copier le fichier d'environnement
6cp .env .env.local
7
8# Lancer les conteneurs
9docker compose up -d

📝 Exemple d'utilisation

bash
1curl -X POST \
2  'https://localhost/api/pdf/generate' \
3  -H 'Content-Type: application/json' \
4  -k \
5  -o document.pdf \
6  -d '{
7    "html": "<h1>Hello World</h1>",
8    "options": {
9        "format": "A4",
10        "orientation": "portrait"
11    }
12}'

🎯 Points forts

Performance : Optimisé pour la génération rapide de PDFs
Flexibilité : Options de configuration étendues
Moderne : Utilisation des dernières versions des technologies
Maintenable : Architecture hexagonale et tests automatisés
Sécurisé : Validation stricte des entrées et gestion des erreurs
Documenté : Documentation complète et exemples d'utilisation

🔜 À venir

Je prévois de publier prochainement un article technique détaillé qui expliquera en profondeur :

L'architecture du projet
Les choix techniques
Les patterns utilisés
Les bonnes pratiques implémentées
Les cas d'utilisation avancés
Les optimisations possibles

🤝 Contribution

Le projet est open source sous licence MIT. N'hésitez pas à :

⭐ Star le repository
🐛 Signaler des bugs
💡 Proposer des améliorations
🔧 Contribuer au code

📚 Plus d'informations

Pour plus de détails, consultez :

Le repository GitHub
La documentation dans le README
L'application de démo incluse

Un article technique détaillé suivra bientôt pour expliquer en profondeur tous les aspects du projet. Stay tuned! 🚀

Vous avez des questions ou des suggestions ? N'hésitez pas à ouvrir une issue sur GitHub ou à me contacter directement via LinkedIn.

Lectures recommandées

Poursuivez avec ces articles complémentaires sur le même sujet.

31 déc. 2024FrankenPHP : Boostez les performances de vos applications Symfony en 2025

Découvrez comment FrankenPHP, le nouveau serveur applicatif PHP écrit en Go, peut multiplier par 4 les performances de vos applications Symfony grâce au mode worker et aux Early Hints.

31 janv. 2026OpenClaw : le homard spatial qui veut gérer ta vie (et pourquoi tu devrais avoir peur)

OpenClaw est l'assistant IA open source qui a explosé en janvier 2026. Capable de gérer tes mails, ton agenda et même de réserver tes vols, ce projet a aussi changé de nom trois fois en deux mois. Plongée dans l'univers d'un agent IA puissant... et potentiellement dangereux.

11 janv. 2026Minisforum et l'IA locale : petit boîtier, grosse ambition

Un mini-PC IA signé Minisforum, des usages locaux qui évitent le cloud, et un cluster possible sans vendre un rein.

🔧 Installation rapide

bash

1# Cloner le repository
2git clone https://github.com/offroadlabs/pdf-service.git
3cd pdf-service
4
5# Copier le fichier d'environnement
6cp .env .env.local
7
8# Lancer les conteneurs
9docker compose up -d

📝 Exemple d'utilisation

bash

1curl -X POST \
2  'https://localhost/api/pdf/generate' \
3  -H 'Content-Type: application/json' \
4  -k \
5  -o document.pdf \
6  -d '{
7    "html": "<h1>Hello World</h1>",
8    "options": {
9        "format": "A4",
10        "orientation": "portrait"
11    }
12}'

🎯 Points forts

Performance : Optimisé pour la génération rapide de PDFs

Flexibilité : Options de configuration étendues

Moderne : Utilisation des dernières versions des technologies

Maintenable : Architecture hexagonale et tests automatisés

Sécurisé : Validation stricte des entrées et gestion des erreurs

Documenté : Documentation complète et exemples d'utilisation