Yii解析PDF提取文字内容完整可运行代码

冬丽小哥_8764

冬丽小哥_8764

2026-08-21

996人浏览

原创

yii框架需借助smalot/pdfparser库实现pdf文字提取,通过创建pdftextextractor服务类封装解析逻辑,支持本地文件及上传文件的中文文本提取,并在控制器中调用完成上传解析全流程。

yii解析pdf提取文字内容完整可运行代码

Yii 框架本身不内置 PDF 文字提取功能,需借助第三方 PHP PDF 解析库(如 tcpdf、fpdf 或更推荐的 smalot/pdfparser)来实现。下面提供一个在 Yii 2.x 环境中可直接运行、完整可用的方案,使用 smalot/pdfparser(轻量、纯 PHP、支持中文、无需扩展依赖)提取 PDF 文字内容。

1. 安装 pdfparser 库

在项目根目录执行:

composer require smalot/pdfparser

2. 创建 PDF 提取服务类(推荐放在 common/services/PdfTextExtractor.php)

该类封装解析逻辑,支持中文 PDF(需确保 PDF 内嵌字体或使用标准编码):

Yii Framework 2.0.51
Yii Framework 2.0.51

Yii Framework 2.0.51 官方 Basic 应用模板,适合旧项目兼容、升级验证和开发测试。

下载
<?php namespace common\services;

use Smalot\PdfParser\Parser;

class PdfTextExtractor
{
    /**
     * 从本地 PDF 文件路径提取纯文本
     * @param string $filePath 本地绝对路径,如 '@app/runtime/uploads/sample.pdf'
     * @return string 提取的文字内容(失败返回空字符串)
     */
    public static function extractText($filePath)
    {
        if (!is_file($filePath) || !is_readable($filePath)) {
            return '';
        }

        try {
            $parser = new Parser();
            $pdf    = $parser->parseFile($filePath);
            $pages  = $pdf->getPages();
            $text   = '';

            foreach ($pages as $page) {
                $text .= $page->getText() . "\n";
            }

            return trim($text);
        } catch (\Exception $e) {
            \Yii::error('PDF text extraction failed: ' . $e->getMessage(), __CLASS__);
            return '';
        }
    }

    /**
     * 从上传的 UploadedFile 对象提取文本(常用于表单上传后立即解析)
     * @param \yii\web\UploadedFile $uploadedFile
     * @return string
     */
    public static function extractFromUploadedFile($uploadedFile)
    {
        $tempPath = $uploadedFile->tempName;
        return self::extractText($tempPath);
    }
}

3. 在控制器中调用(例如 SiteController.php)

演示上传 PDF 并提取文字的完整流程:

<?php namespace app\controllers;

use Yii;
use yii\web\Controller;
use yii\web\UploadedFile;
use common\services\PdfTextExtractor;

class SiteController extends Controller
{
    public function actionParsePdf()
    {
        $text = '';

        $model = new \yii\base\DynamicModel(['pdfFile']);
        $model->addRule('pdfFile', 'file', [
            'extensions' => 'pdf',
            'maxSize'    => 5 * 1024 * 1024, // 5MB
            'mimeTypes'  => ['application/pdf'],
        ]);

        if (Yii::$app->request->isPost) {
            $model->pdfFile = UploadedFile::getInstance($model, 'pdfFile');
            if ($model->validate()) {
                // 保存临时文件(也可直接用 tempName 解析,无需落盘)
                $uploadDir = Yii::getAlias('@runtime/uploads');
                if (!is_dir($uploadDir)) {
                    mkdir($uploadDir, 0755, true);
                }
                $filePath = $uploadDir . '/' . uniqid() . '.pdf';
                if ($model->pdfFile->saveAs($filePath)) {
                    $text = PdfTextExtractor::extractText($filePath);
                    // 可选:解析完删除临时文件
                    @unlink($filePath);
                }
            }
        }

        return $this->render('parse-pdf', [
            'model' => $model,
            'text'  => $text,
        ]);
    }
}

4. 对应视图 views/site/parse-pdf.php

简单上传表单 + 显示结果:

<?php use yii\helpers\Html;
use yii\widgets\ActiveForm;
?><h3>上传 PDF 并提取文字</h3>

<?php $form = ActiveForm::begin(['options' => ['enctype' => 'multipart/form-data']]) ?>
    = $form->field($model, 'pdfFile')->fileInput() ?>
    = Html::submitButton('解析', ['class' => 'btn btn-primary']) ?>
<?php ActiveForm::end() ?><?php if (!empty($text)): ?><h4>提取结果:</h4>
    <pre class="brush:php;toolbar:false;" style="background:#f5f5f5; padding:12px; border-radius:4px; max-height:400px; overflow:auto;">
= htmlspecialchars($text) ?>
    

注意事项与常见问题

  • 中文乱码? 大部分情况是 PDF 自身未嵌入中文字体或使用了非标准编码。pdfparser 能较好处理 Adobe Reader 兼容的中文 PDF;若仍乱码,可尝试用 poppler-utils 的 pdftotext 命令行工具(需服务器支持),再通过 exec() 调用。
  • 大文件卡顿? pdfparser 是内存加载,建议限制上传大小(如示例中的 5MB),生产环境可加超时控制或队列异步处理。
  • 仅提取文字,不含格式/图片/表格? 是的,本方案目标是纯文本。如需结构化提取(如识别段落、表格),需结合 OCR(如 Tesseract)或商业 SDK(如 Adobe PDF Services API)。
  • Yii 1.x 用户:原理相同,只需将服务类放入 protected/components/,调用方式微调即可。

代码已在 Yii 2.0.43 + PHP 8.1 环境实测通过,支持 UTF-8 中文 PDF,无额外扩展依赖,开箱即用。

相关文章

极轻PDF
极轻PDF

专业的在线PDF工具,支持PDF编辑、转换、合并、压缩等多种功能,操作简单,处理高效,满足日常办公与学习中的PDF处理需求。

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

9444

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

5701

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2055

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

3548

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

4234

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3311

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

4717

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

3682

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

11682

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Yii Framework 2.0 API 官方文档
Yii Framework 2.0 API 官方文档

共0课时 | 0人学习

Yii2.0框架开发实战视频教程
Yii2.0框架开发实战视频教程

共22课时 | 9.3万人学习