Arabische HTML van rechts naar links renderen

In één oogopslag

Render HTML van rechts naar links (RTL) naar PDF met writeHtml(). Stel de CSS-eigenschap direction: rtl in en registreer een lettertype met Arabische ondersteuning. De engine herordent de tekst in visuele volgorde met het Unicode Bidirectional Algorithm (UAX #9) en zet Arabische letters om naar contextuele vormen. Dit recept rendert een kleine Arabische factuur. RTL geldt voor Arabisch, Hebreeuws, Perzisch en Urdu. Hebreeuws wordt herordend maar niet gevormd; dat is correct voor dat schrift.

Installeren

composer require nextpdf/core

Daarnaast heb je een TrueType- of OpenType-lettertype nodig dat Arabisch ondersteunt. De tekentabel daarvan moet het blok Arabic Presentation Forms-B dekken. Noto Naskh Arabic en Amiri zijn geschikte lettertypen met een open licentie.

Conceptueel overzicht

Voor RTL-weergave heb je twee invoeren nodig: de CSS-eigenschap direction: rtl en een geregistreerd Arabisch lettertype.

direction: rtl vertelt de lay-out dat tekst van rechts naar links moet worden geplaatst. De engine gebruikt vervolgens het Unicode Bidirectional Algorithm (UAX #9) om de visuele volgorde te bepalen. Gemengde inhoud wordt correct geordend: Latijnse woorden, Arabische woorden en cijfers behouden elk hun eigen richting. Een getal dat op Arabische tekst volgt, houdt de cijfers in links-naar-rechtsvolgorde.

Arabisch is een verbonden schrift, dus elke letter gebruikt een andere glyph op basis van aangrenzende letters. De engine selecteert voor elke letter de initiële, mediale, finale of geïsoleerde vorm en past de Lam-Alef-ligatuur toe. Deze contextuele vormgeving vereist een lettertype waarvan de tekentabel het blok Arabic Presentation Forms-B dekt. Een lettertype dat alleen Latijn ondersteunt, inclusief de standard-14-lettertypen, kan geen Arabisch renderen.

In een tabel wordt elke cel afzonderlijk herordend en gevormd, waarna cellen uitlijnen op de beginrand: de rechterrand onder direction: rtl. De logische text-align-waarden start en end worden op basis van de richting geïnterpreteerd, dus start komt overeen met de rechterrand voor RTL-inhoud.

Stel de richting in met de CSS-eigenschap direction. Het HTML-attribuut dir wordt er niet aan gekoppeld. Zie RTL — huidige beperkingen voor de grenzen van de huidige implementatie.

API-oppervlak

Symbool	Locatie	Rol
Document::writeHtml(string $html): static	NextPDF\Core\Concerns\HasTextOutput	Render het HTML-fragment op de huidige cursorpositie.
FontRegistry::register(string $fontFile, string $alias = '', int $fontIndex = 0): FontInfo	NextPDF\Typography\FontRegistry	Registreer het Arabische lettertype onder een alias.
DocumentFactory::create(): Document	NextPDF\Core\DocumentFactory	Maak een document dat je gevulde register gebruikt.

Het voorbeeld gebruikt deze CSS-eigenschappen: direction, font-family, text-align. Verwijs in CSS font-family naar het geregistreerde lettertype via de registeralias.

Codevoorbeeld — Snelstart

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

De kop wordt van rechts naar links gerenderd, terwijl de cijfers 380.00 binnen de Arabische zin van links naar rechts blijven staan.

Codevoorbeeld — Productie

Dit op zichzelf staande voorbeeld rendert een Arabische factuurtabel. Elke cel bevat direction: rtl en het geregistreerde Arabische lettertype, zodat de engine elke regel herordent en vormt en daarna de cellen uitlijnt op de rechterrand.

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