Pdfファサード

Pdf ファサードは、TcpdfServiceProvider によって登録された PdfDocumentInterface バインディングへの便利な静的プロキシを提供します。config/tcpdf-next.php からのすべての設定値が自動的に適用されます。

use Yeeefang\TcpdfNext\Laravel\Facades\Pdf;

ドキュメントの作成

Pdf::create() は、すべての設定デフォルトが事前に適用された新しい Document インスタンスをコンテナから解決します：

$pdf = Pdf::create();

$pdf->addPage()
    ->setFont('Helvetica', '', 12)
    ->cell(0, 10, 'Hello from Laravel!')
    ->save(storage_path('app/hello.pdf'));

create() を呼び出すたびに新しいインスタンスが返されます。ドキュメントは呼び出し間で共有されることはありません。

フルーエントAPI

すべての Document メソッドはファサードを通じて利用可能で、チェーン用に static を返します：

$pdf = Pdf::create()
    ->setTitle('Quarterly Report')
    ->setAuthor('Finance Team')
    ->setMargins(left: 15, top: 20, right: 15)
    ->addPage()
    ->setFont('Helvetica', 'B', 18)
    ->cell(0, 12, 'Q1 2026 Report')
    ->ln()
    ->setFont('Helvetica', '', 11)
    ->multiCell(0, 6, $reportBody);

設定バインディング

ファサードは config/tcpdf-next.php からデフォルトを読み取ります。ドキュメントごとに任意の設定をオーバーライドできます：

// 設定デフォルトを使用（A4縦、Helvetica 11pt）
$default = Pdf::create();

// このドキュメントのみページフォーマットをオーバーライド
$receipt = Pdf::create()
    ->setPageFormat('A5')
    ->setMargins(left: 10, top: 10, right: 10);

完全なリファレンスは設定を参照してください。

ファサードクラスリファレンス

namespace Yeeefang\TcpdfNext\Laravel\Facades;

use Illuminate\Support\Facades\Facade;

/**
 * @method static \Yeeefang\TcpdfNext\Core\Document create()
 * @method static void fake()
 * @method static void assertCreated()
 * @method static void assertCreatedCount(int $count)
 *
 * @see \Yeeefang\TcpdfNext\Core\Document
 */
class Pdf extends Facade
{
    protected static function getFacadeAccessor(): string
    {
        return \Yeeefang\TcpdfNext\Contracts\PdfDocumentInterface::class;
    }
}

Pdf::fake() によるテスト

実際のPDFバイトを生成せずにアサーションを行うために、本物のバインディングをフェイクに置き換えます：

use Yeeefang\TcpdfNext\Laravel\Facades\Pdf;

public function test_invoice_generates_pdf(): void
{
    Pdf::fake();

    $response = $this->get('/invoices/42/pdf');
    $response->assertOk();

    Pdf::assertCreated();
    Pdf::assertCreatedCount(1);
}

フェイクはすべてのメソッド呼び出しを記録するため、フルーエントチェーンを検査できます：

Pdf::fake();

$this->get('/invoices/42/pdf');

Pdf::assertCreated(function ($pdf) {
    return $pdf->getTitle() === 'Invoice #42'
        && $pdf->getPageCount() >= 1;
});

次のステップ

• HTTPレスポンス — PDFをブラウザにセキュアに配信
• キュージョブ — バックグラウンドワーカーに生成を委譲
• 設定 — 利用可能なすべての設定キー