Word belgelerini görüntü önizlemelerine dönüştürmek, web portalları veya raporlama araçları oluştururken sık karşılaşılan bir ihtiyaçtır. Aspose.OMR Cloud SDK for PHP PHP geliştiricilerine, PHP içinde yüksek doğrulukla DOCX dosyalarını JPG dosyalarına programlı olarak dönüştürme imkanı sağlar. Bu öğreticide, eksiksiz bir PHP örneğini, eşdeğer cURL REST iş akışını ve ortamı hazırlamak için gereken her şeyi göreceksiniz. Sonunda, herhangi bir PHP uygulamasına entegre edilebilecek yeniden kullanılabilir bir çözüme sahip olacaksınız.

PHP Kullanarak Aspose.OMR Cloud SDK ile DOCX’i JPG’ye Dönüştürmek için Tam Çalışan Örnek

Bu örnek, bir DOCX dosyasını JPG görüntüsüne dönüştürmek için Aspose.OMR Cloud SDK for PHP kullanımını göstermektedir.

<?php
require __DIR__ . '/vendor/autoload.php';

use Aspose\OMR\Configuration;
use Aspose\OMR\Api\ConvertApi;
use Aspose\OMR\Model\ConvertDocumentRequest;
use Aspose\OMR\ApiException;

// -----------------------------------------------------------------------------
// Configuration – replace with your actual credentials
// -----------------------------------------------------------------------------
$config = new Configuration();
$config->setAppSid('YOUR_APP_SID');
$config->setApiKey('YOUR_API_KEY');

// -----------------------------------------------------------------------------
// Initialize the Convert API
// -----------------------------------------------------------------------------
$convertApi = new ConvertApi($config);

// -----------------------------------------------------------------------------
// File paths (adjust as needed)
// -----------------------------------------------------------------------------
$inputDocxPath  = __DIR__ . '/input.docx';
$outputJpgPath  = __DIR__ . '/output.jpg';

// -----------------------------------------------------------------------------
// Prepare request – stream the input file to avoid loading whole file into memory
// -----------------------------------------------------------------------------
$inputStream = fopen($inputDocxPath, 'rb');
if ($inputStream === false) {
    throw new RuntimeException("Unable to open input file: $inputDocxPath");
}

$request = new ConvertDocumentRequest();
$request->setFile($inputStream);          // Input DOCX stream
$request->setOutputFormat('jpg');         // Desired output format
$request->setOutputFileName('output.jpg'); // Optional: name for the generated file

try {
    // -------------------------------------------------------------------------
    // Perform conversion
    // -------------------------------------------------------------------------
    $responseStream = $convertApi->convertDocument($request);

// -------------------------------------------------------------------------
    // Write the resulting JPG to disk using a buffered copy (efficient for large files)
    // -------------------------------------------------------------------------
    $outputHandle = fopen($outputJpgPath, 'wb');
    if ($outputHandle === false) {
        throw new RuntimeException("Unable to open output file: $outputJpgPath");
    }

while (!feof($responseStream)) {
        $buffer = fread($responseStream, 8192);
        if ($buffer === false) {
            throw new RuntimeException('Error reading from response stream.');
        }
        fwrite($outputHandle, $buffer);
    }

fclose($outputHandle);
    fclose($inputStream);
    fclose($responseStream);

echo "Conversion successful. JPG saved to: $outputJpgPath\n";
} catch (ApiException $e) {
    // -------------------------------------------------------------------------
    // Handle API errors (e.g., authentication, unsupported format)
    // -------------------------------------------------------------------------
    fclose($inputStream);
    echo 'API Exception: ', $e->getMessage(), PHP_EOL;
    exit(1);
} catch (Exception $e) {
    // -------------------------------------------------------------------------
    // General error handling
    // -------------------------------------------------------------------------
    if (is_resource($inputStream)) {
        fclose($inputStream);
    }
    echo 'Error: ', $e->getMessage(), PHP_EOL;
    exit(1);
}

Not: Bu kod örneği temel işlevselliği göstermektedir. 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ğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgeler adresine bakın veya destek ekibi ile iletişime geçin.

cURL Kullanarak REST API ile DOCX’ten JPG’ye Dönüştürme

Saf bir REST yaklaşımını tercih ediyorsanız, aynı dönüşüm birkaç cURL komutuyla gerçekleştirilebilir.

  1. Erişim belirteci alın - yer tutucuları istemci 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"
  1. DOCX dosyasını yükleyin - önceki adımdan alınan token’ı kullanın.
curl -X PUT "https://api.aspose.cloud/v4.0/omr/storage/file/input.docx" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document" \
  --data-binary "@input.docx"
  1. JPG’ye Dönüştürme İsteği.
curl -X POST "https://api.aspose.cloud/v4.0/omr/convert" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "FileName": "input.docx",
        "OutputFormat": "jpg",
        "OutputFileName": "output.jpg"
      }' -o response.json
  1. Oluşturulan JPG’yi indirin.
curl -X GET "https://api.aspose.cloud/v4.0/omr/storage/file/output.jpg" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -o output.jpg

Tam bir referans için, resmi API belgelerine bakın.

Aspose.OMR Cloud SDK ile PHP’de DOCX’yi JPG’ye Dönüştürmeyi Açıklama

Aşağıdaki numaralı açıklama, PHP iş akışında DOCX’i JPG’ye dönüştüren PHP kodunun her bölümünü açıklar.

  1. Yapılandırma Ayarı - Configuration sınıfı AppSid ve ApiKey değerlerinizi tutar.
$config = new Configuration();
$config->setAppSid('YOUR_APP_SID');
$config->setApiKey('YOUR_API_KEY');
  1. API Başlatma - Yapılandırma ile bir ConvertApi örneği oluşturulur.
$convertApi = new ConvertApi($config);
  1. Giriş Akışını Hazırlama - DOCX dosyası, tüm dosyayı belleğe yüklemeyi önlemek için ikili akış olarak açılır.
$inputStream = fopen($inputDocxPath, 'rb');
  1. İsteği Oluşturma - ConvertDocumentRequest giriş akışını, istenen çıktı formatını (jpg) ve isteğe bağlı bir çıktı dosya adını belirtir.
$request = new ConvertDocumentRequest();
$request->setFile($inputStream);
$request->setOutputFormat('jpg');
$request->setOutputFileName('output.jpg');
  1. Dönüştürmeyi Yürütme ve Sonucu Kaydetme - convertDocument bir yanıt akışı döndürür ve bu akış, tamponlu bir kopyalama kullanılarak output.jpg dosyasına yazılır.
$responseStream = $convertApi->convertDocument($request);
$outputHandle = fopen($outputJpgPath, 'wb');
while (!feof($responseStream)) {
    $buffer = fread($responseStream, 8192);
    fwrite($outputHandle, $buffer);
}

Daha fazla ayrıntı için ConvertApi sınıfı hakkında, API referansı adresine bakın.

PHP’de Aspose.OMR Cloud SDK için Ortamı Hazırlama

  1. Composer aracılığıyla SDK’yı kurun
composer require aspose/aspose-omr-cloud

Paket, sürüm sayfası adresinden de indirilebilir.

  1. PHP sürümünü doğrulayın - SDK, PHP 7.2 veya daha yeni bir sürüm gerektirir.

  2. Kimlik bilgilerini ayarlayın - Koddaki YOUR_APP_SID ve YOUR_API_KEY değerlerini Aspose Cloud hesabınızdaki değerlerle değiştirin.

  3. Bağımlılıkları otomatik yükleme - vendor/autoload.php dosyası, Composer tarafından oluşturulan, tüm gerekli sınıfları yükler.

Bu adımları tamamladıktan sonra, PHP’de DOCX’i JPG’ye dönüştürmek için Aspose.OMR Cloud SDK kullanmaya hazırsınız.

Sonuç

Artık Aspose.OMR Cloud SDK ile PHP’de DOCX’i JPG’ye verimli bir şekilde dönüştürmeyi biliyorsunuz. Sağlanan kod örneği, REST cURL iş akışı ve kurulum talimatları, Laravel uygulamaları dahil herhangi bir PHP projesine entegre edilebilecek eksiksiz, üretim‑hazır bir çözüm sunar. Ticari kullanım için, Aspose.OMR Cloud SDK for PHP ürün sayfasından bir lisans satın alın; geçici bir lisans da geçici lisans sayfası üzerinden temin edilebilir. Word belgelerinizi yüksek‑kaliteli JPG görüntülerine dönüştürmeye bugün başlayın.

SSS

PHP’de DOCX’i JPG’ye nasıl dönüştürebilirim?
Aspose.OMR Cloud SDK for PHP’yi kullanın. SDK’yı kurduktan ve kimlik bilgilerinizi yapılandırdıktan sonra, yukarıdaki PHP kod örneği DOCX dosyasını JPG görüntüsüne dönüştürmek için tam adımları gösterir.

Laravel’de PHP ile DOCX’i JPG’ye dönüştürmek mümkün mü?
Evet. SDK, Laravel dahil herhangi bir PHP framework’üyle çalışır. Dönüştürme mantığını bir denetleyici veya servis sınıfı içinde yerleştirin ve rotalarınızdan çağırın.

DOCX’yi PHP’de Yüksek Çözünürlüklü JPG’ye dönüştürmenin en iyi yolu nedir?
Dönüştürme isteğinde çıktı çözünürlük parametrelerini (destekleniyorsa) ayarlayın. SDK, daha yüksek kaliteli JPG çıktısı için istek gövdesinde DPI ayarlarını belirtmenize olanak tanır.

Tek bir script ile PHP’de birden fazla DOCX’i JPG’ye dönüştürebilir miyim?
Kesinlikle. DOCX dosya yolu dizisi üzerinde döngü yapın, aynı ConvertApi örneğini yeniden kullanın ve her dosya için convertDocument metodunu çağırın. Bu yaklaşım toplu işleme için iyi ölçeklenir.

Daha Fazla Oku