Sağdan sola Arapça HTML'i işleme

Bir bakışta

writeHtml() ile sağdan sola (RTL) HTML’i PDF’e dönüştürün. CSS direction: rtl özelliğini ayarlayın ve Arapça destekli bir yazı tipi kaydedin. Motor, metni Unicode Çift Yönlü Algoritması (UAX #9) ile görsel sıraya göre yeniden dizer ve Arapça harfleri bağlamsal biçimlere göre şekillendirir. Bu tarifte küçük bir Arapça fatura işlenir. RTL; Arapça, İbranice, Farsça ve Urduca için geçerlidir. İbranice yeniden sıralanır, ancak şekillendirilmez; bu, söz konusu yazı sistemi için doğru davranıştır.

Kurulum

composer require nextpdf/core

Ayrıca Arapça destekli bir TrueType veya OpenType yazı tipine ihtiyacınız vardır. Karakter eşlemesinin Arapça Presentation Forms-B bloğunu kapsaması gerekir. Noto Naskh Arabic ve Amiri uygun, açık lisanslı yazı tipi seçenekleridir.

Kavramsal genel bakış

RTL işleme iki girdi gerektirir: CSS direction: rtl özelliği ve kayıtlı bir Arapça yazı tipi.

direction: rtl, yerleşim motoruna metni sağdan sola yerleştirmesini söyler. Ardından motor, görsel sırayı çözümlemek için Unicode Çift Yönlü Algoritması’nı (UAX #9) kullanır. Karışık içerik doğru biçimde sıralanır: Latin sözcükler, Arapça sözcükler ve rakamlar kendi yönlerini korur. Arapça metinden sonra gelen bir sayı, rakamlarının soldan sağa sırasını korur.

Arapça bitişik yazılan bir yazı sistemidir; bu nedenle her harf, komşularına bağlı olarak farklı bir glif kullanır. Motor, her harf için başlangıç, orta, son veya yalın biçimi seçer ve Lam-Alef bitişik harfini uygular. Bu bağlamsal şekillendirme için, karakter eşlemesi Arapça Presentation Forms-B bloğunu kapsayan bir yazı tipi gerekir. Standart 14 yüz dahil olmak üzere, yalnızca Latin destekleyen bir yazı tipi Arapça çizemez.

Tabloda her hücre kendi içinde yeniden sıralanır ve şekillendirilir; hücreler başlangıç kenarına, yani direction: rtl altında sağ kenara hizalanır. Mantıksal text-align değerleri start ve end, yöne göre çözümlenir; dolayısıyla start, RTL içerik için sağ kenara karşılık gelir.

Yönü CSS direction özelliğiyle ayarlayın. HTML dir özniteliği bu özelliğe eşlenmez. Mevcut uygulama sınırları için RTL — mevcut sınırlamalar bölümüne bakın.

API yüzeyi

Sembol	Konum	Rol
Document::writeHtml(string $html): static	NextPDF\Core\Concerns\HasTextOutput	HTML parçasını geçerli imleç konumunda işler.
FontRegistry::register(string $fontFile, string $alias = '', int $fontIndex = 0): FontInfo	NextPDF\Typography\FontRegistry	Arapça yazı tipi yüzünü bir takma ad altında kaydeder.
DocumentFactory::create(): Document	NextPDF\Core\DocumentFactory	Doldurulmuş kayıt defterinizi kullanan bir belge oluşturur.

Örnek şu CSS özelliklerini kullanır: direction, font-family, text-align. Kayıtlı yazı tipine, CSS font-family içinde kayıt defteri takma adını kullanarak başvurun.

Kod örneği — hızlı başlangıç

<?php

declare(strict_types=1);

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

use NextPDF\Core\DocumentFactory;
use NextPDF\Graphics\ImageRegistry;
use NextPDF\Typography\FontRegistry;

$fontRegistry = new FontRegistry();
$fontRegistry->register(__DIR__ . '/NotoNaskhArabic-Regular.ttf', alias: 'ArabicFont');

$documentFactory = new DocumentFactory($fontRegistry, new ImageRegistry(maxCacheBytes: 0));
$doc = $documentFactory->create();
$doc->addPage();

$doc->writeHtml(
    '<div style="direction: rtl; font-family: \'ArabicFont\';">'
    . '<h1>فاتورة</h1>'
    . '<p>المبلغ الإجمالي 380.00</p>'
    . '</div>'
);

$doc->save(__DIR__ . '/rtl-arabic.pdf');

Başlık sağdan sola işlenir; 380.00 rakamları ise Arapça cümle içinde soldan sağa kalır.

Kod örneği — üretim

Bu bağımsız örnek, bir Arapça fatura tablosunu işler. Her hücre direction: rtl değerini ve kayıtlı Arapça yazı tipini taşır; böylece motor her satırı yeniden sıralar ve şekillendirir, ardından hücreleri sağ kenara hizalar.

<?php

declare(strict_types=1);

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

use NextPDF\Core\DocumentFactory;
use NextPDF\Graphics\ImageRegistry;
use NextPDF\Typography\FontRegistry;

// Supply an Arabic-capable face whose cmap covers Arabic Presentation Forms-B.
// Embed only fonts you are licensed to embed.
$fontPath = __DIR__ . '/NotoNaskhArabic-Regular.ttf';
if (!is_file($fontPath)) {
    fwrite(STDERR, "Arabic font not found at {$fontPath}\n");
    exit(1);
}

$fontRegistry = new FontRegistry();
$fontRegistry->register($fontPath, alias: 'ArabicFont');

$documentFactory = new DocumentFactory($fontRegistry, new ImageRegistry(maxCacheBytes: 0));
$doc = $documentFactory->create();
$doc->setTitle('Arabic invoice');
$doc->addPage();

$html = <<<'HTML'
<div style="direction: rtl; font-family: 'ArabicFont'; font-size: 12pt;">
  <h1>فاتورة</h1>
  <table style="width: 100%; border-collapse: collapse;">
    <tr>
      <th style="border: 1px solid #333; padding: 6px;">الوصف</th>
      <th style="border: 1px solid #333; padding: 6px;">المبلغ</th>
    </tr>
    <tr>
      <td style="border: 1px solid #333; padding: 6px;">خدمات استشارية</td>
      <td style="border: 1px solid #333; padding: 6px;">380.00</td>
    </tr>
    <tr>
      <td style="border: 1px solid #333; padding: 6px;">الإجمالي</td>
      <td style="border: 1px solid #333; padding: 6px;">380.00</td>
    </tr>
  </table>
</div>
HTML;

$doc->writeHtml($html);

$out = getenv('NEXTPDF_OUT');
$doc->save($out !== false ? $out : __DIR__ . '/render-rtl-arabic-html.pdf');

echo "Wrote the Arabic invoice PDF\n";

  الوصف المبلغ   خدمات استشارية 380.00   الإجمالي 380.00  

HTML;$doc->writeHtml($html);$out = getenv('NEXTPDF_OUT');$doc->save($out !== false ? $out : __DIR__ . '/render-rtl-arabic-html.pdf');echo "Wrote the Arabic invoice PDF\n";">