המרת מודל תלת‑ממדי למסמך PDF פותחת אפשרות לשיתוף והדפסה קלים בכל פלטפורמה.
Aspose.Email Cloud SDK for PHP מספקת ספרייה חזקה מבוססת ענן שמטפלת בהמרת תלת‑ממד ל‑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 אם אתם מעדיפים התקנה ידנית: כתובת הורדה.
הקטע הבא מציג את בלוק ההגדרות שבו תשתמש מאוחר יותר. החלף את ערכי מציין המקום עם האישורים מלוח המחוונים של 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 והגדר את מזהה הלקוח, הסוד וה‑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";
הערה: דוגמת קוד זו מדגימה את הפונקציונליות המרכזית. לפני השימוש בפרויקט שלך, ודא שאתה מעדכן את כל נתיבי הקבצים וערכי ההגדרות כך שיתאימו לסביבה האמיתית שלך, מאמת שכל התלויות הנדרשות מותקנות כראוי, ובודק באופן מקיף בסביבת הפיתוח שלך. אם אתה נתקל בבעיות, אנא הפנה אל התיעוד הרשמי או פנה אל צוות התמיכה לקבלת סיוע.
המרת מודלים תלת-ממדיים באמצעות 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:
- Output Format - הפרמטר השלישי של
Convert3DRequestמגדיר את הפורמט היעד (pdfבמדריך זה). שנה אותו ל-pngאוjpegלקבלת פלט תמונה. - Host URL - אם אתה משתמש בנקודת קצה אזורית של Aspose Cloud, שנה את
$config->setHost('https://api-eu.aspose.cloud');. - Timeouts - גם
StorageApiוגםThreeDApiמקבלים תצורות לקוח HTTP אופציונליות שבהן ניתן להגדיר זמני קצוב לבקשות עבור קבצים גדולים.
אפשרויות אלה מאפשרות לך להתאים את תהליך ההמרה לדרישות הביצועים והציות שלך. לרשימה מלאה, עיין ב-תיעוד API.
מסקנה
כעת השתלטת על המרת 3D ל‑PDF ב‑PHP באמצעות Aspose.Email Cloud SDK for PHP. המדריך כיסה את כל הדברים מהגדרת הסביבה ועד סקריפט מלא, מוכן לייצור, ואלטרנטיבה של cURL. זכור שה‑SDK הוא מוצר מסחרי; אתה יכול לעיין בפרטי התמחור בעמוד המוצר ולקבל רישיון זמני להערכה ב‑דף הרישיון הזמני. שלב זרימת עבודה זו באפליקציות שלך כדי לספק טיפול חלק במסמכי 3D למשתמשים שלך.
שאלות נפוצות
-
מהי הדרך הקלה ביותר לבצע המרת 3D ל-PDF ב-PHP?
שימוש ב-Aspose.Email Cloud SDK for PHP הוא השיטה הפשוטה ביותר. הספרייה ממחישה את קריאות ה-REST ומאפשרת לך להמיר מודלים תלת‑ממדיים ל-PDF עם כמה שורות קוד בלבד. -
האם אני יכול להמיר פורמטים תלת‑ממדיים אחרים חוץ מ‑OBJ עם הספרייה הזו?
כן, ה‑SDK תומך ב‑STL, ב‑FBX, ב‑3DS ובפורמטים תלת‑ממדיים נפוצים אחרים. פשוט שנה את שם קובץ המקור וה‑SDK יטפל בהמרה ל‑PDF. -
איך אני מתמודד עם קבצי 3D גדולים במהלך ההמרה?
העלה את הקובץ ל‑Aspose Cloud storage תחילה, ואז הפעל את ההמרה. זה משאיר את השימוש בזיכרון נמוך בשרת שלך. עבור קבצים גדולים מאוד שקול לפצל אותם או להשתמש ב‑asynchronous conversion API. -
האם יש דרך להתאים את פלט ה-PDF, כגון גודל העמוד או כיווניות?
ה-API להמרה מאפשר לך לציין פרמטרים נוספים בגוף הבקשה. עיין ב-API reference לרשימה המלאה של האפשרויות הנתמכות.