右から左に書くアラビア語 HTML をレンダリングする

概要

writeHtml() を使って、右から左に書く（RTL）HTML を PDF にレンダリングします。CSS の direction: rtl プロパティを設定し、アラビア語対応フォントを登録します。エンジンは Unicode 双方向アルゴリズム（UAX #9）に基づいてテキストを視覚的順序に並べ替え、アラビア語の文字を文脈依存の字形にシェーピングします。このレシピでは、小さなアラビア語の請求書をレンダリングします。RTL はアラビア語、ヘブライ語、ペルシア語、ウルドゥー語に適用されます。ヘブライ語は並べ替えの対象ですが、シェーピングは行われません。これは、この文字体系では正しい動作です。

インストール

composer require nextpdf/core

加えて、アラビア語対応の TrueType または OpenType フォントが必要です。その文字マップは、アラビア語 Presentation Forms-B ブロックをカバーしていなければなりません。Noto Naskh Arabic と Amiri は、適切なオープンライセンスの書体です。

概念の概要

RTL レンダリングには 2 つの入力が必要です。CSS の direction: rtl プロパティと、登録済みのアラビア語フォントです。

direction: rtl は、テキストを右から左へ配置するようレイアウトに指示します。続いて、エンジンは Unicode 双方向アルゴリズム（UAX #9）を使って視覚的順序を解決します。混在したコンテンツも正しく順序付けられます。ラテン文字の語、アラビア語の語、数字は、それぞれ固有の方向を保ちます。アラビア語のテキストに続く数字は、左から右のまま維持されます。

アラビア語は筆記体（カーシブ）の文字体系であり、各文字は隣接する文字に応じて異なる字形（グリフ）を使用します。エンジンは各文字について語頭形、語中形、語末形、または独立形を選択し、Lam-Alef リガチャを適用します。この文脈依存シェーピングには、文字マップがアラビア語 Presentation Forms-B ブロックをカバーするフォントが必要です。標準 14 書体を含むラテン文字専用フォントでは、アラビア語を描画できません。

表内では、各セルが個別に並べ替えられ、シェーピングされます。セルは開始エッジ、つまり direction: rtl では右端に揃えられます。論理的な text-align の値である start と end は方向に応じて解決されるため、RTL コンテンツでは start が右端にマッピングされます。

方向は CSS の direction プロパティで設定します。HTML の dir 属性はこのプロパティにマッピングされません。現在の実装上の境界については、RTL — 現在の制限を参照してください。

API サーフェス

シンボル	場所	役割
Document::writeHtml(string $html): static	NextPDF\Core\Concerns\HasTextOutput	現在のカーソル位置への HTML フラグメントのレンダリング
FontRegistry::register(string $fontFile, string $alias = '', int $fontIndex = 0): FontInfo	NextPDF\Typography\FontRegistry	エイリアスに紐づくアラビア語書体の登録
DocumentFactory::create(): Document	NextPDF\Core\DocumentFactory	設定済みレジストリを読み取るドキュメントの作成

このサンプルでは、次の CSS プロパティを使用します。direction、font-family、text-align。登録済みフォントは、CSS の font-family からレジストリエイリアスで参照します。

コードサンプル — クイックスタート

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

見出しは右から左にレンダリングされ、数字 380.00 はアラビア語の文中でも左から右のまま保持されます。

コードサンプル — プロダクション

この自己完結したサンプルでは、アラビア語の請求書の表をレンダリングします。各セルに direction: rtl と登録済みのアラビア語フォントが指定されているため、エンジンはすべての行を並べ替えてシェーピングし、その後セルを右端に揃えます。

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