Presentazione di pdf-service: Un Microservizio di Generazione PDF con Symfony 7

Sono entusiasta di presentare pdf-service, un nuovo progetto open source che ho appena pubblicato su GitHub. È un microservizio moderno ed efficiente per generare PDF da contenuti HTML, costruito con Symfony 7.2 e Chrome Headless.

🚀 Caratteristiche Principali

• Basato su Symfony 7.2 e FrankenPHP
• Utilizza Chrome Headless tramite browserless/chrome
• Architettura Esagonale
• API REST semplice e intuitiva
• Containerizzazione Docker completa
• Applicazione demo Next.js 15 inclusa

💡 Casi d'Uso

• Generazione di fatture
• Esportazione di report
• Creazione di documenti da template HTML
• Archiviazione di pagine web in PDF
• Generazione di certificati e dichiarazioni

🛠️ Tecnologie Utilizzate

• Backend: Symfony 7.2, PHP 8.2+
• Server: FrankenPHP
• PDF: Chrome Headless (browserless)
• Demo: Next.js 15 con Bun
• Containerizzazione: Docker & Docker Compose

🔧 Installazione Rapida

bash
1# Clona il repository
2git clone https://github.com/offroadlabs/pdf-service.git
3cd pdf-service
4
5# Copia il file di ambiente
6cp .env .env.local
7
8# Avvia i container
9docker compose up -d

📝 Esempio di Utilizzo

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}'

🎯 Punti di Forza

• Prestazioni: Ottimizzato per una generazione rapida di PDF
• Flessibilità: Ampie opzioni di configurazione
• Modernità: Utilizzo delle ultime versioni tecnologiche
• Manutenibilità: Architettura esagonale e test automatizzati
• Sicurezza: Rigorosa validazione degli input e gestione degli errori
• Documentazione: Documentazione completa ed esempi di utilizzo

🔜 Prossimamente

Ho in programma di pubblicare presto un articolo tecnico dettagliato che spiegherà in profondità:

• Architettura del progetto
• Scelte tecniche
• Pattern utilizzati
• Best practice implementate
• Casi d'uso avanzati
• Possibili ottimizzazioni

🤝 Contribuire

Il progetto è open source sotto licenza MIT. Sentiti libero di:

• ⭐ Mettere una stella al repository
• 🐛 Segnalare bug
• 💡 Suggerire miglioramenti
• 🔧 Contribuire al codice

📚 Maggiori Informazioni

Per maggiori dettagli, consulta:

• Il repository GitHub
• La documentazione nel README
• L'applicazione demo inclusa

Seguirà presto un articolo tecnico dettagliato per spiegare in profondità tutti gli aspetti del progetto. Resta sintonizzato! 🚀