At konvertere en 3D-model til et PDF-dokument åbner for nem deling og udskrivning på enhver platform. Aspose.Email Cloud SDK for PHP leverer et kraftfuldt cloud‑baseret bibliotek, der håndterer 3D‑til‑PDF-konvertering i PHP med kun få API‑kald. I denne vejledning vil du se, hvordan du konfigurerer dine legitimationsoplysninger, uploader en OBJ-fil, udløser konverteringen, downloader den resulterende PDF og finjusterer nogle få indstillinger. Når du er færdig, har du et genanvendeligt PHP‑script, der kan integreres i enhver web‑ eller desktop‑applikation.

Før du begynder: Forudsætninger og installation

Du har brug for et PHP‑udviklingsmiljø (PHP 8.0+ anbefales) og Composer installeret. Tilmeld dig en Aspose Cloud‑konto for at få din Client Id og Client Secret.

Installer SDK’en med Composer:

composer require aspose/aspose-email-cloud

Download SDK-pakken, hvis du foretrækker en manuel installation: Download-URL.

Det følgende uddrag viser konfigurationsblokken, som du senere vil genbruge. Erstat pladsholderværdierne med legitimationsoplysningerne fra dit Aspose Cloud‑dashboard.

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

Med SDK’en installeret og legitimationsoplysningerne klar, kan du gå videre til de faktiske konverteringstrin.

Byg trin for trin: 3D til PDF‑konvertering i PHP

Trin 1: Indlæs konfiguration og angiv legitimationsoplysninger

Først skal du oprette et Configuration-objekt og indstille din klient‑ID, hemmelighed og vært. Dette objekt vil blive videregivet til alle API‑instanser.

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

Trin 2: Initialiser API‑instanser

Opret instanser af StorageApi og ThreeDApi ved hjælp af konfigurationsobjektet.

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

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

Trin 3: Upload kildefil 3D

Upload din lokale OBJ‑fil til Aspose Cloud storage, så konverteringstjenesten kan få adgang til den.

use Aspose\ThreeD\Model\UploadFileRequest;

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

Trin 4: Konverter 3D til PDF

Anmod om konverteringen fra OBJ til PDF. Målfilens navn er defineret af $targetPdfFile.

use Aspose\ThreeD\Model\Convert3DRequest;

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

Trin 5: Download den resulterende PDF

Hent den nyoprettede PDF fra cloud‑lagringen og gem den lokalt.

use Aspose\ThreeD\Model\DownloadFileRequest;

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

Trin 6: Ryd op i lageret

Slet eventuelt kilde‑OBJ’en og den genererede PDF fra cloud‑lagringen for at holde din konto ryddelig.

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

Med disse trin fuldført har du med succes udført en 3D til PDF‑konvertering i PHP.

Fuld PHP Script Eksempel: 3D til PDF Konvertering i PHP - Fuld Script

Eksemplet nedenfor demonstrerer den komplette arbejdsgang i en enkelt fil. Kopier det ind i et PHP‑projekt og juster credential‑pladsholderne.

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

Bemærk: Dette kodeeksempel demonstrerer kernefunktionaliteten. Før du bruger det i dit projekt, skal du sikre dig, at du opdaterer eventuelle filstier og konfigurationsværdier, så de matcher dit faktiske miljø, bekræfte at alle nødvendige afhængigheder er korrekt installeret, og teste grundigt i dit udviklingsmiljø. Hvis du støder på problemer, så henvis til den officielle dokumentation eller kontakt supportteamet for assistance.

Konvertér 3D-modeller ved hjælp af cURL og REST API

Hvis du foretrækker at arbejde direkte med REST-endpoints, opnår de følgende cURL-kommandoer det samme resultat.

  1. Godkend og hent adgangstoken

Erstat YOUR_CLIENT_ID og YOUR_CLIENT_SECRET med dine legitimationsoplysninger.

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"

Svaret indeholder et access_token, der bruges i efterfølgende kald.

  1. Upload kildefilen OBJ
curl -X PUT "https://api.aspose.cloud/v3.0/3d/storage/file/sample.obj" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -T "sample.obj"
  1. Udfør konverteringen
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. Download output‑PDF’en
curl -X GET "https://api.aspose.cloud/v3.0/3d/storage/file/sample.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o "output.pdf"

For en komplet liste over parametre og fejlhåndtering, se API-referencen.

Konverteringsmuligheder: Indstillinger og justeringer

SDK’en eksponerer flere egenskaber, som du kan justere, før du kalder convert3D:

  • Outputformat - Det tredje argument til Convert3DRequest definerer målformatet (pdf i denne vejledning). Skift det til png eller jpeg for billedoutput.
  • Host-URL - Hvis du bruger et regionalt Aspose Cloud-endpoint, skal du ændre $config->setHost('https://api-eu.aspose.cloud');.
  • Timeouts - Både StorageApi og ThreeDApi accepterer valgfrie HTTP-klientkonfigurationer, hvor du kan angive anmodningstidspunkter for store filer.

Disse indstillinger giver dig mulighed for at tilpasse konverteringsprocessen til dine præstations- og overholdelseskrav. For en komplet liste, se API-reference.

Konklusion

Du har nu mestret 3D til PDF‑konvertering i PHP ved hjælp af Aspose.Email Cloud SDK for PHP. Guiden dækkede alt fra opsætning af miljøet til et komplet, produktionsklart script og et cURL‑alternativ. Husk, at SDK’en er et kommercielt produkt; du kan gennemgå prisoplysninger på produktsiden og få en midlertidig licens til evaluering på den midlertidige licensside. Integrer dette workflow i dine egne applikationer for at levere problemfri 3D‑dokumenthåndtering til dine brugere.

Ofte stillede spørgsmål

  • Hvad er den nemmeste måde at udføre 3D til PDF-konvertering i PHP?
    Ved at bruge Aspose.Email Cloud SDK for PHP er den mest ligetil metode. Biblioteket abstraherer REST‑kaldene og giver dig mulighed for at konvertere 3D‑modeller til PDF med kun et par linjer kode.

  • Kan jeg konvertere andre 3D-formater udover OBJ med dette bibliotek?
    Ja, SDK’en understøtter STL, FBX, 3DS og andre almindelige 3D-formater. Skift blot kildefilens navn, så håndterer SDK’en konverteringen til PDF.

  • Hvordan håndterer jeg store 3D-filer under konvertering?
    Upload filen til Aspose Cloud storage først, og udløs derefter konverteringen. Dette holder hukommelsesforbruget lavt på din server. For meget store filer kan du overveje at opdele dem eller bruge den asynkrone konverterings-API.

  • Er der en måde at tilpasse PDF-output, såsom side størrelse eller orientering?
    Konverterings-API’en giver dig mulighed for at angive yderligere parametre i anmodningens krop. Se API reference for den fulde liste over understøttede muligheder.

Læs mere