3D მოდელის გადაყვანა PDF დოკუმენტად აძლიერებს მარტივ გაზიარებასა და ბეჭდვას ნებისმიერი პლატფორმაზე. Aspose.Email Cloud SDK for PHP უზრუნველყოფს ძლიერი ღრუბლოვანი ბიბლიოთეკას, რომელიც PHP-ში 3D‑ის PDF-ში გადაყვანას რამდენიმე 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 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)
SDK-ის დაყენებით და ავტორიზაციის დეტალებით, შეგიძლიათ გადახვიდეთ რეალურ კონვერსიის ნაბიჯებზე.
ნაბიჯ-ნაბიჯ შექმნა: 3D-დან PDF-ში გადაყვანა PHP-ში
ნაბიჯი 1: კონფიგურაციის ჩატვირთვა და ავტორიზაციის დეტალების დაყენება
ჯერ შექმენით Configuration ობიექტი და დააყენეთ თქვენი კლიენტის ID, საიდუმლო და ჰოსტი. ეს ობიექტი გადაეცემა ყველა 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 საბოლოო წერტილებთან მუშაობას, შემდეგი 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 endpoint‑ს, შეცვალეთ
$config->setHost('https://api-eu.aspose.cloud');. - ტაიმაუტები -
StorageApiდაThreeDApiორივე იღებს არასავალდებულო HTTP კლიენტის კონფიგურაციებს, სადაც შეგიძლიათ განსაზღვროთ მოთხოვნის ტაიმაუტები დიდი ფაილებისთვის.
ამ არჩევანებმა საშუალებას მოგცემთ, რომ გადაყვანის პროცესი შეესაბამებოდეს თქვენი წარმადობისა და შესაბამისობის მოთხოვნებს. სრული სიისთვის მიმართეთ API მითითება.
დასკვნა
თქვენ ახლა მასტერკარგეთ 3D‑დან PDF-ზე გადაყვანა PHP-ში, იყენებთ Aspose.Email Cloud SDK for PHP. გიდში აღწერილია ყველაფერი გარემოს დაყენებიდან სრულ, პროდუქციისთვის მზად სკრიპტამდე და cURL ალტერნატივამდე. გახსოვდეთ, რომ SDK კომერციული პროდუქტია; შეგიძლიათ ნახოთ ფასის დეტალები პროდუქტის გვერდზე და მიიღოთ დროებითი ლიცენზია შეფასებისთვის დროებითი ლიცენზიის გვერდზე. ინტეგრირეთ ეს სამუშაო ნაკადი თქვენს აპლიკაციებში, რათა მომხმარებლებს შეუფერხებლად 3D დოკუმენტების დამუშავება მიწოდოთ.
FAQs
-
PHP-ში 3D-ს PDF-ში გადაყვანის ყველაზე მარტივი გზა რა არის?
Aspose.Email Cloud SDK for PHP-ის გამოყენება ყველაზე მარტივი მეთოდია. ბიბლიოთეკა აბსტრაქტირებულია REST-გამოძახებებიდან და საშუალებას გაძლევთ 3D მოდელები PDF-ში გადაყვანა რამდენიმე ხაზის კოდით. -
მიძლია სხვა 3D ფორმატებიც, გარდა OBJ-ის, გადაყვანა ამ ბიბლიოთეკით?
დიახ, SDK-ს აქვს მხარდაჭერა STL, FBX, 3DS და სხვა საერთო 3D ფორმატები. უბრალოდ შეცვალეთ წყაროს ფაილის სახელი და SDK-ს შეუძლია გადაყვანა PDF-ში. -
როგორ დავამუშავოთ დიდი 3D ფაილები კონვერსიისას?
ატვირთეთ ფაილი Aspose Cloud storage-ში პირველ რიგში, შემდეგ გაააქტიურეთ კონვერსია. ეს ხელს უწყობს მეხსიერების გამოყენების შემცირებას თქვენს სერვერზე. ძალიან დიდი ფაილებისთვის განიხილეთ მათი გაყოფა ან ასინქრონული კონვერსიის API-ის გამოყენება. -
PDF-ის გამოტანის პერსონალიზაციის, მაგალითად, გვერდის ზომის ან ორიენტაციის, გზა არსებობს?
გადაყვანის API-მა საშუალებას გაძლევთ მოთხოვნის სხეულში დამატებითი პარამეტრები განსაზღვროთ. იხილეთ API-ის მითითება მხარდაჭერილი პარამეტრების სრულ სიისთვის.