使用 PHP 计算 PDF 文件页数的正确方法

花韻仙語

发布时间：2025-10-08 09:45:14

327人浏览过

来源于php中文网

原创

使用 php 计算 pdf 文件页数的正确方法

本文介绍了一种使用 PHP 计算 PDF 文件页数的可靠方法，避免了传统方法中可能出现的错误。通过使用 FPDI 库，可以准确地获取 PDF 文件的页数，即使是包含横向页面或复杂结构的 PDF 文件也能正确处理。本文将提供详细的代码示例和使用说明，帮助开发者轻松实现 PDF 页数统计功能。

在处理 PDF 文件时，准确获取页数是一个常见的需求。传统方法，例如使用正则表达式匹配 /Page 模式，可能在某些情况下失效，例如 PDF 文件包含横向页面或结构复杂。为了解决这个问题，我们可以使用 FPDI 库，它提供了更可靠的 PDF 解析功能。

FPDI 简介

FPDI (Free PDF Document Importer) 是一个强大的 PHP 库，允许你导入现有的 PDF 文档并对其进行操作。它提供了 PDF 解析器和阅读器，可以用来提取 PDF 文件的各种信息，包括页数。

立即学习“PHP免费学习笔记（深入）”；

安装 FPDI

首先，你需要使用 Composer 安装 FPDI 库。在你的项目目录下，运行以下命令：

OmniAudio

OmniAudio 是一款通过 AI 支持将网页、Word 文档、Gmail 内容、文本片段、视频音频文件都转换为音频播客，并生成可在常见 Podcast ap

下载

composer require setasign/fpdi

使用 FPDI 计算 PDF 页数

以下代码展示了如何使用 FPDI 库来计算 PDF 文件的页数：

<?php

require_once 'vendor/autoload.php';

use setasign\Fpdi\PdfParser\StreamReader;
use setasign\Fpdi\PdfParser\PdfParser;
use setasign\Fpdi\PdfReader\PdfReader;

/**
 * 获取 PDF 文件的页数
 *
 * @param string $path PDF 文件的路径
 * @return int PDF 文件的页数
 */
function getPageCountOfPdf(string $path): int
{
    $stream = StreamReader::createByFile($path);
    $parser = new PdfParser($stream);

    $pdfReader = new PdfReader($parser);

    return $pdfReader->getPageCount();
}

// 示例用法
$pdfFilePath = 'example.pdf'; // 替换为你的 PDF 文件路径
$pageCount = getPageCountOfPdf($pdfFilePath);

echo "PDF 文件 {$pdfFilePath} 的页数为: " . $pageCount . PHP_EOL;

?>

代码解释：

require_once 'vendor/autoload.php';: 引入 Composer 自动加载器，以便加载 FPDI 库。
use setasign\Fpdi\PdfParser\StreamReader;, use setasign\Fpdi\PdfParser\PdfParser;, use setasign\Fpdi\PdfReader\PdfReader;: 引入 FPDI 库中所需的类。
getPageCountOfPdf(string $path): int: 定义一个函数，接收 PDF 文件的路径作为参数，并返回 PDF 文件的页数。
$stream = StreamReader::createByFile($path);: 创建一个 StreamReader 对象，用于从文件中读取 PDF 数据。
$parser = new PdfParser($stream);: 创建一个 PdfParser 对象，用于解析 PDF 数据流。
$pdfReader = new PdfReader($parser);: 创建一个 PdfReader 对象，用于读取 PDF 文档的结构。
return $pdfReader->getPageCount();: 调用 getPageCount() 方法获取 PDF 文件的页数，并将其返回。
$pdfFilePath = 'example.pdf';: 定义 PDF 文件的路径。请将 'example.pdf' 替换为你要处理的 PDF 文件的实际路径。
$pageCount = getPageCountOfPdf($pdfFilePath);: 调用 getPageCountOfPdf() 函数获取 PDF 文件的页数。
echo "PDF 文件 {$pdfFilePath} 的页数为: " . $pageCount . PHP_EOL;: 输出 PDF 文件的页数。