CodeIgniter パッケージ

CodeIgniter · LGPL-3.0

CodeIgniter パッケージは、TCPDF-Next の CodeIgniter 4 統合を提供します — サービス登録、コントローラ用の Library クラス、キューベースの非同期生成、OWASP セキュリティヘッダー付き HTTP レスポンスヘルパーを含みます。

インストール

bash

composer require yeeefang/tcpdf-next-codeigniter

要件: CodeIgniter ^4.0、PHP ^8.5

設定

設定ファイルを公開します：

bash

php spark tcpdf-next:publish

php

// app/Config/TcpdfNext.php
namespace Config;

use CodeIgniter\Config\BaseConfig;

class TcpdfNext extends BaseConfig
{
    public string $fontsDirectory = WRITEPATH . 'fonts';
    public string $defaultPageSize = 'A4';
    public string $defaultOrientation = 'portrait';
    public bool $autoPageBreak = true;
    public float $marginBottom = 25.0;
}

サービスの使用

コントローラでサービスを使用します：

php

namespace App\Controllers;

use Yeeefang\TcpdfNext\CodeIgniter\Services\TcpdfNextService;

class InvoiceController extends BaseController
{
    public function download(int $id)
    {
        $invoice = model('InvoiceModel')->find($id);

        $pdf = service('tcpdfnext')->create()
            ->setTitle("Invoice #{$invoice->number}")
            ->addPage()
            ->setFont('Helvetica', '', 12)
            ->cell(0, 10, "Invoice #{$invoice->number}");

        return service('tcpdfnext')->response($pdf, "invoice-{$invoice->number}.pdf");
    }
}

Library の使用

Library クラスを使用する方法もあります：

php

namespace App\Controllers;

use Yeeefang\TcpdfNext\CodeIgniter\Libraries\PdfLibrary;

class ReportController extends BaseController
{
    public function generate()
    {
        $pdfLib = new PdfLibrary();

        $pdf = $pdfLib->create()
            ->setTitle('Monthly Report')
            ->addPage()
            ->setFont('Helvetica', 'B', 16)
            ->cell(0, 10, 'Monthly Report', newLine: true);

        return $pdfLib->inline($pdf, 'report.pdf');
    }
}

HTTP レスポンス

レスポンスヘルパーには OWASP 推奨のセキュリティヘッダーが含まれています：

php

// インライン表示（ブラウザプレビュー）
return service('tcpdfnext')->inline($pdf, 'report.pdf');

// 強制ダウンロード
return service('tcpdfnext')->download($pdf, 'report.pdf');

キュー統合

PDF 生成を CodeIgniter のタスクスケジューラにディスパッチします：

php

use Yeeefang\TcpdfNext\CodeIgniter\Queue\GeneratePdfJob;

$job = new GeneratePdfJob([
    'template' => 'invoice',
    'data' => ['invoice_id' => $invoice->id],
    'output_path' => WRITEPATH . "pdfs/invoice-{$invoice->id}.pdf",
]);

service('queue')->push($job);

パッケージ内容

クラス	説明
`TcpdfNextService`	サービスの登録とファクトリ
`PdfLibrary`	コントローラで使用するための Library クラス
`PdfResponse`	セキュリティヘッダー付き HTTP レスポンス
`GeneratePdfJob`	バックグラウンド生成用のキュージョブ

CodeIgniter パッケージ ​

インストール ​

設定 ​

サービスの使用 ​

Library の使用 ​

HTTP レスポンス ​

キュー統合 ​

パッケージ内容 ​