Passaggi per la conversione da ODS a XLSX in PHP

1. Installa l’SDK tramite Composer - Esegui composer require groupdocs-conversion-cloud per aggiungere la libreria al tuo progetto.
2. 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.
3. Carica il file sorgente ODS - Usa l’endpoint UploadFile per memorizzare il file nello storage cloud di GroupDocs.
4. Crea le impostazioni di conversione - Imposta outputFormat su XLSX e regola eventuali parametri opzionali come preserveFormatting.
5. Esegui la conversione - Chiama convertDocument con l’ID del file caricato e l’oggetto delle impostazioni.
6. 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.

1. 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"}'
   

2. 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"
   

3. 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"}'

4. 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

1. Installa il pacchetto

   composer require groupdocs-conversion-cloud
   

2. Scarica l’SDK - L’ultima versione è disponibile nella pagina di download.
3. Configura le credenziali - Crea un oggetto Configuration con il tuo client_id e client_secret.
4. 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.
5. 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.

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.

Leggi di più

• Converti MPP in Excel usando Java REST API - Conversione semplice da MPP a XLSX
• Converti MPP in Excel usando .NET REST API - Conversione fluida da MS Project a XLSX
• Conversione CSV in JSON senza sforzo - CSV in JSON in C#