Ein 3D‑Modell in ein PDF-Dokument zu verwandeln, ermöglicht einfaches Teilen und Drucken auf jeder Plattform. Aspose.Email Cloud SDK for PHP bietet eine leistungsstarke cloudbasierte Bibliothek, die die 3D‑zu‑PDF‑Konvertierung in PHP mit nur wenigen API‑Aufrufen erledigt. In diesem Tutorial sehen Sie, wie Sie Ihre Anmeldeinformationen konfigurieren, eine OBJ-Datei hochladen, die Konvertierung ausführen, das resultierende PDF herunterladen und einige Optionen feinabstimmen. Am Ende haben Sie ein wiederverwendbares PHP‑Skript, das in jede Web‑ oder Desktop‑Anwendung integriert werden kann.

Bevor Sie beginnen: Voraussetzungen und Installation

Sie benötigen eine PHP‑Entwicklungsumgebung (empfohlen wird PHP 8.0+) und Composer installiert. Registrieren Sie sich für ein Aspose Cloud‑Konto, um Ihre Client Id und Client Secret zu erhalten.

Installieren Sie das SDK mit Composer:

composer require aspose/aspose-email-cloud

Laden Sie das SDK-Paket herunter, wenn Sie eine manuelle Installation bevorzugen: Download-URL.

Das folgende Snippet zeigt den Konfigurationsblock, den Sie später erneut verwenden werden. Ersetzen Sie die Platzhalterwerte durch die Anmeldeinformationen aus Ihrem 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)

Mit dem installierten SDK und den bereitstehenden Anmeldeinformationen können Sie zu den eigentlichen Konvertierungsschritten übergehen.

Schritt für Schritt: 3D-zu-PDF-Konvertierung in PHP

Schritt 1: Konfiguration laden und Anmeldeinformationen festlegen

Zuerst erstellen Sie ein Configuration‑Objekt und setzen Ihre Client‑ID, das Geheimnis und den Host. Dieses Objekt wird an alle API‑Instanzen übergeben.

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

Schritt 2: API-Instanzen initialisieren

Erstellen Sie Instanzen von StorageApi und ThreeDApi mithilfe des Konfigurationsobjekts.

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

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

Schritt 3: Quell-3D-Datei hochladen

Laden Sie Ihre lokale OBJ‑Datei in den Aspose Cloud‑Speicher hoch, damit der Konvertierungsdienst darauf zugreifen kann.

use Aspose\ThreeD\Model\UploadFileRequest;

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

Schritt 4: 3D in PDF konvertieren

Fordern Sie die Konvertierung von OBJ zu PDF an. Der Zieldateiname wird durch $targetPdfFile definiert.

use Aspose\ThreeD\Model\Convert3DRequest;

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

Schritt 5: Ergebnis‑PDF herunterladen

Rufen Sie das neu erstellte PDF aus dem Cloud‑Speicher ab und speichern Sie es lokal.

use Aspose\ThreeD\Model\DownloadFileRequest;

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

Schritt 6: Speicher bereinigen

Optional können Sie das Quell‑OBJ und das erzeugte PDF aus dem Cloud‑Speicher löschen, um Ihr Konto ordentlich zu halten.

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

Mit diesen Schritten haben Sie die 3D‑zu‑PDF‑Konvertierung in PHP erfolgreich durchgeführt.

Vollständiges PHP‑Skript‑Beispiel: 3D‑zu‑PDF‑Konvertierung in PHP - Vollständiges Skript

Das nachstehende Beispiel demonstriert den vollständigen Workflow in einer einzigen Datei. Kopieren Sie es in ein PHP‑Projekt und passen Sie die Platzhalter für die Anmeldeinformationen an.

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

Hinweis: Dieses Codebeispiel demonstriert die Kernfunktionalität. Bevor Sie es in Ihrem Projekt verwenden, stellen Sie sicher, dass Sie alle Dateipfade und Konfigurationswerte an Ihre tatsächliche Umgebung anpassen, überprüfen Sie, dass alle erforderlichen Abhängigkeiten ordnungsgemäß installiert sind, und testen Sie gründlich in Ihrer Entwicklungsumgebung. Wenn Sie auf Probleme stoßen, lesen Sie bitte die offizielle Dokumentation oder wenden Sie sich an das Support-Team für Unterstützung.

3D-Modelle mit cURL und der REST-API konvertieren

Wenn Sie lieber direkt mit den REST-Endpunkten arbeiten, erreichen die folgenden cURL‑Befehle dasselbe Ergebnis.

  1. Authentifizieren und Zugriffstoken erhalten

Ersetzen Sie YOUR_CLIENT_ID und YOUR_CLIENT_SECRET durch Ihre Anmeldeinformationen.

   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"

Die Antwort enthält ein access_token, das in nachfolgenden Aufrufen verwendet wird.

  1. Laden Sie die Quell-OBJ-Datei hoch
curl -X PUT "https://api.aspose.cloud/v3.0/3d/storage/file/sample.obj" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -T "sample.obj"
  1. Führen Sie die Konvertierung aus
   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. PDF-Ausgabe herunterladen
curl -X GET "https://api.aspose.cloud/v3.0/3d/storage/file/sample.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o "output.pdf"

Für eine vollständige Liste der Parameter und der Fehlerbehandlung siehe die API-Referenz.

Konvertierungsoptionen: Einstellungen und Feinabstimmungen

Das SDK stellt mehrere Eigenschaften bereit, die Sie vor dem Aufruf von convert3D anpassen können:

  • Ausgabeformat - Das dritte Argument von Convert3DRequest definiert das Zielformat (pdf in diesem Tutorial). Ändern Sie es zu png oder jpeg für die Bildausgabe.
  • Host-URL - Wenn Sie einen regionalen Aspose Cloud-Endpunkt verwenden, ändern Sie $config->setHost('https://api-eu.aspose.cloud');.
  • Timeouts - Sowohl StorageApi als auch ThreeDApi akzeptieren optionale HTTP-Client-Konfigurationen, in denen Sie Anforderungs-Timeouts für große Dateien festlegen können.

Diese Optionen ermöglichen es Ihnen, den Konvertierungsprozess an Ihre Leistungs‑ und Compliance‑Anforderungen anzupassen. Für eine vollständige Liste siehe die API‑Referenz.

Fazit

Sie haben nun die 3D‑zu‑PDF‑Konvertierung in PHP mit dem Aspose.Email Cloud SDK for PHP gemeistert. Der Leitfaden behandelte alles von der Einrichtung der Umgebung bis hin zu einem vollständigen, produktionsbereiten Skript und einer cURL‑Alternative. Denken Sie daran, dass das SDK ein kommerzielles Produkt ist; Sie können die Preisdetails auf der Produktseite einsehen und eine temporäre Lizenz für die Evaluierung auf der temporären Lizenzseite erhalten. Integrieren Sie diesen Workflow in Ihre eigenen Anwendungen, um Ihren Benutzern eine nahtlose 3D‑Dokumentenverarbeitung zu bieten.

FAQs

  • Was ist der einfachste Weg, um 3D‑zu‑PDF‑Konvertierung in PHP durchzuführen?
    Die Verwendung des Aspose.Email Cloud SDK for PHP ist die unkomplizierteste Methode. Die Bibliothek abstrahiert die REST‑Aufrufe und ermöglicht es Ihnen, 3D‑Modelle mit nur wenigen Codezeilen in PDF zu konvertieren.

  • Kann ich mit dieser Bibliothek andere 3D-Formate neben OBJ konvertieren?
    Ja, das SDK unterstützt STL, FBX, 3DS und andere gängige 3D-Formate. Ändern Sie einfach den Quelldateinamen und das SDK übernimmt die Konvertierung zu PDF.

  • Wie gehe ich mit großen 3D-Dateien während der Konvertierung um?
    Uploaden Sie die Datei zuerst in den Aspose Cloud storage und starten Sie dann die Konvertierung. Dadurch bleibt die Speichernutzung auf Ihrem Server gering. Bei sehr großen Dateien sollten Sie in Erwägung ziehen, sie zu splitten oder die asynchrone Konvertierungs‑API zu verwenden.

  • Gibt es eine Möglichkeit, die PDF‑Ausgabe anzupassen, z. B. Seitengröße oder Ausrichtung?
    Die Konvertierungs‑API ermöglicht es Ihnen, zusätzliche Parameter im Anforderungstext anzugeben. Weitere Informationen finden Sie in der API‑Referenz für die vollständige Liste der unterstützten Optionen.

Mehr lesen