Hello World

本示例带您从零开始创建一份 PDF 文件。完成后，您会了解 TCPDF-Next 的基本运作流程：创建文件、新增页面、写入文字、输出文件。

前置条件

请先通过 Composer 安装 TCPDF-Next：

composer require yeee-fang/tcpdf-next

完整示例

<?php

require_once __DIR__ . '/vendor/autoload.php';

use YeeeFang\TcpdfNext\Document\PdfDocument;
use YeeeFang\TcpdfNext\Document\PageFormat;

// 创建 PDF 文件
$pdf = PdfDocument::create()
    ->setTitle('我的第一份 PDF')
    ->setAuthor('TCPDF-Next 用户')
    ->setSubject('Hello World 示例')
    ->setPageFormat(PageFormat::A4)
    ->build();

// 新增一页
$page = $pdf->addPage();

// 写入文字
$page->addText('Hello World! 欢迎使用 TCPDF-Next')
    ->setPosition(20, 30)
    ->setFont('Helvetica', size: 16);

// 输出 PDF 到浏览器
$pdf->output('hello_world.pdf');

代码说明

创建文件

PdfDocument::create() 返回一个构建器，用来设置文件属性。调用 build() 后才会真正生成文件对象。标题、作者等元数据会嵌入 PDF 文件中，可在阅读器的文件属性中查看。

新增页面与内容

$page = $pdf->addPage();

$page->addText('Hello World!')
    ->setPosition(20, 30)
    ->setFont('Helvetica', size: 16);

addPage() 创建一个空白页面并返回页面对象。通过 addText() 指定文字内容，再用 setPosition() 与 setFont() 控制位置和字体。

输出模式

// 在浏览器中显示
$pdf->output('hello_world.pdf');

// 强制下载
$pdf->download('hello_world.pdf');

// 保存到服务器文件系统
$pdf->save('/path/to/hello_world.pdf');

// 获取 PDF 内容字符串
$content = $pdf->toString();

自定义页面尺寸

// 预定义格式
$pdf = PdfDocument::create()
    ->setPageFormat(PageFormat::A4)
    ->build();

// 横向
$pdf = PdfDocument::create()
    ->setPageFormat(PageFormat::A4_LANDSCAPE)
    ->build();

// 其他常见格式
PageFormat::LETTER;
PageFormat::LEGAL;
PageFormat::A3;

中文字体

如需显示中文字符，请使用支持中文的字体。TCPDF-Next 内置 CID 字体支持：

$page->addText('简体中文内容')
    ->setFont('cid0cs', size: 12);

或加载自定义 TrueType 字体，详见 自定义字体 章节。

下一步

• 文字格式化 -- 字体样式、颜色与段落排版
• 表格 -- 创建数据表格
• 图片 -- 在 PDF 中嵌入图片