Pourquoi nous avons choisi DocRaptor ?

Notre choix s’est porté sur DocRaptor, une API de génération de PDF basée sur PrinceXML, réputée pour sa précision et sa conformité aux standards du web. Couplée à Drupal, cette solution nous a permis de répondre efficacement aux besoins du projet.

1. Une solution basée sur PrinceXML

DocRaptor utilise PrinceXML, un moteur de rendu HTML vers PDF reconnu pour sa fidélité au rendu web. Cela garantit que les PDF générés respectent parfaitement les styles CSS, les polices personnalisées et les mises en page complexes, sans compromis sur la qualité.

2. Une API simple et puissante

L’API de DocRaptor est conçue pour être intuitive et flexible. Elle permet de générer des PDF en envoyant une requête HTTP contenant du HTML ou une URL. 

Parmi ses atouts :

• La prise en charge des headers/footers dynamiques.

• La gestion des polices et des médias.

• La personnalisation avancée via les options PrinceXML.

3. Intégration native avec Drupal

Grâce au module DocRaptor maintenu par la communauté Drupal, l’intégration du service DocRaptor dans notre écosystème a été grandement simplifiée. Ce module offre une base solide pour générer des PDF directement depuis Drupal, tout en permettant des extensions personnalisées pour des besoins plus spécifiques.

Notre implémentation technique

1. Utilisation du module contrib DocRaptor

Le module communautaire DocRaptor est une solution clé en main pour générer des PDF à partir de contenu Drupal. Il permet notamment :

• De convertir des nœuds, des vues ou des templates Twig en PDF via une interface administrative simple.

• De configurer les options de rendu (polices, marges, headers/footers) directement depuis l’interface de Drupal.

• D’attacher les PDF générés aux entités (nœuds, utilisateurs, etc.) ou de les stocker dans la media library.

Pour notre projet, ce module nous a servi de point de départ. Il nous a permis de valider rapidement la faisabilité de la génération de PDF à partir de nos contenus, sans avoir à développer une solution from scratch.

2. Développement d’un module custom pour des besoins avancés

Si le module contrib couvre les cas d’usage basiques, notre projet nécessitait des fonctionnalités supplémentaires :

• Génération de PDF à partir de view_modes spécifiques : Nous avions besoin de produire des fiches produits PDF basées sur des affichages (view_modes) personnalisés, en fonction du type de produit ou de la marque.

• Gestion avancée du cache : Pour éviter de surcharger l’API DocRaptor et réduire les coûts, nous avons mis en place un système de cache intelligent. Les PDF sont régénérés uniquement lorsque le contenu source est mis à jour.

• Automatisation et scalabilité : Notre module permet de générer des PDF en masse, avec un système de files d’attente et de relances automatiques en cas d’échec.

Exemple de code (simplifié) :

// Génération d'un PDF à partir d'un view_mode spécifique
$entity = \Drupal::entityTypeManager()->getStorage('node')->load($nid);
$view_builder = \Drupal::entityTypeManager()->getViewBuilder('node');
$html = $view_builder->view($entity, 'product_sheet'); // 'product_sheet' est notre view_mode custom
// Appel à l'API DocRaptor via notre service custom
$docraptor = \Drupal::service('insign_docraptor.client');
$pdf = $docraptor->generatePdf([
  'doc' => (string) $html,
  'test' => FALSE,
  'prince_options' => [
    'media' => 'screen',
    'javascript' => TRUE,
  ],
]);
// Sauvegarde du PDF dans la media library avec gestion du cache
$file = file_save_data($pdf, 'public://product_sheets/product_' . $nid . '.pdf', FILE_EXISTS_REPLACE);
$media = \Drupal::entityTypeManager()->getStorage('media')->create([
  'bundle' => 'document',
  'name' => 'Fiche produit - ' . $entity->getTitle(),
  'field_media_document' => [
    'target_id' => $file->id(),
  ],
]);
$media->save();

3. Optimisation des performances

Pour garantir une utilisation efficace de DocRaptor, nous avons implémenté :

• Un système de cache : Les PDF sont stockés dans Drupal et réutilisés tant que le contenu source n’a pas changé.

• Des requêtes asynchrones : La génération de PDF est déclenchée en arrière-plan pour ne pas impacter l’expérience utilisateur.

• Un monitoring des appels API : Nous suivons le nombre de requêtes pour rester dans les limites de notre forfait et optimiser les coûts.

Les bénéfices pour notre projet

1. Gain de temps et de productivité

Avec DocRaptor et notre module custom, nous avons pu :

• Automatiser la génération de fiches produits à partir de données dynamiques.

• Réduire le temps de développement grâce à une API fiable et une intégration Drupal optimisée.

• Simplifier la maintenance : Plus besoin de gérer des bibliothèques de génération de PDF côté serveur.

2. Qualité et conformité des PDF

Les PDF générés avec DocRaptor sont :

• Fidèles au rendu HTML (pas de surprise de mise en page).

• Compatibles avec les standards (PDF/A, accessibilité, etc.).

• Optimisés pour l’impression et le partage.

3. Réduction des coûts

Grâce à notre système de cache et à l’optimisation des appels API, nous avons pu limiter significativement le nombre de requêtes vers DocRaptor, ce qui se traduit par des économies substantielles.

Pourquoi recommandons-nous DocRaptor et son module Drupal ?

1. Pour les développeurs

• API simple et efficace : Intégration rapide, même dans des stacks techniques complexes.

• Module contrib prêt à l’emploi : Le module DocRaptor pour Drupal permet de démarrer rapidement, avec la possibilité d’étendre ses fonctionnalités via du code custom.

• Documentation complète : Exemples clairs, SDK disponibles pour plusieurs langages.

2. Pour les entreprises

• Solution scalable : Adaptée aux petits comme aux grands volumes de PDF.

• Coût maîtrisé : Modèle de tarification transparent et possibilité de réduire les coûts via des optimisations techniques.

• Qualité professionnelle : Les PDF générés sont d’une qualité irréprochable, un besoin important dans le cadre de ce projet.

Conclusion

Notre expérience avec DocRaptor et son module Drupal sur le projet a été extrêmement positive. Le module contrib Drupal nous a permis de démarrer rapidement, tandis que notre module custom a apporté la flexibilité et les performances nécessaires pour répondre aux exigences du projet.

L’API de DocRaptor, son module Drupal et son support en font un partenaire de choix pour les projets exigeants.