Esempio di conversione da ODS a XLSX in PHP

La conversione di fogli di calcolo ODS in XLSX è una necessità frequente quando si integrano documenti Office in applicazioni web, soprattutto quando i sistemi a valle accettano solo formati Microsoft Excel. GroupDocs.Conversion Cloud SDK for PHP fornisce un’API affidabile lato server che gestisce questa trasformazione con alta fedeltà. In questa guida imparerai come configurare l’SDK, eseguire una conversione completa, misurare le prestazioni e applicare le migliori pratiche per un’elaborazione veloce ed efficiente in termini di memoria.

Passaggi per la conversione da ODS a XLSX in PHP

Installa l’SDK tramite Composer - Esegui composer require groupdocs-conversion-cloud per aggiungere la libreria al tuo progetto.
Configura le credenziali API - Crea un oggetto Configuration con il tuo client ID e secret, quindi istanzia il ConversionApi. Consulta la API reference per i dettagli della classe.
Carica il file sorgente ODS - Usa l’endpoint UploadFile per memorizzare il file nello storage cloud di GroupDocs.
Crea le impostazioni di conversione - Imposta outputFormat su XLSX e regola eventuali parametri opzionali come preserveFormatting.
Esegui la conversione - Chiama convertDocument con l’ID del file caricato e l’oggetto delle impostazioni.
Scarica il risultato XLSX - Recupera il file convertito usando l’endpoint DownloadFile e salvalo localmente.

Questi passaggi illustrano il flusso di lavoro principale per la conversione ODS in XLSX in PHP mantenendo basso l’uso della memoria e breve il tempo di esecuzione.

Esempio completo di codice PHP ODS a XLSX

Il seguente esempio dimostra una conversione end‑to‑end completa utilizzando il GroupDocs.Conversion Cloud SDK for PHP.

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

use GroupDocsConversionCloud\Configuration; use GroupDocsConversionCloud\Api\ConversionApi; use GroupDocsConversionCloud\Models\ConvertSettings; use GroupDocsConversionCloud\Models\StorageFile;

// ——————————————————————— // 1. Configura le credenziali API (sostituisci con i tuoi valori) // ——————————————————————— $config = new Configuration(); $config->setAppSid(‘YOUR_CLIENT_ID’); $config->setAppKey(‘YOUR_CLIENT_SECRET’);

// ---------------------------------------------------------------------
// 2. Inizializzare l'API di Conversione
// ---------------------------------------------------------------------
$conversionApi = new ConversionApi($config);

// ——————————————————————— // 3. Upload the ODS file to GroupDocs cloud storage // ——————————————————————— $uploadResponse = $conversionApi->uploadFile( new StorageFile([‘path’ => ‘sample.ods’, ‘file’ => fopen(‘sample.ods’, ‘rb’)]) ); $sourcePath = $uploadResponse->getPath();

// ——————————————————————— // 4. Imposta le opzioni di conversione (formato di output XLSX) // ——————————————————————— $convertSettings = new ConvertSettings(); $convertSettings->setOutputFormat(‘XLSX’); $convertSettings->setFilePath($sourcePath);

// ——————————————————————— // 5. Esegui la conversione // ——————————————————————— $convertResponse = $conversionApi->convertDocument($convertSettings); $downloadUrl = $convertResponse->getUrl();

// ——————————————————————— // 6. Scarica il file XLSX convertito // ——————————————————————— $targetFile = fopen(‘output.xlsx’, ‘wb’); $ch = curl_init($downloadUrl); curl_setopt($ch, CURLOPT_FILE, $targetFile); curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true); curl_exec($ch); curl_close($ch); fclose($targetFile);

echo "Conversion completed. File saved as output.xlsx\n";

<!--[COMPLETE_CODE_SNIPPET_END]-->

Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di utilizzarlo nel tuo progetto, assicurati di aggiornare i percorsi dei file (sample.ods, output.xlsx) 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 riscontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Conversione di fogli di calcolo basata su cloud tramite REST API usando cURL

È possibile eseguire la stessa conversione senza scrivere codice PHP chiamando direttamente gli endpoint REST.

Ottieni un token di accesso

curl -X POST "https://api.groupdocs.cloud/v2.0/oauth2/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

Carica il file ODS

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

Avvia la conversione

curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"inputPath":"sample.ods","outputFormat":"XLSX"}'

Scarica il risultato XLSX

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

Per un elenco completo di endpoint e parametri, consulta la documentazione ufficiale dell’API.

Installazione e Configurazione in PHP

Installa il pacchetto

composer require groupdocs-conversion-cloud

Scarica l’SDK - L’ultima versione è disponibile nella pagina di download.
Configura le credenziali - Crea un oggetto Configuration con il tuo client_id e client_secret.
Imposta il logging (opzionale) - L’SDK può scrivere i log delle richieste su un file; abilitalo nella configurazione se hai bisogno di log dettagliati di conversione.
Applica una licenza - Per l’uso in produzione, acquista una licenza e applicala come descritto nella pagina della licenza.

Esempio di conversione da ODS a XLSX in PHP con GroupDocs.Conversion

GroupDocs.Conversion Cloud gestisce il lavoro pesante di analizzare i file ODS, mappare gli stili delle cell e generare una cartella di lavoro XLSX conforme agli standard. L’architettura basata sul cloud elimina la necessità di installazioni locali di Office e garantisce risultati coerenti su tutte le piattaforme. Questo esempio dimostra come una singola chiamata API possa sostituire un flusso di lavoro desktop a più fasi.

Caratteristiche di GroupDocs.Conversion che contano per questo compito

Supporto completo ODS - Tutti i dati delle celle, le formule e la formattazione vengono preservati.
Elevata velocità di conversione - L’elaborazione ottimizzata lato server fornisce risultati sub‑secondo per i file tipici.
Basso consumo di memoria - Il servizio trasmette i dati in streaming, mantenendo l’uso della memoria sotto i 50 MB anche per fogli di calcolo di grandi dimensioni.
Registrazione della conversione - Log dettagliati sono disponibili tramite l’oggetto di risposta e la registrazione opzionale lato server.
Documentazione estesa - Materiale di riferimento e esempi di codice sono forniti nella documentazione ufficiale.

Configurazione delle opzioni di conversione da ODS a XLSX

È possibile perfezionare la conversione regolando il modello ConvertSettings:

$convertSettings = new ConvertSettings();
$convertSettings->setOutputFormat('XLSX');
$convertSettings->setPreserveCellFormatting(true);
$convertSettings->setPassword('optionalPassword'); // if the source ODS is protected

Queste opzioni ti consentono di controllare se mantenere la formattazione originale, incorporare le password o limitare la conversione a fogli specifici.

Ottimizzazione della velocità di conversione ODS in XLSX e utilizzo della memoria

Di seguito è riportato un benchmark eseguito su una tipica istanza AWS t3.medium.

Dimensione file	Tempo di conversione	Memoria di picco
0.5 MB	0.42 s	32 MB
1 MB	0.68 s	38 MB
5 MB	1.95 s	45 MB
10 MB	3.80 s	52 MB

Consigli per migliorare le prestazioni

Comprimere il file ODS di origine prima del caricamento per ridurre la latenza di rete.
Riutilizzare la stessa istanza ConversionApi per più file per evitare il sovraccarico di autenticazione ripetuta.
Disabilitare le funzionalità non necessarie, come l’estrazione delle immagini, quando non sono necessarie.

Best practice per una conversione affidabile da ODS a XLSX in PHP

Convalida i file di input - Assicurati che il file ODS sia ben formattato prima di inviarlo all’API.
Gestisci gli errori in modo elegante - Verifica la risposta dell’API per i codici di errore e registra il requestId per la risoluzione dei problemi.
Utilizza lo streaming per file di grandi dimensioni - Carica e scarica i file come stream per mantenere basso l’utilizzo della memoria.
Testa con casi limite - Verifica formule, celle unite e stili personalizzati per evitare perdite di dati.
Monitora i log di conversione - Abilita la registrazione lato server per catturare metriche di prestazione e eventuali avvisi di conversione.

Conclusione

Convertire ODS in XLSX in PHP è semplice con il GroupDocs.Conversion Cloud SDK for PHP. L’SDK offre elaborazione veloce e a basso consumo di memoria, registrazione completa e documentazione dettagliata che ti aiutano a costruire flussi di lavoro robusti per i fogli di calcolo. Ricorda di ottenere una licenza adeguata per l’uso in produzione; i dettagli dei prezzi sono disponibili nella pagina del prodotto, e una licenza temporanea può essere richiesta dalla pagina di licenza temporanea. Inizia a integrare la conversione oggi stesso e ottimizza i tuoi pipeline di documenti.

FAQ

Qual è la velocità tipica di conversione da ODS a XLSX in PHP?
Per file fino a 5 MB la conversione di solito si completa in meno di 2 secondi, come mostrato nella tabella di benchmark. I file più grandi scalano linearmente, ma il servizio cloud mantiene un basso utilizzo di memoria.
Come posso registrare i dettagli di conversione per l’audit?
L’SDK restituisce un requestId e i timestamp nell’oggetto di risposta. È inoltre possibile abilitare la registrazione lato server nelle impostazioni del tuo account per catturare i payload completi di richiesta e risposta.
Dove posso trovare il riferimento API per le impostazioni di conversione?
Tutti i modelli, inclusi ConvertSettings, sono documentati nel riferimento API ufficiale riferimento API. Il riferimento fornisce esempi per ogni opzione configurabile.
Esiste un modo per testare l’SDK senza acquistare una licenza?
Sì, è possibile richiedere una licenza temporanea dalla pagina della licenza temporanea. Ciò consente di valutare le funzionalità di conversione prima di impegnarsi in un piano a pagamento.

Passaggi per la conversione da ODS a XLSX in PHP#

Esempio completo di codice PHP ODS a XLSX#

Conversione di fogli di calcolo basata su cloud tramite REST API usando cURL#

Installazione e Configurazione in PHP#

Esempio di conversione da ODS a XLSX in PHP con GroupDocs.Conversion#

Caratteristiche di GroupDocs.Conversion che contano per questo compito#

Configurazione delle opzioni di conversione da ODS a XLSX#

Ottimizzazione della velocità di conversione ODS in XLSX e utilizzo della memoria#

Best practice per una conversione affidabile da ODS a XLSX in PHP#

Conclusione#

FAQ#

Leggi di più#