Convertir un modèle 3D en document PDF permet un partage et une impression faciles sur n’importe quelle plateforme. Aspose.Email Cloud SDK for PHP fournit une puissante bibliothèque cloud qui gère la conversion de 3D en PDF en PHP avec seulement quelques appels d’API. Dans ce tutoriel, vous verrez comment configurer vos identifiants, télécharger un fichier OBJ , lancer la conversion, télécharger le PDF résultant et affiner quelques options. À la fin, vous disposerez d’un script PHP réutilisable qui peut être intégré à n’importe quelle application web ou de bureau.

Avant de commencer : prérequis et installation

Vous avez besoin d’un environnement de développement PHP (PHP 8.0+ recommandé) et de Composer installé. Inscrivez-vous à un compte Aspose Cloud pour obtenir votre Client Id et Client Secret.

Installez le SDK avec Composer:

composer require aspose/aspose-email-cloud

Téléchargez le package SDK si vous préférez une installation manuelle : URL de téléchargement.

L’extrait suivant montre le bloc de configuration que vous réutiliserez plus tard. Remplacez les valeurs d’espace réservé par les informations d’identification de votre tableau de bord Aspose Cloud.

<?php
require_once __DIR__ . '/vendor/autoload.php';

use Aspose\ThreeD\Configuration;

// -----------------------------------------------------------------------------
// Configuration – replace with your actual Aspose Cloud client credentials
// -----------------------------------------------------------------------------
$config = new Configuration();
$config->setAppSid('YOUR_CLIENT_ID');          // Client Id
$config->setAppKey('YOUR_CLIENT_SECRET');     // Client Secret
$config->setHost('https://api.aspose.cloud'); // Base URL (default)

Avec le SDK installé et les informations d’identification prêtes, vous pouvez passer aux étapes réelles de conversion.

Construction étape par étape : conversion 3D en PDF avec PHP

Étape 1 : Charger la configuration et définir les informations d’identification

Tout d’abord, créez un objet Configuration et définissez votre ID client, secret et hôte. Cet objet sera transmis à toutes les instances de l’API.

$config = new Configuration();
$config->setAppSid('YOUR_CLIENT_ID');
$config->setAppKey('YOUR_CLIENT_SECRET');
$config->setHost('https://api.aspose.cloud');

Étape 2 : Initialiser les instances d’API

Créez des instances de StorageApi et ThreeDApi en utilisant l’objet de configuration.

use Aspose\ThreeD\Api\ThreeDApi;
use Aspose\ThreeD\Api\StorageApi;

$storageApi = new StorageApi(null, $config);
$threeDApi   = new ThreeDApi(null, $config);

Étape 3 : Téléverser le fichier 3D source

Téléchargez votre fichier OBJ local vers le stockage Aspose Cloud afin que le service de conversion puisse y accéder.

use Aspose\ThreeD\Model\UploadFileRequest;

$source3DFile = 'sample.obj';   // Input 3D model file
$uploadRequest = new UploadFileRequest($source3DFile, $source3DFile);
$storageApi->uploadFile($uploadRequest);

Étape 4 : Convertir le 3D en PDF

Demandez la conversion d’OBJ en PDF. Le nom du fichier cible est défini par $targetPdfFile.

use Aspose\ThreeD\Model\Convert3DRequest;

$targetPdfFile = 'sample.pdf';  // Desired output PDF name
$convertRequest = new Convert3DRequest($source3DFile, $targetPdfFile, 'pdf');
$threeDApi->convert3D($convertRequest);

Étape 5 : Télécharger le PDF résultant

Récupérez le PDF nouvellement créé depuis le stockage cloud et enregistrez‑le localement.

use Aspose\ThreeD\Model\DownloadFileRequest;

$downloadRequest = new DownloadFileRequest($targetPdfFile);
$response = $storageApi->downloadFile($downloadRequest);
$localPdfPath = __DIR__ . '/output.pdf';
file_put_contents($localPdfPath, $response->getContent());

Étape 6 : Nettoyage du stockage

Supprimez éventuellement le OBJ source et le PDF généré du stockage cloud pour garder votre compte propre.

$storageApi->deleteFile(new \Aspose\ThreeD\Model\DeleteFileRequest($source3DFile));
$storageApi->deleteFile(new \Aspose\ThreeD\Model\DeleteFileRequest($targetPdfFile));

Avec ces étapes terminées, vous avez réussi à effectuer une conversion 3D en PDF en PHP.

Exemple complet de script PHP : conversion 3D en PDF en PHP - Script complet

L’exemple ci-dessous montre le flux de travail complet dans un seul fichier. Copiez‑le dans un projet PHP et ajustez les espaces réservés des informations d’identification.

<?php
require_once __DIR__ . '/vendor/autoload.php';

use Aspose\ThreeD\Configuration;
use Aspose\ThreeD\Api\ThreeDApi;
use Aspose\ThreeD\Api\StorageApi;
use Aspose\ThreeD\Model\UploadFileRequest;
use Aspose\ThreeD\Model\Convert3DRequest;
use Aspose\ThreeD\Model\DownloadFileRequest;

// -----------------------------------------------------------------------------
// Configuration – replace with your actual Aspose Cloud client credentials
// -----------------------------------------------------------------------------
$config = new Configuration();
$config->setAppSid('YOUR_CLIENT_ID');          // Client Id
$config->setAppKey('YOUR_CLIENT_SECRET');     // Client Secret
$config->setHost('https://api.aspose.cloud'); // Base URL (default)

// -----------------------------------------------------------------------------
// Initialise API instances
// -----------------------------------------------------------------------------
$storageApi = new StorageApi(null, $config);
$threeDApi   = new ThreeDApi(null, $config);

// -----------------------------------------------------------------------------
// Define source 3D file and target PDF file (paths are relative to the project)
// -----------------------------------------------------------------------------
$source3DFile = 'sample.obj';   // Input 3D model file
$targetPdfFile = 'sample.pdf';  // Desired output PDF name

// -----------------------------------------------------------------------------
// Upload the 3D file to Aspose Cloud storage
// -----------------------------------------------------------------------------
$uploadRequest = new UploadFileRequest($source3DFile, $source3DFile);
$storageApi->uploadFile($uploadRequest);

// -----------------------------------------------------------------------------
// Perform the conversion: 3D → PDF
// -----------------------------------------------------------------------------
$convertRequest = new Convert3DRequest($source3DFile, $targetPdfFile, 'pdf');
$threeDApi->convert3D($convertRequest);

// -----------------------------------------------------------------------------
// Download the resulting PDF back to local storage
// -----------------------------------------------------------------------------
$downloadRequest = new DownloadFileRequest($targetPdfFile);
$response = $storageApi->downloadFile($downloadRequest);
$localPdfPath = __DIR__ . '/output.pdf';
file_put_contents($localPdfPath, $response->getContent());

// -----------------------------------------------------------------------------
// Clean‑up: optionally delete files from cloud storage
// -----------------------------------------------------------------------------
$storageApi->deleteFile(new \Aspose\ThreeD\Model\DeleteFileRequest($source3DFile));
$storageApi->deleteFile(new \Aspose\ThreeD\Model\DeleteFileRequest($targetPdfFile));

echo "3D to PDF conversion completed. PDF saved to: {$localPdfPath}\n";

Note : Cet exemple de code démontre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez‑vous de mettre à jour tous les chemins de fichiers et les valeurs de configuration pour qu’ils correspondent à votre environnement réel, 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.

Convertir des modèles 3D à l’aide de cURL et de l’API REST

Si vous préférez travailler directement avec les points de terminaison REST, les commandes cURL suivantes donnent le même résultat.

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

Remplacez YOUR_CLIENT_ID et YOUR_CLIENT_SECRET par vos informations d’identification.

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

La réponse contient un access_token utilisé dans les appels ultérieurs.

  1. Télécharger le fichier OBJ source
   curl -X PUT "https://api.aspose.cloud/v3.0/3d/storage/file/sample.obj" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -T "sample.obj"
  1. Exécuter la conversion
curl -X POST "https://api.aspose.cloud/v3.0/3d/convert/sample.obj?format=pdf&outPath=sample.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  1. Télécharger le PDF de sortie
curl -X GET "https://api.aspose.cloud/v3.0/3d/storage/file/sample.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o "output.pdf"

Pour une liste complète des paramètres et de la gestion des erreurs, consultez la référence API.

Options de conversion : paramètres et ajustements

Le SDK expose plusieurs propriétés que vous pouvez ajuster avant d’appeler convert3D :

  • Format de sortie - Le troisième argument de Convert3DRequest définit le format cible (pdf dans ce tutoriel). Changez‑le en png ou jpeg pour une sortie image.
  • URL d’hôte - Si vous utilisez un point de terminaison régional Aspose Cloud, modifiez $config->setHost('https://api-eu.aspose.cloud');.
  • Délais d’attente - Les StorageApi et ThreeDApi acceptent des configurations optionnelles du client HTTP où vous pouvez définir les délais d’attente des requêtes pour les gros fichiers.

Ces options vous permettent d’adapter le processus de conversion à vos exigences de performance et de conformité. Pour une liste complète, consultez la référence API.

Conclusion

Vous avez maintenant maîtrisé la conversion 3D vers PDF en PHP en utilisant le Aspose.Email Cloud SDK for PHP. Le guide a couvert tout, de la configuration de l’environnement à un script complet, prêt pour la production, ainsi qu’une alternative cURL. N’oubliez pas que le SDK est un produit commercial ; vous pouvez consulter les détails de tarification sur la page du produit et obtenir une licence temporaire pour l’évaluation sur la page de licence temporaire. Intégrez ce flux de travail dans vos propres applications pour offrir une gestion transparente des documents 3D à vos utilisateurs.

FAQ

  • Quelle est la façon la plus simple d’effectuer une conversion 3D vers PDF en PHP ?
    Utiliser le Aspose.Email Cloud SDK for PHP est la méthode la plus directe. La bibliothèque abstrait les appels REST et vous permet de convertir des modèles 3D en PDF avec seulement quelques lignes de code.

  • Puis-je convertir d’autres formats 3D en plus d’OBJ avec cette bibliothèque ?
    Oui, le SDK prend en charge les formats STL, FBX, 3DS et d’autres formats 3D courants. Il suffit de changer le nom du fichier source et le SDK gérera la conversion en PDF.

  • Comment gérer les gros fichiers 3D lors de la conversion ?
    Téléchargez le fichier d’abord sur le stockage Aspose Cloud, puis lancez la conversion. Cela maintient une faible utilisation de la mémoire sur votre serveur. Pour les fichiers très volumineux, envisagez de les diviser ou d’utiliser l’API de conversion asynchrone.

  • Existe-t-il un moyen de personnaliser la sortie PDF, comme la taille ou l’orientation de la page ?
    L’API de conversion vous permet de spécifier des paramètres supplémentaires dans le corps de la requête. Consultez la référence API pour la liste complète des options prises en charge.

En savoir plus