Конвертація 3D у PDF у PHP: Повний посібник для розробників

Перетворення 3D‑моделі у документ PDF відкриває можливість легкого обміну та друку на будь‑якій платформі. Aspose.Email Cloud SDK for PHP надає потужну хмарну бібліотеку, яка виконує конвертацію 3D у PDF у PHP за кілька викликів API. У цьому підручнику ви побачите, як налаштувати облікові дані, завантажити файл OBJ , викликати конвертацію, завантажити отриманий PDF і налаштувати кілька параметрів. Після завершення у вас буде багаторазовий PHP‑скрипт, який можна інтегрувати в будь‑який веб‑ або настільний застосунок.

Перш ніж розпочати: Попередні вимоги та встановлення

Вам потрібне середовище розробки PHP (рекомендовано PHP 8.0+) та встановлений Composer. Зареєструйтеся в акаунті Aspose Cloud, щоб отримати ваш Client Id та Client Secret.

Встановіть SDK за допомогою Composer:

composer require aspose/aspose-email-cloud

Завантажте пакет SDK, якщо ви віддаєте перевагу ручному встановленню: URL завантаження.

Наступний фрагмент показує блок конфігурації, який ви використаєте пізніше. Замініть значення‑заповнювачі обліковими даними з вашої панелі управління 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)

Після встановлення SDK та готовності облікових даних ви можете перейти до фактичних кроків конвертації.

Створюємо крок за кроком: конвертація 3D у PDF у PHP

Крок 1: Завантажте конфігурацію та встановіть облікові дані

Спочатку створіть об’єкт Configuration і встановіть ваш client ID, secret та host. Цей об’єкт буде передаватися всім екземплярам API.

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

Крок 2: Ініціалізувати екземпляри API

Створіть екземпляри StorageApi та ThreeDApi, використовуючи об’єкт конфігурації.

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

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

Крок 3: Завантажити вихідний 3D файл

Завантажте ваш локальний файл OBJ у сховище Aspose Cloud, щоб сервіс конвертації міг отримати до нього доступ.

use Aspose\ThreeD\Model\UploadFileRequest;

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

Крок 4: Конвертувати 3D у PDF

Запит на конвертацію з OBJ у PDF. Ім’я цільового файлу визначається змінною $targetPdfFile.

use Aspose\ThreeD\Model\Convert3DRequest;

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

Крок 5: Завантажити отриманий PDF

Отримайте новостворений PDF з хмарного сховища та збережіть його локально.

use Aspose\ThreeD\Model\DownloadFileRequest;

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

Крок 6: Очищення сховища

За бажанням видаліть вихідний OBJ та згенерований PDF з хмарного сховища, щоб підтримувати порядок у вашому обліковому записі.

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

Після виконання цих кроків ви успішно здійснили конвертацію 3D у PDF за допомогою PHP.

Повний приклад PHP-скрипту: конвертація 3D у PDF у PHP - Повний скрипт

Нижче наведений приклад демонструє повний робочий процес в одному файлі. Скопіюйте його у PHP‑проект і налаштуйте заповнювачі облікових даних.

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

Примітка: Цей приклад коду демонструє основну функціональність. Перш ніж використовувати його у вашому проєкті, переконайтеся, що оновили всі шляхи до файлів та значення конфігурації відповідно до вашого реального середовища, перевірте, що всі необхідні залежності правильно встановлені, і ретельно протестуйте у вашому середовищі розробки. Якщо ви зіткнетеся з будь-якими проблемами, будь ласка, зверніться до офіційної документації або зв’яжіться з командою підтримки для отримання допомоги.

Конвертування 3D моделей за допомогою cURL та REST API

Якщо ви віддаєте перевагу працювати безпосередньо з REST‑endpoint’ами, наступні команди cURL досягають того ж результату.

Аутентифікація та отримання токену доступу

Замініть YOUR_CLIENT_ID і YOUR_CLIENT_SECRET вашими обліковими даними.

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"

Відповідь містить access_token, який використовується в подальших викликах.

Завантажте вихідний файл OBJ

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

Виконати конвертацію

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

Завантажте вихідний PDF

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

Для повного списку параметрів та обробки помилок перегляньте довідка API.

Параметри конвертації: налаштування та коригування

SDK надає кілька властивостей, які ви можете налаштувати перед викликом convert3D:

Формат виводу - Третій аргумент Convert3DRequest визначає цільовий формат (pdf у цьому підручнику). Змініть його на png або jpeg для виводу зображень.
URL хоста - Якщо ви використовуєте регіональний кінцевий пункт Aspose Cloud, змініть $config->setHost('https://api-eu.aspose.cloud');.
Тайм‑аути - Обидва StorageApi і ThreeDApi приймають необов’язкові конфігурації HTTP‑клієнта, де ви можете встановити тайм‑аути запитів для великих файлів.

Ці параметри дозволяють налаштувати процес конвертації відповідно до ваших вимог щодо продуктивності та відповідності. Для повного списку зверніться до довідка API.

Висновок

Тепер ви освоїли конвертацію 3D у PDF у PHP за допомогою Aspose.Email Cloud SDK for PHP. Посібник охопив усе: від налаштування середовища до повного, готового до продакшну скрипту та альтернативи cURL. Пам’ятайте, що SDK є комерційним продуктом; ви можете переглянути деталі ціноутворення на сторінці продукту та отримати тимчасову ліцензію для оцінки на сторінці тимчасової ліцензії. Інтегруйте цей робочий процес у свої власні застосунки, щоб забезпечити безперешкодну обробку 3D‑документів для ваших користувачів.

FAQs

Який найпростіший спосіб виконати конвертацію 3D у PDF у PHP?
Використання Aspose.Email Cloud SDK for PHP є найпростіший метод. Бібліотека абстрагує REST‑виклики і дозволяє конвертувати 3D‑моделі у PDF всього кількома рядками коду.
Чи можу я конвертувати інші 3D формати, крім OBJ, за допомогою цієї бібліотеки?
Так, SDK підтримує STL, FBX, 3DS та інші поширені 3D формати. Просто змініть назву вихідного файлу, і SDK виконає конвертацію у PDF.
Як обробляти великі 3D файли під час конвертації?
Завантажте файл у сховище Aspose Cloud спочатку, а потім запустіть конвертацію. Це зменшує використання пам’яті на вашому сервері. Для дуже великих файлів розгляньте можливість розділення їх або використання асинхронного API конвертації.
Чи є спосіб налаштувати вихідний PDF, наприклад розмір сторінки або орієнтацію?
API конвертації дозволяє вказати додаткові параметри у тілі запиту. Дивіться довідка API для повного списку підтримуваних параметрів.

Перш ніж розпочати: Попередні вимоги та встановлення#

Створюємо крок за кроком: конвертація 3D у PDF у PHP#

Крок 1: Завантажте конфігурацію та встановіть облікові дані#

Крок 2: Ініціалізувати екземпляри API#

Крок 3: Завантажити вихідний 3D файл#

Крок 4: Конвертувати 3D у PDF#

Крок 5: Завантажити отриманий PDF#

Крок 6: Очищення сховища#

Повний приклад PHP-скрипту: конвертація 3D у PDF у PHP - Повний скрипт#

Конвертування 3D моделей за допомогою cURL та REST API#

Параметри конвертації: налаштування та коригування#

Висновок#

FAQs#

Read More#