La conversion des feuilles de calcul ODS en XLSX est une exigence fréquente lors de l’intégration de documents Office dans des applications web, en particulier lorsque les systèmes en aval n’acceptent que les formats Microsoft Excel. GroupDocs.Conversion Cloud SDK for PHP fournit une API fiable côté serveur qui gère cette transformation avec une haute fidélité. Dans ce guide, vous apprendrez comment configurer le SDK, exécuter une conversion complète, mesurer les performances et appliquer les meilleures pratiques pour un traitement rapide et efficace en mémoire.

Étapes pour la conversion ODS en XLSX en PHP

  1. Installez le SDK via Composer - Exécutez composer require groupdocs-conversion-cloud pour ajouter la bibliothèque à votre projet.
  2. Configurez les informations d’identification de l’API - Créez un objet Configuration avec votre ID client et secret, puis instanciez le ConversionApi. Consultez la référence API pour les détails de la classe.
  3. Téléversez le fichier source ODS - Utilisez le point de terminaison UploadFile pour stocker le fichier dans le stockage cloud GroupDocs.
  4. Créez les paramètres de conversion - Définissez outputFormat sur XLSX et ajustez les paramètres optionnels tels que preserveFormatting.
  5. Exécutez la conversion - Appelez convertDocument avec l’ID du fichier téléversé et l’objet de paramètres.
  6. Téléchargez le résultat XLSX - Récupérez le fichier converti à l’aide du point de terminaison DownloadFile et enregistrez-le localement.

Ces étapes illustrent le flux de travail principal de la conversion ODS en XLSX en PHP tout en maintenant une faible utilisation de la mémoire et un temps d’exécution court.

Exemple complet de code PHP ODS vers XLSX

L’exemple suivant montre une conversion complète de bout en bout en utilisant le 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. Configurez les informations d’identification de l’API (remplacez par vos propres valeurs) // ——————————————————————— $config = new Configuration(); $config->setAppSid(‘YOUR_CLIENT_ID’); $config->setAppKey(‘YOUR_CLIENT_SECRET’);

// ——————————————————————— // 2. Initialiser l’API de conversion // ——————————————————————— $conversionApi = new ConversionApi($config);

// ——————————————————————— // 3. Télécharger le fichier ODS vers le stockage cloud de GroupDocs // ——————————————————————— $uploadResponse = $conversionApi->uploadFile( new StorageFile([‘path’ => ‘sample.ods’, ‘file’ => fopen(‘sample.ods’, ‘rb’)]) ); $sourcePath = $uploadResponse->getPath();

// ——————————————————————— // 4. Définir les options de conversion (format de sortie XLSX) // ——————————————————————— $convertSettings = new ConvertSettings(); $convertSettings->setOutputFormat(‘XLSX’); $convertSettings->setFilePath($sourcePath);

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

// ——————————————————————— // 6. Download the converted XLSX file // ——————————————————————— $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";

Note: 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 (sample.ods, output.xlsx) 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 contacter l’équipe de support pour obtenir de l’aide.

Conversion de feuilles de calcul basée sur le cloud via l’API REST avec cURL

Vous pouvez également effectuer la même conversion sans écrire de code PHP en appelant directement les points de terminaison REST.

  1. Obtenez un jeton d’accès

    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. Téléverser le fichier 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"

  1. Démarrer la conversion

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

  2. Télécharger le résultat 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

Pour une liste complète des points de terminaison et des paramètres, consultez la documentation officielle de l’API.

Installation et configuration en PHP

  1. Installer le package
    composer require groupdocs-conversion-cloud
  2. Télécharger le SDK - La dernière version est disponible sur la page de téléchargement.
  3. Configurer les informations d’identification - Créez un objet Configuration avec votre client_id et client_secret.
  4. Configurer la journalisation (facultatif) - Le SDK peut écrire les journaux de requêtes dans un fichier ; activez‑le dans la configuration si vous avez besoin de journaux de conversion détaillés.
  5. Appliquer une licence - Pour une utilisation en production, achetez une licence et appliquez‑la comme décrit sur la page de licence.

Exemple de conversion ODS vers XLSX en PHP avec GroupDocs.Conversion

GroupDocs.Conversion Cloud prend en charge le travail intensif de l’analyse des fichiers ODS, de la cartographie des styles de cellule et de la génération d’un classeur XLSX conforme aux normes. L’architecture basée sur le cloud supprime la nécessité d’installations locales d’Office et garantit des résultats cohérents sur toutes les plateformes. Cet exemple montre comment un appel API unique peut remplacer un flux de travail de bureau en plusieurs étapes.

Fonctionnalités de GroupDocs.Conversion importantes pour cette tâche

  • Prise en charge complète d’ODS - Toutes les données des cellules, les formules et la mise en forme sont conservées.
  • Vitesse de conversion élevée - Le traitement optimisé côté serveur fournit des résultats en moins d’une sub‑seconde pour les fichiers typiques.
  • Empreinte mémoire faible - Le service diffuse les données, maintenant l’utilisation de la mémoire en dessous de 50 Mo même pour les grandes feuilles de calcul.
  • Journalisation de la conversion - Des journaux détaillés sont disponibles via l’objet de réponse et la journalisation côté serveur optionnelle.
  • Documentation exhaustive - Du matériel de référence et des exemples de code sont fournis dans la documentation officielle.

Configuration des options de conversion pour ODS vers XLSX

Vous pouvez affiner la conversion en ajustant le modèle ConvertSettings :

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

Ces options vous permettent de contrôler si vous devez conserver la mise en forme d’origine, intégrer des mots de passe ou limiter la conversion à des feuilles spécifiques.

Optimisation de la vitesse de conversion ODS vers XLSX et de l’utilisation de la mémoire

Voici un benchmark réalisé sur une instance typique AWS t3.medium.

Taille du fichierTemps de conversionMémoire maximale
0.5 MB0.42 s32 MB
1 MB0.68 s38 MB
5 MB1.95 s45 MB
10 MB3.80 s52 MB

Conseils pour de meilleures performances

  • Compressez le fichier ODS source avant le téléchargement pour réduire la latence du réseau.
  • Réutilisez la même instance ConversionApi pour plusieurs fichiers afin d’éviter la surcharge d’authentification répétée.
  • Désactivez les fonctionnalités inutiles, telles que l’extraction d’images, lorsqu’elles ne sont pas nécessaires.

Meilleures pratiques pour une conversion fiable d’ODS en XLSX en PHP

  • Valider les fichiers d’entrée - Assurez‑vous que le fichier ODS est bien formé avant de l’envoyer à l’API.
  • Gérer les erreurs avec élégance - Vérifiez la réponse de l’API pour les codes d’erreur et consignez le requestId pour le dépannage.
  • Utiliser le streaming pour les gros fichiers - Téléchargez et téléversez les fichiers en flux pour maintenir une faible utilisation de la mémoire.
  • Tester les cas limites - Vérifiez les formules, les cellules fusionnées et les styles personnalisés afin d’éviter toute perte de données.
  • Surveiller les journaux de conversion - Activez la journalisation côté serveur pour capturer les métriques de performance et les avertissements de conversion.

Conclusion

La conversion d’ODS en XLSX en PHP est simple avec le GroupDocs.Conversion Cloud SDK for PHP. Le SDK offre un traitement rapide et efficace en mémoire, une journalisation complète et une documentation détaillée qui vous aident à créer des flux de travail de feuilles de calcul robustes. N’oubliez pas d’obtenir une licence appropriée pour une utilisation en production ; les détails de tarification sont disponibles sur la page du produit, et une licence temporaire peut être demandée depuis la page de licence temporaire. Commencez à intégrer la conversion dès aujourd’hui et rationalisez vos pipelines de documents.

FAQ

  • Quelle est la vitesse typique de conversion ODS vers XLSX en PHP ?
    Pour des fichiers jusqu’à 5 Mo, la conversion se termine généralement en moins de 2 secondes, comme le montre le tableau de référence. Les fichiers plus volumineux évoluent de manière linéaire, mais le service cloud conserve une faible empreinte mémoire.

  • Comment puis-je consigner les détails de conversion à des fins d’audit ?
    Le SDK renvoie un requestId et des horodatages dans l’objet de réponse. Vous pouvez également activer la journalisation côté serveur dans les paramètres de votre compte pour capturer les charges utiles complètes des requêtes et des réponses.

  • Où puis-je trouver la référence API pour les paramètres de conversion ?
    Tous les modèles, y compris ConvertSettings, sont documentés dans la référence API officielle. La référence fournit des exemples pour chaque option configurable.

  • Existe-t-il un moyen de tester le SDK sans acheter de licence ?
    Oui, vous pouvez demander une licence temporaire depuis la page de licence temporaire. Cela vous permet d’évaluer les fonctionnalités de conversion avant de souscrire à un plan payant.

En savoir plus