Afficher du HTML arabe de droite à gauche

En bref

Rends du HTML de droite à gauche (RTL) au format PDF avec writeHtml(). Définis la propriété CSS direction: rtl et enregistre une police compatible avec l’arabe. Le moteur réordonne le texte dans l’ordre visuel avec l’algorithme bidirectionnel Unicode (UAX #9) et met en forme les lettres arabes selon leurs formes contextuelles. Cette recette génère une petite facture en arabe. Le mode RTL s’applique à l’arabe, à l’hébreu, au persan et à l’ourdou. L’hébreu est réordonné, mais pas mis en forme, ce qui est correct pour cette écriture.

Installation

composer require nextpdf/core

Il te faut aussi une police TrueType ou OpenType compatible avec l’arabe. Sa table de caractères doit couvrir le bloc Arabic Presentation Forms-B. Noto Naskh Arabic et Amiri sont des polices sous licence ouverte qui conviennent.

Vue d’ensemble conceptuelle

Le rendu RTL nécessite deux éléments en entrée : la propriété CSS direction: rtl et une police arabe enregistrée.

direction: rtl indique à la mise en page de placer le texte de droite à gauche. Le moteur utilise ensuite l’algorithme bidirectionnel Unicode (UAX #9) pour résoudre l’ordre visuel. Le contenu mixte est ordonné correctement : les mots latins, les mots arabes et les chiffres conservent chacun leur propre direction. Un nombre qui suit du texte arabe conserve ses chiffres de gauche à droite.

Comme l’arabe est une écriture cursive, chaque lettre utilise un glyphe différent selon ses voisines. Le moteur sélectionne la forme initiale, médiane, finale ou isolée pour chaque lettre et applique la ligature Lam-Alef. Cette mise en forme contextuelle nécessite une police dont la table de caractères couvre le bloc Arabic Presentation Forms-B. Une police uniquement latine, y compris les fontes standard-14, ne peut pas dessiner l’arabe.

Dans un tableau, chaque cellule est réordonnée et mise en forme individuellement, et les cellules s’alignent sur le bord de début : le bord droit sous direction: rtl. Les valeurs logiques start et end de text-align sont résolues selon la direction ; start correspond donc au bord droit pour un contenu RTL.

Définis la direction avec la propriété CSS direction. L’attribut HTML dir n’est pas relié à cette propriété. Consulte RTL — limites actuelles pour connaître les limites actuelles de l’implémentation.

Surface de l’API

Symbole	Emplacement	Rôle
Document::writeHtml(string $html): static	NextPDF\Core\Concerns\HasTextOutput	Rend le fragment HTML à la position actuelle du curseur.
FontRegistry::register(string $fontFile, string $alias = '', int $fontIndex = 0): FontInfo	NextPDF\Typography\FontRegistry	Enregistre la police arabe sous un alias.
DocumentFactory::create(): Document	NextPDF\Core\DocumentFactory	Crée un document qui utilise le registre renseigné.

L’exemple utilise ces propriétés CSS : direction, font-family, text-align. Fais référence à la police enregistrée dans la propriété CSS font-family via son alias de registre.

Exemple de code — Démarrage rapide

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

Le titre s’affiche de droite à gauche, et les chiffres 380.00 restent de gauche à droite dans la phrase en arabe.

Exemple de code — Production

Cet exemple autonome génère un tableau de facture en arabe. Chaque cellule déclare direction: rtl et la police arabe enregistrée, afin que le moteur réordonne et mette en forme chaque ligne, puis aligne les cellules sur le bord droit.

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