오른쪽에서 왼쪽으로 쓰는 아랍어 HTML 렌더링

한눈에 보기

오른쪽에서 왼쪽으로 쓰는(RTL) HTML을 writeHtml()로 PDF에 렌더링합니다. CSS direction: rtl 속성을 설정하고 아랍어 지원 글꼴을 등록합니다. 엔진은 유니코드 양방향 알고리즘(UAX #9)에 따라 텍스트를 시각적 순서로 재정렬하고, 아랍어 글자를 문맥에 맞는 형식으로 처리합니다. 이 레시피에서는 작은 아랍어 송장을 렌더링합니다. RTL은 아랍어, 히브리어, 페르시아어, 우르두어에 적용됩니다. 히브리어는 재정렬되지만 글자 모양 처리는 수행되지 않으며, 이는 해당 문자 체계에서 올바른 동작입니다.

설치

composer require nextpdf/core

아랍어를 지원하는 TrueType 또는 OpenType 글꼴도 필요합니다. 글꼴의 문자 맵에는 아랍어 표현 형식-B(Arabic Presentation Forms-B) 블록이 포함되어야 합니다. Noto Naskh Arabic과 Amiri는 적합한 오픈 라이선스 페이스입니다.

개념 개요

RTL 렌더링에는 CSS direction: rtl 속성과 등록된 아랍어 글꼴이라는 두 가지 입력이 필요합니다.

direction: rtl은 레이아웃에 텍스트를 오른쪽에서 왼쪽으로 배치하라고 지시합니다. 그러면 엔진은 유니코드 양방향 알고리즘(UAX #9)을 사용해 시각적 순서를 해석합니다. 혼합 콘텐츠도 올바르게 정렬됩니다. 라틴 단어, 아랍어 단어, 숫자는 각각 고유한 방향을 유지합니다. 아랍어 텍스트 뒤에 오는 숫자는 자릿수를 왼쪽에서 오른쪽 순서로 유지합니다.

아랍어는 필기체 문자 체계이므로 각 글자는 이웃 글자에 따라 다른 글리프를 사용합니다. 엔진은 각 글자에 대해 초성, 중성, 종성 또는 단독 형식을 선택하고 Lam-Alef 합자를 적용합니다. 이러한 문맥 기반 글자 모양 처리에는 문자 맵이 아랍어 표현 형식-B(Arabic 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";">