PHP'de DOCX'ten HTML'e: DOCX'ten HTML Oluşturma Öğreticisi

Zengin Word belgelerini web‑hazır HTML formatına dönüştürmek, modern PHP uygulamaları için sık bir ihtiyaçtır. GroupDocs.Conversion Cloud SDK for PHP bulutta ağır işleri halleden güçlü bir API sağlar. Bu öğreticide, SDK’yı kullanarak PHP’de DOCX‘i HTML’ye dönüştürmeyi gösteriyoruz. Kütüphaneyi nasıl kuracağınızı, tam bir kod örneğini nasıl çalıştıracağınızı ve aynı dönüşümü cURL çağrılarıyla nasıl yapacağınızı öğreneceksiniz.

PHP’de DOCX’i HTML’ye Dönüştürme - Adım Adım

Composer aracılığıyla SDK’yı kurun: Resmi Composer komutuyla kütüphaneyi projenize ekleyin.

composer require groupdocs-conversion-cloud

Konfigürasyonu Başlatın: Bir Configuration nesnesi oluşturun ve App SID ve App Key’inizi ayarlayın.

$config = new GroupDocs\Conversion\Cloud\Configuration();
$config->setAppSid('YOUR_APP_SID');
$config->setAppKey('YOUR_APP_KEY');

HTML Dönüştürme Seçeneklerini Yapılandırın: Görüntü çıkarma ve sayfa numarası işleme gibi ayarları düzenleyin.

$htmlOptions = new GroupDocs\Conversion\Cloud\Model\HtmlConvertOptions();
$htmlOptions->setExtractImages(true);
$htmlOptions->setPreserveOriginalPageNumbers(false);
$htmlOptions->setZipOutput(false);
$htmlOptions->setShowHiddenText(false);
$htmlOptions->setRenderToSinglePage(false);

Dönüştürme Ayarlarını Oluştur: Kaynak dosyayı, hedef formatı tanımlayın ve HTML seçeneklerini ekleyin.

$convertSettings = new GroupDocs\Conversion\Cloud\Model\ConvertSettings();
$convertSettings->setFilePath('sample.docx');
$convertSettings->setOutputPath('output.html');
$convertSettings->setFormat('html');
$convertSettings->setOptions($htmlOptions);

Dönüşümü Yürüt: convertDocument metodunu çağırın ve sonucu işleyin.

$convertApi = new GroupDocs\Conversion\Cloud\Api\ConvertApi($config);
try {
    $result = $convertApi->convertDocument($convertSettings);
    echo "Conversion succeeded. HTML file saved to: " . $result->getPath() . PHP_EOL;
} catch (Exception $e) {
    echo "Conversion failed: " . $e->getMessage() . PHP_EOL;
}

Her sınıf ve yöntem hakkında daha fazla ayrıntı için, API referansına bakın.

Tam Kod Örneği: PHP’de DOCX’ten HTML Oluşturma

Aşağıdaki örnek, SDK kullanarak tam uçtan‑uca bir dönüşümü göstermektedir.

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

use GroupDocs\Conversion\Cloud\Configuration;
use GroupDocs\Conversion\Cloud\Api\ConvertApi;
use GroupDocs\Conversion\Cloud\Model\ConvertSettings;
use GroupDocs\Conversion\Cloud\Model\HtmlConvertOptions;

$config = new Configuration();
$config->setAppSid('YOUR_APP_SID');
$config->setAppKey('YOUR_APP_KEY');

$convertApi = new ConvertApi($config);

$inputFilePath  = 'sample.docx';
$outputFilePath = 'output.html';

$htmlOptions = new HtmlConvertOptions();
$htmlOptions->setExtractImages(true);               // extract images to separate files
$htmlOptions->setPreserveOriginalPageNumbers(false);
$htmlOptions->setZipOutput(false);                  // generate plain HTML, not a zip archive
$htmlOptions->setShowHiddenText(false);
$htmlOptions->setRenderToSinglePage(false);

$convertSettings = new ConvertSettings();
$convertSettings->setFilePath($inputFilePath);
$convertSettings->setOutputPath($outputFilePath);
$convertSettings->setFormat('html');
$convertSettings->setOptions($htmlOptions);

try {
    $result = $convertApi->convertDocument($convertSettings);
    echo "Conversion succeeded. HTML file saved to: " . $result->getPath() . PHP_EOL;
} catch (Exception $e) {
    echo "Conversion failed: " . $e->getMessage() . PHP_EOL;
}

Not: Bu kod örneği temel işlevselliği göstermektedir. Projenizde kullanmadan önce dosya yollarını (sample.docx, output.html) gerçek dosya konumlarınıza göre 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 dokümantasyona bakın veya destek ekibi ile iletişime geçin.

cURL ve REST API Kullanarak DOCX Dosyalarını HTML’ye Dönüştürme

SDK ayrıca cURL ile çağrılabilen bir REST uç noktası sunar. Aşağıda tipik iş akışı gösterilmiştir.

Erişim Token’ı Al
YOUR_CLIENT_ID ve YOUR_CLIENT_SECRET değerlerini kimlik bilgilerinizle değiştirin.

curl -X POST "https://api.groupdocs.cloud/v2.0/oauth2/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

DOCX Dosyasını Yükleyin
Önceki adımdan aldığınız token’ı kullanın.

curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/storage/file/sample.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@sample.docx"

Dönüşümü Başlat
HTML’ye dönüşüm isteği.

curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "filePath": "sample.docx",
           "outputPath": "output.html",
           "format": "html",
           "options": {
               "extractImages": true,
               "zipOutput": false
           }
         }'

Oluşturulan HTML’yi İndir

curl -X GET "https://api.groupdocs.cloud/v2.0/conversion/storage/file/output.html" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.html

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

GroupDocs.Conversion Cloud SDK for PHP’yi Yükleme ve Yapılandırma

composer require groupdocs-conversion-cloud

En son paketi sürüm sayfası‘den indirin. SDK, PHP 7.4 veya daha yeni bir sürüm ve geçerli kimlik bilgilerine sahip aktif bir GroupDocs Cloud hesabı gerektirir.

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

use GroupDocs\Conversion\Cloud\Configuration;

$config = new Configuration();
$config->setAppSid('YOUR_APP_SID');   // obtain from your GroupDocs Cloud dashboard
$config->setAppKey('YOUR_APP_KEY');

GroupDocs.Conversion Cloud SDK for PHP DOCX’ten HTML’ye Özellikler

Görüntü Çıkarma - extractImages gömülü resimleri ayrı dosyalara çekmenizi sağlar ve düzen bütünlüğünü korur.
Sayfa Numarası Kontrolü - preserveOriginalPageNumbers sürekli bir HTML akışı üretmek için devre dışı bırakılabilir.
Düz HTML Çıktısı - zipOutput ayarını false yapmak, bir ZIP arşivi yerine tek bir HTML dosyası oluşturur ve sonraki işlemeyi basitleştirir.
Gizli Metin İşleme - showHiddenText gizli içeriğin son HTML’de görünüp görünmeyeceğini belirler.
Tek‑Sayfa Oluşturma - renderToSinglePage tüm sayfaları tek bir HTML belgesinde birleştirerek gömmeyi kolaylaştırır.

Tüm özellikler belgelerde açıklanmıştır.

Sonuç

PHP’de DOCX’i HTML’e dönüştürmek, GroupDocs.Conversion Cloud SDK for PHP ile çok basit hale gelir. Kütüphane, sunucuda Microsoft Office gerektirmeden karmaşık biçimlendirme, görüntü çıkarma ve sayfa yönetimini ele alır. Yukarıdaki adımları izledikten sonra, yerel SDK çağrılarını mı yoksa RESTful cURL isteklerini mi tercih ederseniz edin, DOCX’ten HTML’e dönüşümü herhangi bir PHP‑tabanlı iş akışına entegre edebilirsiniz. Üretim kullanımı için uygun bir lisans almayı unutmayın; fiyatlandırma detayları geçici lisans sayfasında mevcuttur. Bugün dönüştürmeye başlayın ve kullanıcılarınıza zengin, web‑hazır içerik sunun.

SSS

DOCX’i PHP’de ek bir yazılım kurmadan HTML’ye nasıl uygularım?
Bulut tabanlı SDK, tüm işlemleri GroupDocs sunucularında gerçekleştirir, bu yüzden yalnızca PHP kütüphanesine ve kimlik bilgilerinize ihtiyacınız var.
Tek bir istek içinde birden fazla DOCX dosyasını dönüştürebilir miyim?
API, kodunuzda dosyalar üzerinde döngü yaparak toplu dönüştürmeyi destekler; her çağrı kendi HTML sonucunu döndürür.
DOCX dosyasının içindeki görüntülerle ne olur?
extractImages etkinleştirildiğinde, görüntüler ayrı dosyalar olarak kaydedilir ve oluşturulan HTML’de referans verilir, böylece doğrudan sunabilirsiniz.
Oluşturulan HTML düzenini özelleştirmenin bir yolu var mı?
HTML çıktısını sonradan işleyebilir veya renderToSinglePage gibi dönüşüm seçeneklerini ayarlayarak yapıyı etkileyebilirsiniz.

PHP’de DOCX’i HTML’ye Dönüştürme - Adım Adım#

Tam Kod Örneği: PHP’de DOCX’ten HTML Oluşturma#

cURL ve REST API Kullanarak DOCX Dosyalarını HTML’ye Dönüştürme#

GroupDocs.Conversion Cloud SDK for PHP’yi Yükleme ve Yapılandırma#

GroupDocs.Conversion Cloud SDK for PHP DOCX’ten HTML’ye Özellikler#

Sonuç#

SSS#

Read More#