Yii本身不支持PDF文本提取，需集成第三方库：推荐smalot/pdfparser（纯PHP、轻量）或poppler的pdftotext（高精度、需系统安装），并封装为服务类，在控制器中安全调用，注意文件校验、异常处理及中文编码。
Yii 是一个 PHP 框架，本身不内置 PDF 文本提取能力。它不能直接读取 PDF 并提取文字——这需要底层 PDF 解析库支持。所以“Yii 怎么读取 PDF”实际是问：在 Yii 应用中，如何集成可靠的 PDF 文本提取方案。核心思路是：用 PHP 的成熟 PDF 库处理文件，Yii 负责接收、调度和返回结果。
选对底层库：推荐 tcpdf、smalot/pdfparser 或 poppler + pdftotext
Yii 不提供 PDF 解析功能，必须借助外部库：
- tcpdf：侧重生成 PDF，文本提取能力弱，不推荐用于提取
-
smalot/pdfparser（PHP 原生）：轻量、纯 PHP、支持密码保护 PDF，适合纯文本内容较规范的文档（如报告、合同正文）。安装：
composer require smalot/pdfparser -
poppler 工具集中的 pdftotext（系统级）：命令行工具，精度高、速度快、兼容性好，尤其擅长处理原生 PDF（非扫描件）。需服务器安装 poppler（Ubuntu：
sudo apt install poppler-utils） - 避免使用过时或维护停滞的库（如 older fpdf 扩展、未更新的 pdfreader）
在 Yii 控制器中安全调用提取逻辑
不要在控制器里写大段解析代码。应封装为服务类，并注意输入校验与异常捕获：
- 检查上传文件是否为真实 PDF（验证 MIME 类型
application/pdf和文件头魔数%PDF） - 限制文件大小（如 ≤5MB），防止内存溢出
- 若用
pdftotext，用escapeshellarg()严格转义临时文件路径，杜绝命令注入 - 提取后做基础清洗：去除多余空行、合并被换行切断的单词（如 “ex-
ample” → “example”）
处理常见失败场景
PDF 文本提取不是 100% 可靠，需主动应对：
-
空白或乱码输出：大概率是扫描版 PDF（图片型），需 OCR；原生 PDF 则可能是字体嵌入异常或加密，可先用
pdfinfo检查是否含文本层 - 只提取到部分页面：某些库默认跳过加密页或含 JS 的页，确认是否启用全页解析选项
-
中文乱码：smalot/pdfparser 需确保 PHP 环境启用 mbstring 扩展，并在解析前设置
mb_internal_encoding('UTF-8') - 不建议在 Yii 中自行实现 OCR，应交由专业服务（如 Tesseract CLI 封装或云 API）
简单可用的 Yii2 示例（基于 smalot/pdfparser）
在 common/components/PdfTextExtractor.php 中定义服务：
namespace common\components;
use Smalot\PdfParser\Parser;
class PdfTextExtractor
{
public function extract(string $filePath): string
{
if (!file_exists($filePath) || !is_readable($filePath)) {
throw new \InvalidArgumentException('PDF file not accessible');
}
$parser = new Parser();
try {
$pdf = $parser->parseFile($filePath);
return trim($pdf->getText());
} catch (\Exception $e) {
throw new \RuntimeException('PDF parsing failed: ' . $e->getMessage(), 0, $e);
}
}
}
在控制器中调用：
public function actionExtractText(){
$model = new UploadForm();
if ($model->load(Yii::$app->request->post()) && $model->validate()) {
$tempPath = $model->file->tempName;
$text = Yii::$app->pdfExtractor->extract($tempPath);
return $this->asJson(['success' => true, 'text' => $text]);
}
return $this->render('upload', ['model' => $model]);
}
