Avant de commencer : prérequis et installation

Pour suivre ce guide, vous avez besoin de :

• PHP 7.4 ou version supérieure installé sur votre machine de développement ou serveur.
• Composer pour la gestion des dépendances.
• Un compte GroupDocs Cloud (ID client et secret client) – vous pouvez en créer un sur le portail GroupDocs.
• Un espace disque suffisant pour le PDF source et le fichier DOCX résultant.

Installez la bibliothèque avec Composer :

composer require groupdocs-conversion-cloud

Téléchargez le dernier package ou consultez le source sur GitHub : URL de téléchargement. Après l’installation, vous êtes prêt à commencer à coder.

Conversion de documents PDF en DOCX avec PHP - Construction étape par étape

Voici un guide concis qui montre chaque opération essentielle. Le code source complet apparaît plus tard dans la section Implémentation PHP complète pour la conversion de documents en DOCX.

Étape 1 : Charger le PDF source

Créez une instance ConversionApi et pointez‑la vers le PDF que vous souhaitez convertir.

use GroupDocs\Conversion\Configuration;
use GroupDocs\Conversion\Api\ConversionApi;

$config = new Configuration('YOUR_CLIENT_ID', 'YOUR_CLIENT_SECRET');
$api = new ConversionApi($config);
$sourcePath = 'input.pdf';

Étape 2 : Initialiser les paramètres de conversion

Définissez le format de sortie et le chemin de destination. La classe ConvertOptions vous permet d’ajuster finement les limites de mémoire pour les gros PDF, ce qui améliore les performances de conversion PDF vers DOCX en PHP.

use GroupDocs\Conversion\Model\ConvertOptions;

$options = new ConvertOptions();
$options->setFilePath($sourcePath);
$options->setOutputPath('output.docx');
$options->setFormat('docx');
// Optional: $options->setMemoryLimit(1024); // in MB

Étape 3 : Exécuter la conversion

Envoyez la requête au service cloud. Cet appel d’API unique effectue le travail lourd.

use GroupDocs\Conversion\Model\Requests\ConvertDocumentRequest;

$request = new ConvertDocumentRequest($options);
$api->convertDocument($request);

Étape 4 : Récupérer le résultat

Le fichier DOCX converti est enregistré dans le chemin que vous avez spécifié. Vous pouvez maintenant le fournir à l’utilisateur ou le stocker pour un traitement ultérieur.

echo "Conversion completed. DOCX saved to output.docx";

Étape 5 : Nettoyer les ressources

Libérez l’instance de l’API si vous exécutez de nombreuses conversions dans une boucle. Réutiliser la même instance est plus efficace pour un microservice de conversion PDF en DOCX en PHP.

unset($api);

Implémentation PHP complète pour la conversion de documents en DOCX

Le code suivant regroupe toutes les étapes en un seul script exécutable.

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

use GroupDocs\Conversion\Configuration;
use GroupDocs\Conversion\Api\ConversionApi;
use GroupDocs\Conversion\Model\ConvertOptions;
use GroupDocs\Conversion\Model\Requests\ConvertDocumentRequest;

// ==== Configuration ====
$clientId = 'YOUR_CLIENT_ID';
$clientSecret = 'YOUR_CLIENT_SECRET';
$config = new Configuration($clientId, $clientSecret);
$api = new ConversionApi($config);

// ==== Input / Output ====
$sourcePath = __DIR__ . '/input.pdf';
$outputPath = __DIR__ . '/output.docx';

// ==== Conversion Options ====
$options = new ConvertOptions();
$options->setFilePath($sourcePath);
$options->setOutputPath($outputPath);
$options->setFormat('docx');
// Example of performance tuning
$options->setMemoryLimit(1024); // 1 GB

// ==== Convert ====
$request = new ConvertDocumentRequest($options);
try {
    $api->convertDocument($request);
    echo "PDF successfully converted to DOCX. File saved at: $outputPath\n";
} catch (Exception $e) {
    echo "Conversion failed: " . $e->getMessage() . "\n";
}

// ==== Cleanup ====
unset($api);
?>

Remarque : Cet exemple de code démontre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez‑vous de mettre à jour les chemins de fichiers (input.pdf, output.docx, etc.) pour qu’ils correspondent à vos emplacements réels, vérifiez que toutes les dépendances requises sont correctement installées et testez soigneusement dans votre environnement de développement. Si vous rencontrez des problèmes, veuillez consulter la documentation officielle ou vous rendre sur le forum d’assistance pour obtenir de l’aide.

Exécution de la conversion de documents via l’API REST avec cURL

Si vous préférez interagir directement avec le service, les commandes cURL suivantes illustrent le flux de travail complet.

1. Authentifier et obtenir le jeton d’accès

curl -X POST "https://api.groupdocs.cloud/v2.0/oauth2/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

2. Téléverser le PDF source

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=/input.pdf" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-F "file=@/path/to/input.pdf"

3. Demander la conversion PDF en DOCX

curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert?outputFormat=docx&outputPath=/output.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"filePath":"/input.pdf"}'

4. Télécharger le DOCX converti

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/download?path=/output.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o output.docx

Ces commandes peuvent être encapsulées dans un script PHP simple ou utilisées dans des pipelines CI pour un outil CLI de conversion PDF en DOCX en PHP. Pour plus de détails, consultez la référence API.

Conclusion

Intégrer la conversion PDF vers DOCX en PHP est simple avec le GroupDocs.Conversion Cloud SDK for PHP. Vous avez appris comment configurer la bibliothèque, exécuter une conversion étape par étape et invoquer la même fonctionnalité via des appels REST. La bibliothèque prend en charge à la fois les déploiements basés sur le cloud et les scénarios sur site, vous offrant une flexibilité pour les architectures de microservices ou les installations serveur traditionnelles. N’oubliez pas de consulter les options de tarification sur la page du produit et d’obtenir une licence temporaire depuis la page de licence temporaire avant de passer en production. Bon codage!

FAQ

Comment implémenter la conversion de documents PDF en DOCX en PHP sur site ?
Déployez la bibliothèque sur votre propre serveur, configurez l’ID client et le secret, puis exécutez le code de conversion localement. Aucun trafic réseau externe n’est requis après l’authentification.

Quelle est la meilleure façon d’améliorer la vitesse de conversion pour les gros PDF ?
Réutilisez une seule instance ConversionApi, augmentez la limite de mémoire de PHP et activez le streaming en définissant les options appropriées dans ConvertOptions. Cela réduit la surcharge et améliore les performances de conversion PDF vers DOCX en PHP.

Puis-je utiliser la bibliothèque dans un conteneur Docker pour un microservice ?
Oui. Incluez l’étape d’installation de Composer dans votre Dockerfile, copiez votre script PHP et exposez un point de terminaison qui appelle la logique de conversion. Cela crée un microservice de conversion PDF vers DOCX portable en PHP.

Existe-t-il un package Composer pour cette fonctionnalité ?
La bibliothèque est distribuée via Composer. Installez‑la avec composer require groupdocs-conversion-cloud et gérez les mises à jour via votre composer.json.

Lire la suite

• Tutoriel étape par étape - Conversion DOCX en PDF en Java
• Tutoriel étape par étape - Conversion HTML en XLSX en PHP
• Exemple de conversion CSV en PDF étape par étape en Node.JS