PHP kullanarak Word Belgesini HTML Sayfasında görüntüleyin.

DOC veya DOCX dosyalarını HTML web sayfalarında programlı olarak bulutta kolayca işleyebiliriz. Orijinal dosyaları paylaşmadan Word belgelerini herhangi bir tarayıcıda görüntülemede yararlı olabilir. Bu yazıda, PHP’de bir REST API kullanarak bir Word belgesini bir HTML sayfasında nasıl görüntüleyeceğimizi öğreneceğiz.

Bu yazıda aşağıdaki konular ele alınacaktır:

Word’den HTML’ye Görüntüleyici REST API ve PHP SDK

Word belgelerini HTML’de işlemek için GroupDocs.Viewer Cloud’un PHP SDK’sı API’sini kullanacağız. Desteklenen belge ve görüntü dosyası formatlarının programlı olarak oluşturulmasına ve görüntülenmesine olanak tanır. Lütfen konsolda aşağıdaki komutu kullanarak kurun:

composer require groupdocscloud/groupdocs-viewer-cloud

Kurulumdan sonra, SDK’yı aşağıda gösterildiği gibi kullanmak için lütfen Bestecilerin autoload aracını kullanın:

require_once('vendor/autoload.php');

Belirtilen adımları izlemeden önce lütfen panodan Müşteri Kimliğinizi ve Sırrınızı alın. Kimliğinizi ve sırrınızı aldıktan sonra, kodu aşağıda gösterildiği gibi ekleyin:

// Bu kod örneği, koda istemci Kimliği ve Sırrı'nın nasıl ekleneceğini gösterir.
static $ClientId = '659fe7da-715b-4744-a0f7-cf469a392b73';
static $ClientSecret = 'b377c36cfa28fa69960ebac6b6e36421';

static $ApiBaseUrl = 'https://api.groupdocs.cloud';
static $MyStorage = '';

// Yapılandırma başlatılıyor
$configuration = new GroupDocs\Viewer\Configuration();

// Yapılandırmaları ayarlama
$configuration->setAppSid(self::$ClientId);
$configuration->setAppKey(self::$ClientSecret);
$configuration->setApiBaseUrl(self::$ApiBaseUrl);

PHP’de REST API kullanarak Word Belgesini HTML Sayfasında Görüntüle

Aşağıda verilen basit adımları izleyerek bir Word belgesinin içeriğini HTML’de görüntüleyebiliriz:

  1. DOCX dosyasını buluta Yükle
  2. Word Belgesini HTML Sayfasında Görüntüle
  3. Oluşturulan dosyayı İndir

Belgeyi Yükle

Öncelikle aşağıda verilen kod örneğini kullanarak DOCX dosyasını buluta yükleyeceğiz:

// Bu kod örneği, bir DOCX dosyasının buluta nasıl yükleneceğini gösterir.
// api'yi başlat
$apiInstance = new GroupDocs\Viewer\FileApi($configuration);

// Giriş dosyası yolu
$file = "C:\\Files\\Viewer\\input.docx";

// Dosya isteği yükle
$request = new GroupDocs\Viewer\Model\Requests\uploadFileRequest("input.docx", $file);

// Dosya yükleme
$response = $apiInstance->uploadFile($request);

Sonuç olarak, yüklenen dosya bulut üzerindeki kontrol panelinin dosyalar bölümünde mevcut olacaktır.

PHP kullanarak HTML Sayfasında Word Belgesini Görüntüle

Şimdi, aşağıda verilen adımları izleyerek yüklenen bir Word belgesinin içeriğini HTML sayfalarında oluşturacağız veya görüntüleyeceğiz:

  1. Öncelikle, ViewAPI’nin bir örneğini oluşturun.
  2. Ardından, ViewOptions’ın bir örneğini oluşturun.
  3. Ardından, giriş dosyası yolunu sağlayın.
  4. Ayrıca, ViewFormat’ı “HTML” olarak ayarlayın.
  5. Ardından, HtmlOptions nesnesini başlatın.
  6. Ardından, IsResponsive, ForPrinting vb. gibi çeşitli özellikleri ayarlayın.
  7. Bundan sonra, bağımsız değişken olarak ViewOptions ile CreateViewRequest oluşturun.
  8. Son olarak, createView() yöntemini kullanarak Word’ü HTML’ye dönüştürün.

Aşağıdaki kod örneği, PHP’de bir REST API kullanarak bir Word dosyasının HTML’de nasıl görüntüleneceğini gösterir.

// Bu kod örneği, DOCX'in HTML'ye nasıl dönüştürüleceğini gösterir.
// api'yi başlat
$apiInstance = new GroupDocs\Viewer\ViewApi($configuration);

// ViewOptions'ı tanımlayın
$viewOptions = new Model\ViewOptions();

// Giriş dosyası yolu
$fileInfo = new Model\FileInfo();
$fileInfo->setFilePath("input.docx");	
$viewOptions->setFileInfo($fileInfo);

// ViewFormat'ı Ayarla
$viewOptions->setViewFormat(Model\ViewOptions::VIEW_FORMAT_HTML);

// HTML seçeneklerini tanımlayın
$renderOptions = new Model\HtmlOptions();

// Duyarlı olacak şekilde ayarlayın
$renderOptions->setIsResponsive(true);

// Yazdırma için ayarla
$renderOptions->setForPrinting(true);

// Oluşturma seçeneklerini atayın
$viewOptions->setRenderOptions($renderOptions);

// Görünüm isteği oluştur
$request = new Requests\CreateViewRequest($viewOptions);

// Görünüm oluştur
$response = $apiInstance->createView($request);

// Tamamlamak
echo "HtmlViewerResponsiveLayout completed: ", count($response->getPages());
echo "\n";
PHP'de REST API kullanarak Word Belgesini HTML Sayfasında Görüntüle

PHP’de REST API kullanarak Word Belgesini HTML Sayfasında görüntüleyin.

Aşağıdaki seçenekleri uygulayarak Word’ün HTML’ye dönüştürülmesini özelleştirebiliriz:

  • Belirli sayfa aralığını oluştur
// Pass specific range of page numbers to render. 
// This will render all pages from starting from page 1 to 3.
$renderOptions->setStartPageNumber(1);
$renderOptions->setCountPagesToRender(3);
  • Yalnızca seçili sayfaları oluştur
// Pass specific page numbers to render. 
// This will render only page number 1 and 3.
$renderOptions->setPagesToRender([1, 3]);
  • Sayfaları belirli bir sırayla görüntüleyin
// Pass page numbers in the order you want to render them
$renderOptions->setPagesToRender([2, 1]);
  • Belgeyi yorumlarla işleyin
$renderOptions->setRenderComments(true);

HTML Sayfalarını İndirin

Yukarıdaki kod örneği, işlenen HTML sayfalarını buluta kaydedecektir. Aşağıdaki kod örneği kullanılarak indirilebilir:

// Bu kod örneği, işlenen HTML sayfalarının buluttan nasıl indirileceğini gösterir.
$fileApi = new GroupDocs\Viewer\FileApi($configuration);

// Tüm sayfaları al
$pages = $response->getPages();

// Sayfaları tek tek kaydedin
foreach ($pages as $page)
{
    // İndirme dosyası isteği oluştur
    $downloadFileRequest = new GroupDocs\Viewer\Model\Requests\DownloadFileRequest($page->getPath(), "");

    // Dosyayı indir
    $file = $fileApi->DownloadFile($downloadFileRequest);
    echo "$page downloaded!";
    echo "\n"; 
}

Word Belgesini Mevcut HTML Sayfasına Göm

Aşağıda verilen adımları izleyerek bir Word Belgesini mevcut bir HTML sayfasına da gömebiliriz:

  1. İlk olarak, ViewAPI ve FileAPI örneklerini oluşturun.
  2. Ardından, ViewOptions’ın bir örneğini oluşturun.
  3. Ardından, giriş dosyası yolunu sağlayın.
  4. Ayrıca, ViewFormat’ı “HTML” olarak ayarlayın.
  5. Ardından, HtmlOptions nesnesini başlatın.
  6. Ardından, IsResponsive, ForPrinting vb. gibi çeşitli özellikleri ayarlayın.
  7. Bundan sonra, bağımsız değişken olarak ViewOptions ile CreateViewRequest oluşturun.
  8. Ardından, createView() yöntemini kullanarak Word’ü HTML’ye dönüştürün.
  9. Ardından, mevcut bir HTML dosyasını yükleyin ve gövde etiketinin öğelerini alın
  10. Ardından, her sayfanın HTML’sini okuyun ve gövde etiketine ekleyin
  11. Bundan sonra, saveHTML() yöntemini kullanarak güncellenmiş HTML’yi kaydedin.
  12. Son olarak, file\put\contents() yöntemini kullanarak HTML dosyasını kaydedin.

Aşağıdaki kod örneği, PHP’de bir REST API kullanarak bir Word belgesinin varolan bir HTML sayfasına nasıl gömüleceğini gösterir.

// Bu kod örneği, DOCX'in HTML'ye nasıl dönüştürüleceğini gösterir.
// api'yi başlat
$apiInstance = new GroupDocs\Viewer\ViewApi($configuration);
$fileApi = new GroupDocs\Viewer\FileApi($configuration);

// ViewOptions'ı tanımlayın
$viewOptions = new Model\ViewOptions();

// Giriş dosyası yolu
$fileInfo = new Model\FileInfo();
$fileInfo->setFilePath("input.docx");	
$viewOptions->setFileInfo($fileInfo);

// ViewFormat'ı Ayarla
$viewOptions->setViewFormat(Model\ViewOptions::VIEW_FORMAT_HTML);

// HTML seçeneklerini tanımlayın
$renderOptions = new Model\HtmlOptions();

// Duyarlı olacak şekilde ayarlayın
$renderOptions->setIsResponsive(true);

// Yazdırma için ayarla
$renderOptions->setForPrinting(true);

// Oluşturma seçeneklerini atayın
$viewOptions->setRenderOptions($renderOptions);

// Görünüm isteği oluştur
$request = new Requests\CreateViewRequest($viewOptions);

// Görünüm oluştur
$response = $apiInstance->createView($request);

// Mevcut bir HTML dosyasını yükleyin
$domDoc = new DOMDocument();
$domDoc->loadHTMLFile("C:\Files\Viewer\Sample.html");
$body = $domDoc->GetElementsByTagName('body')->item(0);

// Sayfaları al
$pages = $response->getPages();

// Oluşturulan tüm HTML sayfalarını mevcut HTML'nin gövde etiketine gömün
foreach ($pages as $page)
{
    // İndirme dosyası isteği oluştur
    $downloadFileRequest = new GroupDocs\Viewer\Model\Requests\DownloadFileRequest($page->getPath(), "");

    // Dönüştürülen sayfayı indir
    $file = $fileApi->DownloadFile($downloadFileRequest);

    // İndirilen dosyadan HTML'yi okuyun
    $html = file_get_contents($file->getRealPath());

    //Parçalanacak içerik ekleyin
    $fragment = $domDoc->createDocumentFragment();
    $fragment->appendXML("<div>$html</div>");

    // Öğeyi gövdeye ekle
    $body->appendChild($fragment);
}

// Güncellenen HTML'yi kaydet
$output = $domDoc->saveHTML();

// Dosya 'yı kaydet
file_put_contents("C:\Files\Viewer\Sample.html", $output);
Word Belgesini Mevcut Bir HTML Sayfasına Göm

Bir Word Belgesini Mevcut Bir HTML Sayfasına Gömün.

PHP kullanarak Word Belgesini Filigranlı HTML’de Görüntüleme

Word belgelerini HTML sayfalarına çevirirken aşağıdaki adımları izleyerek programlı olarak filigran metni ekleyebiliriz:

  1. Öncelikle, bir ViewAPI örneği oluşturun.
  2. Ardından, ViewOptions’ın bir örneğini oluşturun.
  3. Ardından, giriş dosyası yolunu sağlayın.
  4. Ayrıca, ViewFormat’ı “HTML” olarak ayarlayın.
  5. Ardından, bir Filigran örneği oluşturun ve atayın.
  6. Ardından, filigran boyutunu ve metni ayarlayın.
  7. Bundan sonra, bağımsız değişken olarak ViewOptions ile CreateViewRequest oluşturun.
  8. Son olarak, createView() yöntemini kullanarak Word’ü HTML’ye dönüştürün.

Aşağıdaki kod örneği, PHP’de bir REST API kullanarak HTML’de bir Word belgesinin filigranla nasıl görüntüleneceğini gösterir.

// Bu kod örneği, Word'ün Filigran ile HTML'de nasıl oluşturulacağını gösterir.
// api'yi başlat
$apiInstance = new GroupDocs\Viewer\ViewApi($configuration);

// ViewOptions'ı tanımlayın
$viewOptions = new Model\ViewOptions();

// Giriş dosyası yolu
$fileInfo = new Model\FileInfo();
$fileInfo->setFilePath("input.docx");				
$viewOptions->setFileInfo($fileInfo);

// ViewFormat'ı Ayarla
$viewOptions->setViewFormat(Model\ViewOptions::VIEW_FORMAT_HTML);

// Filigranı Tanımla
$watermark = new Model\Watermark();
$watermark->setText("This is sample text watermark!");
$watermark->setSize(100);
$watermark->setColor("Red");
$viewOptions->setWatermark($watermark);

// Görünüm isteği oluştur
$request = new Requests\CreateViewRequest($viewOptions);

// Görünüm oluştur
$response = $apiInstance->createView($request);

// Tamamlamak
echo "AddWatermark completed: ", count($response->getPages());
echo "\n";
PHP kullanarak Word Belgesini Filigranlı HTML'de görüntüleyin.

PHP kullanarak Word Belgesini Filigranlı HTML’de görüntüleyin.

Çevrimiçi Deneyin

Lütfen yukarıdaki API kullanılarak geliştirilen aşağıdaki ücretsiz çevrimiçi DOCX oluşturma aracını deneyin. https://products.groupdocs.app/viewer/docx

Çözüm

Bu makalede, şunların nasıl yapılacağını öğrendik:

  • PHP kullanarak Word belgesini tarayıcı destekli bir HTML web sayfasında görüntüleyin;
  • Word’ün HTML’ye dönüştürülmesini özelleştirin;
  • Word belgesini mevcut bir HTML web sayfasına gömün;
  • filigranlı HTML’de bir Word dosyasının içeriğini görüntüleyin;
  • programlı olarak DOCX dosyasını buluta yükleyin;
  • işlenen HTML dosyalarını buluttan indirin.

Ayrıca belgeleri kullanarak GroupDocs.Viewer Cloud API hakkında daha fazla bilgi edinebilirsiniz. Ayrıca, API’lerimizi doğrudan tarayıcı aracılığıyla görselleştirmenize ve bunlarla etkileşim kurmanıza olanak tanıyan bir API Referansı bölümü de sağlıyoruz. Herhangi bir belirsizlik durumunda, lütfen forumda bizimle iletişime geçmekten çekinmeyin.

Ayrıca bakınız