Arabisches RTL-HTML rendern

Auf einen Blick

Mit writeHtml() rendern Sie HTML mit Rechts-nach-links-Laufrichtung (RTL) als PDF. Setzen Sie die CSS-Eigenschaft direction: rtl und registrieren Sie eine arabischfähige Schriftart. Die Engine ordnet den Text mit dem Unicode-Bidirektionalalgorithmus (UAX #9) in die visuelle Reihenfolge um und formt arabische Buchstaben kontextabhängig. Dieses Rezept rendert eine kleine arabische Rechnung. RTL gilt für Arabisch, Hebräisch, Persisch und Urdu. Hebräisch wird umgeordnet, aber nicht geformt; für diese Schrift ist das korrekt.

Installation

composer require nextpdf/core

Außerdem benötigen Sie eine arabischfähige TrueType- oder OpenType-Schriftart. Ihre Zeichentabelle muss den Block Arabic Presentation Forms-B abdecken. Noto Naskh Arabic und Amiri sind geeignete, offen lizenzierte Schriftschnitte.

Konzeptioneller Überblick

Für RTL-Rendering benötigen Sie zwei Eingaben: die CSS-Eigenschaft direction: rtl und eine registrierte arabische Schriftart.

direction: rtl weist das Layout an, Text von rechts nach links zu platzieren. Die Engine verwendet anschließend den Unicode-Bidirektionalalgorithmus (UAX #9), um die visuelle Reihenfolge aufzulösen. Gemischte Inhalte werden korrekt geordnet: lateinische Wörter, arabische Wörter und Ziffern behalten jeweils ihre eigene Laufrichtung. Eine Zahl, die auf arabischen Text folgt, behält ihre Ziffernreihenfolge von links nach rechts.

Arabisch ist eine verbundene Schrift: Jeder Buchstabe verwendet je nach Nachbarzeichen eine andere Glyphe. Die Engine wählt für jeden Buchstaben die Anfangs-, Mittel-, End- oder isolierte Form und wendet die Lam-Alef-Ligatur an. Diese kontextabhängige Formung erfordert eine Schriftart, deren Zeichentabelle den Block Arabic Presentation Forms-B abdeckt. Eine rein lateinische Schriftart einschließlich der Standard-14-Schriftschnitte kann Arabisch nicht darstellen.

In Tabellen wird jede Zelle separat umgeordnet und geformt; die Zellen werden an der Anfangskante ausgerichtet, unter direction: rtl also an der rechten Kante. Die logischen text-align-Werte start und end werden anhand der Laufrichtung aufgelöst, sodass start bei RTL-Inhalt auf die rechte Kante abgebildet wird.

Setzen Sie die Laufrichtung mit der CSS-Eigenschaft direction. Das HTML-Attribut dir wird nicht darauf abgebildet. Die aktuellen Implementierungsgrenzen finden Sie unter RTL — aktuelle Einschränkungen.

API-Oberfläche

Symbol	Speicherort	Rolle
Document::writeHtml(string $html): static	NextPDF\Core\Concerns\HasTextOutput	Rendert das HTML-Fragment an der aktuellen Cursorposition.
FontRegistry::register(string $fontFile, string $alias = '', int $fontIndex = 0): FontInfo	NextPDF\Typography\FontRegistry	Registriert den arabischen Schriftschnitt unter einem Alias.
DocumentFactory::create(): Document	NextPDF\Core\DocumentFactory	Erstellt ein Dokument, das Ihr gefülltes Register liest.

Das Beispiel verwendet diese CSS-Eigenschaften: direction, font-family, text-align. Verweisen Sie in CSS über font-family mit dem Registeralias auf die registrierte Schriftart.

Codebeispiel — Schnellstart

<?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');

Die Überschrift wird von rechts nach links gerendert, und die Ziffern 380.00 behalten im arabischen Satz ihre Reihenfolge von links nach rechts.

Codebeispiel — Produktion

Dieses eigenständige Beispiel rendert eine arabische Rechnungstabelle. Jede Zelle setzt direction: rtl und die registrierte arabische Schriftart, sodass die Engine jede Zeile umordnet und formt und die Zellen anschließend an der rechten Kante ausrichtet.

<?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";">