3D konvertálás PDF-re PHP-ben: Teljes fejlesztői útmutató

Egy 3D modell PDF dokumentummá alakítása egyszerű megosztást és nyomtatást tesz lehetővé bármely platformon. Aspose.Email Cloud SDK for PHP egy erőteljes cloud‑based könyvtárat biztosít, amely néhány API hívással kezeli a 3D‑ról PDF‑re konvertálást PHP‑ben. Ebben az útmutatóban megmutatjuk, hogyan állíthatja be hitelesítő adatait, tölthet fel egy OBJ fájlt, indíthatja el a konvertálást, töltheti le a kapott PDF‑et, és finomhangolhat néhány beállítást. A végére egy újrahasználható PHP szkriptet kap, amely beilleszthető bármely web‑ vagy asztali alkalmazásba.

Mielőtt elkezdené: Előfeltételek és telepítés

Szükséged van egy PHP fejlesztői környezetre (ajánlott a PHP 8.0+), és a Composer telepítve legyen. Regisztrálj egy Aspose Cloud fiókot, hogy megkapd a Client Id és Client Secret értékeidet.

Telepítse az SDK-t Composerrel:

composer require aspose/aspose-email-cloud

Töltse le az SDK csomagot, ha a manuális telepítést részesíti előnyben: Letöltési URL.

Az alábbi kódrészlet mutatja a konfigurációs blokkot, amelyet később újra felhasznál majd. Cserélje le a helyőrző értékeket az Aspose Cloud dashboard hitelesítő adataira.

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

A SDK telepítve és a hitelesítő adatok készen állnak, továbbléphet a tényleges konverziós lépésekre.

Lépésről lépésre felépítve: 3D PDF konvertálás PHP-ben

1. lépés: Konfiguráció betöltése és hitelesítő adatok beállítása

Először hozzon létre egy Configuration objektumot, és állítsa be a client ID-t, a secret-et és a hostot. Ez az objektum lesz átadva az összes API példánynak.

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

2. lépés: API példányok inicializálása

Hozzon létre StorageApi és ThreeDApi példányokat a konfigurációs objektum használatával.

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

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

3. lépés: Forrás 3D fájl feltöltése

Töltse fel a helyi OBJ fájlját az Aspose Cloud tárolóba, hogy a konverziós szolgáltatás hozzáférhessen.

use Aspose\ThreeD\Model\UploadFileRequest;

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

4. lépés: 3D konvertálása PDF-be

Kérje az OBJ PDF-re konvertálását. A célfájl neve a $targetPdfFile változóban van meghatározva.

use Aspose\ThreeD\Model\Convert3DRequest;

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

5. lépés: A keletkezett PDF letöltése

Töltse le az újonnan létrehozott PDF-et a felhő tárolóból, és mentse el helyileg.

use Aspose\ThreeD\Model\DownloadFileRequest;

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

6. lépés: Tároló tisztítása

Opcionálisan törölje a forrás OBJ‑t és a generált PDF‑et a felhő tárolóból, hogy fiókja rendezett maradjon.

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

Ezekkel a lépésekkel befejezve sikeresen végrehajtottad a 3D‑ről PDF‑re konvertálást PHP‑ben.

Teljes PHP szkript példa: 3D konvertálás PDF-be PHP-ben - Teljes szkript

Az alábbi példa bemutatja a teljes munkafolyamatot egyetlen fájlban. Másolja be egy PHP projektbe, és állítsa be a hitelesítőhelyettesítőket.

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

Megjegyzés: Ez a kódpélda a fő funkciót mutatja be. Mielőtt a projektjében használná, győződjön meg róla, hogy frissíti a fájlútvonalakat és a konfigurációs értékeket, hogy megfeleljenek a tényleges környezetének, ellenőrizze, hogy minden szükséges függőség megfelelően telepítve van, és alaposan tesztelje a fejlesztői környezetben. Ha problémákba ütközik, kérjük, tekintse meg a hivatalos dokumentációt vagy lépjen kapcsolatba a támogatói csapattal segítségért.

3D modellek konvertálása cURL és a REST API használatával

Ha inkább közvetlenül a REST végpontokkal szeretne dolgozni, az alábbi cURL parancsok ugyanazt az eredményt érik el.

Hitelesítés és hozzáférési token lekérése

Cserélje ki a YOUR_CLIENT_ID és a YOUR_CLIENT_SECRET értékeket a hitelesítő adataira.

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"

A válasz tartalmaz egy access_token-t, amelyet a későbbi hívásokban használnak.

Töltsd fel a forrás OBJ fájlt

curl -X PUT "https://api.aspose.cloud/v3.0/3d/storage/file/sample.obj" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -T "sample.obj"

A konverzió végrehajtása

curl -X POST "https://api.aspose.cloud/v3.0/3d/convert/sample.obj?format=pdf&outPath=sample.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Töltse le a kimeneti PDF-et

curl -X GET "https://api.aspose.cloud/v3.0/3d/storage/file/sample.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o "output.pdf"

A paraméterek és a hibakezelés teljes listájáért tekintse meg az API referenciát.

Átalakítási lehetőségek: beállítások és finomhangolások

Az SDK több tulajdonságot tesz elérhetővé, amelyeket a convert3D hívása előtt állíthat be:

Kimeneti formátum - A Convert3DRequest harmadik argumentuma határozza meg a célformátumot (pdf ebben az útmutatóban). Változtassa png vagy jpeg-re képkimenethez.
Host URL - Ha regionális Aspose Cloud végpontot használ, módosítsa a $config->setHost('https://api-eu.aspose.cloud'); sort.
Időkorlátok - A StorageApi és a ThreeDApi egyaránt elfogadnak opcionális HTTP kliens konfigurációkat, ahol nagy fájlok esetén beállíthatja a kérések időkorlátját.

Ezek az opciók lehetővé teszik, hogy a konverziós folyamatot az Ön teljesítmény- és megfelelőségi követelményeihez igazítsa. A teljes listaért tekintse meg az API-referenciát.

Következtetés

Most már elsajátította a 3D‑ról PDF‑re konvertálást PHP‑ben az Aspose.Email Cloud SDK for PHP használatával. Az útmutató mindent lefedett a környezet beállításától egy teljes, termelésre kész szkriptig és egy cURL alternatíváig. Ne feledje, hogy az SDK egy kereskedelmi termék; a termékoldalon megtekintheti az ár részleteit, és a ideiglenes licenc oldal oldalon szerezhet be ideiglenes licencet értékeléshez. Integrálja ezt a munkafolyamatot saját alkalmazásaiba, hogy zökkenőmentes 3D dokumentumkezelést biztosítson felhasználóinak.

Gyakran Ismételt Kérdések

Mi a legegyszerűbb módja a 3D PDF konverziónak PHP-ben?
Az Aspose.Email Cloud SDK for PHP használata a legegyszerűbb módszer. A könyvtár elrejti a REST hívásokat, és lehetővé teszi, hogy néhány sor kóddal konvertálja a 3D modelleket PDF‑be.
Átalakíthatok más 3D formátumokat is az OBJ-n kívül ezzel a könyvtárral?
Igen, az SDK támogatja a STL, FBX, 3DS és más gyakori 3D formátumokat. Egyszerűen módosítsa a forrásfájl nevét, és az SDK elvégzi a PDF-re konvertálást.
Hogyan kezeljem a nagy 3D fájlokat a konverzió során?
Töltse fel a fájlt először az Aspose Cloud tárolóba, majd indítsa el a konverziót. Ez alacsonyan tartja a memóriahasználatot a szerveren. Nagyon nagy fájlok esetén fontolja meg azok felosztását, vagy az aszinkron konverziós API használatát.
Van mód a PDF kimenet testreszabására, például az oldal méretére vagy tájolására?
A konverziós API lehetővé teszi, hogy további paramétereket adjon meg a kérés törzsében. Tekintse meg az API referenciát a támogatott beállítások teljes listájáért.

Mielőtt elkezdené: Előfeltételek és telepítés#

Lépésről lépésre felépítve: 3D PDF konvertálás PHP-ben#

1. lépés: Konfiguráció betöltése és hitelesítő adatok beállítása#

2. lépés: API példányok inicializálása#

3. lépés: Forrás 3D fájl feltöltése#

4. lépés: 3D konvertálása PDF-be#

5. lépés: A keletkezett PDF letöltése#

6. lépés: Tároló tisztítása#

Teljes PHP szkript példa: 3D konvertálás PDF-be PHP-ben - Teljes szkript#

3D modellek konvertálása cURL és a REST API használatával#

Átalakítási lehetőségek: beállítások és finomhangolások#

Következtetés#

Gyakran Ismételt Kérdések#

Read More#