Pdfファサード
Pdf ファサードは、TcpdfServiceProvider によって登録された PdfDocumentInterface バインディングへの便利な静的プロキシを提供します。config/tcpdf-next.php からのすべての設定値が自動的に適用されます。
php
use Yeeefang\TcpdfNext\Laravel\Facades\Pdf;ドキュメントの作成
Pdf::create() は、すべての設定デフォルトが事前に適用された新しい Document インスタンスをコンテナから解決します:
php
$pdf = Pdf::create();
$pdf->addPage()
->setFont('Helvetica', '', 12)
->cell(0, 10, 'Hello from Laravel!')
->save(storage_path('app/hello.pdf'));create() を呼び出すたびに新しいインスタンスが返されます。ドキュメントは呼び出し間で共有されることはありません。
フルーエントAPI
すべての Document メソッドはファサードを通じて利用可能で、チェーン用に static を返します:
php
$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 からデフォルトを読み取ります。ドキュメントごとに任意の設定をオーバーライドできます:
php
// 設定デフォルトを使用(A4縦、Helvetica 11pt)
$default = Pdf::create();
// このドキュメントのみページフォーマットをオーバーライド
$receipt = Pdf::create()
->setPageFormat('A5')
->setMargins(left: 10, top: 10, right: 10);完全なリファレンスは設定を参照してください。
ファサードクラスリファレンス
php
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バイトを生成せずにアサーションを行うために、本物のバインディングをフェイクに置き換えます:
php
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);
}フェイクはすべてのメソッド呼び出しを記録するため、フルーエントチェーンを検査できます:
php
Pdf::fake();
$this->get('/invoices/42/pdf');
Pdf::assertCreated(function ($pdf) {
return $pdf->getTitle() === 'Invoice #42'
&& $pdf->getPageCount() >= 1;
});