Prima di iniziare: Prerequisiti e installazione

Per seguire questa guida è necessario:

• PHP 7.4 o versioni successive installato sulla tua macchina di sviluppo o sul server.
• Composer per la gestione delle dipendenze.
• Un account GroupDocs Cloud (client ID e client secret) - puoi crearne uno sul portale GroupDocs.
• Spazio su disco sufficiente per il PDF di origine e il file DOCX risultante.

Installa la libreria con Composer:

composer require groupdocs-conversion-cloud

Scarica l’ultimo pacchetto o visualizza il codice sorgente su GitHub: URL di download. Dopo l’installazione, sei pronto per iniziare a programmare.

Conversione di documenti PDF in DOCX con PHP - Costruendola passo dopo passo

Di seguito è una breve panoramica che mostra ogni operazione essenziale. Il codice sorgente completo appare più avanti nella sezione Implementazione PHP completa per la conversione di documenti in DOCX.

Passo 1: Carica il PDF di origine

Crea un’istanza di ConversionApi e puntala al PDF che desideri convertire.

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

Passo 2: Inizializza le impostazioni di conversione

Definisci il formato di output e il percorso di destinazione. La classe ConvertOptions ti consente di regolare finemente i limiti di memoria per PDF di grandi dimensioni, migliorando le Prestazioni di conversione da PDF a DOCX in 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

Step 3: Esegui la conversione

Invia la richiesta al servizio cloud. Questa singola chiamata API esegue il lavoro pesante.

use GroupDocs\Conversion\Model\Requests\ConvertDocumentRequest;

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

Passo 4: Recupera il risultato

Il file DOCX convertito è salvato nel percorso specificato. Ora puoi servirlo all’utente o conservarlo per un’elaborazione successiva.

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

Passo 5: Pulizia delle risorse

Elimina l’istanza dell’API se stai eseguendo molte conversioni in un ciclo. Riutilizzare la stessa istanza è più efficiente per un microservizio di conversione PDF in DOCX in PHP.

unset($api);

Implementazione PHP completa per la conversione di documenti in DOCX

Il codice seguente combina tutti i passaggi in un unico script eseguibile.

<?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);
?>

Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare i percorsi dei file (input.pdf, output.docx, ecc.) per corrispondere alle tue effettive posizioni dei file, verifica che tutte le dipendenze richieste siano correttamente installate e testa accuratamente nel tuo ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il forum di supporto per assistenza.

Esecuzione della conversione di documenti tramite REST API usando cURL

Se preferisci interagire direttamente con il servizio, i seguenti comandi cURL illustrano l’intero flusso di lavoro.

1. Autenticazione e Ottenimento del Token di Accesso

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. Carica il PDF di origine

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. Richiesta di conversione PDF in 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. Scarica il DOCX convertito

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

Questi comandi possono essere inseriti in un semplice script PHP o utilizzati nei pipeline CI per uno strumento CLI di conversione PDF in DOCX in PHP. Per ulteriori dettagli, consulta la riferimento API.

Conclusione

Integrare la conversione da PDF a DOCX in PHP è semplice con il GroupDocs.Conversion Cloud SDK for PHP. Hai imparato come configurare la libreria, eseguire una conversione passo‑passo e richiamare la stessa funzionalità tramite chiamate REST. La libreria supporta sia le distribuzioni basate su cloud sia gli scenari on‑premise, offrendoti flessibilità per architetture a microservizi o installazioni server tradizionali. Ricorda di esaminare le opzioni di prezzo nella pagina del prodotto e di ottenere una licenza temporanea dalla pagina della licenza temporanea prima di passare alla produzione. Buon coding!

FAQ

Come implementare la conversione da PDF a DOCX in PHP on‑premise?
Distribuisci la libreria sul tuo server, configura l’ID client e il segreto, ed esegui il codice di conversione localmente. Non è necessario alcun traffico di rete esterno dopo l’autenticazione.

Qual è il modo migliore per migliorare la velocità di conversione per PDF di grandi dimensioni?
Riutilizza un’unica istanza di ConversionApi, aumenta il limite di memoria di PHP e abilita lo streaming impostando le opzioni appropriate in ConvertOptions. Questo riduce l’overhead e migliora le Prestazioni di conversione da PDF a DOCX in PHP.

Posso usare la libreria in un contenitore Docker per un microservizio?
Sì. Includi il passaggio di installazione di Composer nel tuo Dockerfile, copia il tuo script PHP e espone un endpoint che chiama la logica di conversione. Questo crea un microservizio di conversione PDF in DOCX portatile in PHP.

Esiste un pacchetto Composer per questa funzionalità?
La libreria è distribuita tramite Composer. Installala con composer require groupdocs-conversion-cloud e gestisci gli aggiornamenti tramite il tuo composer.json.

Leggi di più

• Tutorial passo-passo - Conversione da DOCX a PDF in Java
• Tutorial passo-passo di conversione da HTML a XLSX in PHP
• Esempio passo-passo di conversione da CSV a PDF in Node.JS