3D modeli bir PDF belgesine dönüştürmek, herhangi bir platformda kolay paylaşım ve yazdırma imkanı sağlar. Aspose.Email Cloud SDK for PHP güçlü bir bulut‑tabanlı kütüphane sunar ve PHP’de sadece birkaç API çağrısıyla 3D’den PDF’ye dönüşümü gerçekleştirir. Bu öğreticide kimlik bilgilerinizi nasıl yapılandıracağınızı, bir OBJ dosyasını nasıl yükleyeceğinizi, dönüşümü nasıl tetikleyeceğinizi, ortaya çıkan PDF’yi nasıl indireceğinizi ve birkaç seçeneği nasıl ince ayar yapacağınızı göreceksiniz. Sonunda, herhangi bir web veya masaüstü uygulamasına entegre edilebilecek yeniden kullanılabilir bir PHP betiğine sahip olacaksınız.
Başlamadan Önce: Gereksinimler ve Kurulum
PHP 8.0+ (önerilen) bir PHP geliştirme ortamına ve Composer kurulu olmasına ihtiyacınız var. Aspose Cloud hesabına kaydolun ve Client Id ve Client Secret bilgilerinizi alın.
Composer ile SDK’yı kurun:
composer require aspose/aspose-email-cloud
Manuel kurulum tercih ediyorsanız SDK paketini indirin: İndirme URL’si.
Aşağıdaki kod parçacığı, daha sonra yeniden kullanacağınız yapılandırma bloğunu gösterir. Yer tutucu değerleri, Aspose Cloud panosundaki kimlik bilgileriyle değiştirin.
<?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 yüklendi ve kimlik bilgileri hazır olduğunda, gerçek dönüşüm adımlarına geçebilirsiniz.
Adım Adım Oluşturma: PHP’de 3D’den PDF’ye Dönüştürme
Adım 1: Yapılandırmayı Yükle ve Kimlik Bilgilerini Ayarla
İlk olarak, bir Configuration nesnesi oluşturun ve istemci kimliğinizi, gizli anahtarınızı ve ana bilgisayarınızı ayarlayın. Bu nesne tüm API örneklerine geçirilecektir.
$config = new Configuration();
$config->setAppSid('YOUR_CLIENT_ID');
$config->setAppKey('YOUR_CLIENT_SECRET');
$config->setHost('https://api.aspose.cloud');
Adım 2: API Örneklerini Başlatın
Yapılandırma nesnesini kullanarak StorageApi ve ThreeDApi örneklerini oluşturun.
use Aspose\ThreeD\Api\ThreeDApi;
use Aspose\ThreeD\Api\StorageApi;
$storageApi = new StorageApi(null, $config);
$threeDApi = new ThreeDApi(null, $config);
Adım 3: Kaynak 3B Dosyasını Yükle
Yerel OBJ dosyanızı Aspose Cloud depolama alanına yükleyin, böylece dönüşüm hizmeti ona erişebilir.
use Aspose\ThreeD\Model\UploadFileRequest;
$source3DFile = 'sample.obj'; // Input 3D model file
$uploadRequest = new UploadFileRequest($source3DFile, $source3DFile);
$storageApi->uploadFile($uploadRequest);
Adım 4: 3D’yi PDF’ye Dönüştür
OBJ’den PDF’ye dönüşüm isteyin. Hedef dosya adı $targetPdfFile tarafından tanımlanır.
use Aspose\ThreeD\Model\Convert3DRequest;
$targetPdfFile = 'sample.pdf'; // Desired output PDF name
$convertRequest = new Convert3DRequest($source3DFile, $targetPdfFile, 'pdf');
$threeDApi->convert3D($convertRequest);
Adım 5: Oluşturulan PDF’yi İndir
Yeni oluşturulan PDF’yi bulut depolamadan alıp yerel olarak kaydedin.
use Aspose\ThreeD\Model\DownloadFileRequest;
$downloadRequest = new DownloadFileRequest($targetPdfFile);
$response = $storageApi->downloadFile($downloadRequest);
$localPdfPath = __DIR__ . '/output.pdf';
file_put_contents($localPdfPath, $response->getContent());
Adım 6: Depolamayı Temizle
Hesabınızı düzenli tutmak için kaynak OBJ’yi ve oluşturulan PDF’yi bulut depolamadan isteğe bağlı olarak silebilirsiniz.
$storageApi->deleteFile(new \Aspose\ThreeD\Model\DeleteFileRequest($source3DFile));
$storageApi->deleteFile(new \Aspose\ThreeD\Model\DeleteFileRequest($targetPdfFile));
Bu adımları tamamlayarak, PHP’de 3D’den PDF’ye dönüşümü başarıyla gerçekleştirdiniz.
Tam PHP Betik Örneği: PHP’de 3D’den PDF’ye Dönüştürme - Tam Betik
Aşağıdaki örnek, tek bir dosyada tam iş akışını gösterir. Bunu bir PHP projesine kopyalayın ve kimlik bilgisi yer tutucularını ayarlayın.
<?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";
Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce, dosya yollarını ve yapılandırma değerlerini gerçek ortamınıza uygun şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğini doğruladığınızdan ve geliştirme ortamınızda kapsamlı bir şekilde test ettiğinizden emin olun. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgeler adresine bakın veya destek ekibi ile iletişime geçin.
cURL ve REST API Kullanarak 3D Modelleri Dönüştürme
REST uç noktalarıyla doğrudan çalışmayı tercih ediyorsanız, aşağıdaki cURL komutları aynı sonucu verir.
- Kimlik Doğrulama ve Erişim Token’ı Al
YOUR_CLIENT_ID ve YOUR_CLIENT_SECRET değerlerini kimlik bilgilerinizle değiştirin.
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"
Yanıt, sonraki çağrılarda kullanılan bir access_token içerir.
- Kaynak OBJ Dosyasını Yükle
curl -X PUT "https://api.aspose.cloud/v3.0/3d/storage/file/sample.obj" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-T "sample.obj"
- Dönüşümü Gerçekleştir
curl -X POST "https://api.aspose.cloud/v3.0/3d/convert/sample.obj?format=pdf&outPath=sample.pdf" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
- Çıktı PDF’sini İndir
curl -X GET "https://api.aspose.cloud/v3.0/3d/storage/file/sample.pdf" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o "output.pdf"
Parametrelerin ve hata işleme hakkında tam liste için, API referansı sayfasına bakın.
Dönüştürme Seçenekleri: Ayarlar ve İnce Ayarlar
SDK, convert3D çağrısı yapılmadan önce ayarlayabileceğiniz çeşitli özellikleri sunar:
- Çıktı Biçimi -
Convert3DRequest‘in üçüncü argümanı hedef formatı tanımlar (pdfbu öğreticide). Görüntü çıktısı içinpngveyajpegolarak değiştirin. - Host URL - Bölgesel bir Aspose Cloud uç noktasını kullanıyorsanız,
$config->setHost('https://api-eu.aspose.cloud');satırını değiştirin. - Zaman Aşımı - Hem
StorageApihem deThreeDApi, büyük dosyalar için istek zaman aşımını ayarlayabileceğiniz isteğe bağlı HTTP istemci yapılandırmalarını kabul eder.
Bu seçenekler, dönüşüm sürecini performans ve uyumluluk gereksinimlerinize göre özelleştirmenizi sağlar. Tam bir liste için, API referansı adresine bakın.
Sonuç
Artık PHP’de 3D’den PDF’ye dönüşümü, Aspose.Email Cloud SDK for PHP kullanarak ustalaştınız. Rehber, ortam kurulumundan tam, üretim‑hazır bir betiğe ve bir cURL alternatifine kadar her şeyi kapsıyordu. SDK’ın ticari bir ürün olduğunu unutmayın; ürün sayfasında fiyat detaylarını inceleyebilir ve değerlendirme için geçici bir lisans alabilirsiniz geçici lisans sayfası. Bu iş akışını kendi uygulamalarınıza entegre ederek kullanıcılarınıza sorunsuz 3D belge işleme sağlayın.
FAQs
-
PHP’de 3D’den PDF’ye dönüşümün en kolay yolu nedir?
Aspose.Email Cloud SDK for PHP kullanmak en basit yöntemdir. Kütüphane REST çağrılarını soyutlar ve sadece birkaç satır kodla 3D modelleri PDF’ye dönüştürmenizi sağlar. -
Bu kütüphane ile OBJ dışındaki diğer 3D formatlarını dönüştürebilir miyim?
Evet, SDK STL, FBX, 3DS ve diğer yaygın 3D formatlarını destekler. Kaynak dosya adını değiştirmeniz yeterlidir, SDK PDF’ye dönüştürmeyi halleder. -
Büyük 3D dosyalarını dönüştürme sırasında nasıl yönetirim?
Dosyayı önce Aspose Cloud depolamasına yükleyin, ardından dönüşümü başlatın. Bu, sunucunuzdaki bellek kullanımını düşük tutar. Çok büyük dosyalar için dosyaları bölmeyi veya asenkron dönüşüm API’sini kullanmayı düşünün. -
PDF çıktısını, sayfa boyutu veya yönlendirme gibi, özelleştirmenin bir yolu var mı?
Dönüştürme API’si, istek gövdesinde ek parametreler belirtmenize olanak tanır. Desteklenen seçeneklerin tam listesi için API referansına bakın.