yii框架不内置pdf读取功能，需用smalot/pdfparser等第三方库；异常多因路径错误、文件损坏、权限不足等；示例含composer安装、封装pdfreader类及异常处理。
Yii 框架本身不内置 PDF 内容读取功能，需借助第三方库（如 smalot/pdfparser 或 setasign/fpdi + setasign/tcpdf）解析 PDF。抛出异常通常是因为文件路径错误、PDF 损坏、权限不足、编码问题或库未正确安装。下面给出基于 smalot/pdfparser 的健壮读取示例，并包含关键异常捕获与处理逻辑。
1. 安装依赖并配置自动加载
在项目根目录执行：
composer require smalot/pdfparser确保 Composer 自动加载已生效（Yii2 中一般无需额外配置）。
2. 封装安全的 PDF 文本提取方法
建议将解析逻辑封装为独立服务或工具类，避免直接在控制器中写重复代码。示例（可放在 common/components/PdfReader.php）：
namespace common\components;
use Smalot\PdfParser\Parser;
use yii\base\Exception;
class PdfReader
{
public static function extractText($filePath): string
{
if (!is_file($filePath)) {
throw new Exception("PDF 文件不存在：{$filePath}");
}
if (!is_readable($filePath)) {
throw new Exception("PDF 文件不可读：{$filePath}");
}
try {
$parser = new Parser();
$pdf = $parser->parseFile($filePath);
$text = $pdf->getText();
// 过滤空白和控制字符，提高可用性
return trim(preg_replace('/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/', '', $text));
} catch (\Smalot\PdfParser\Exception $e) {
throw new Exception("PDF 解析失败（格式/加密/损坏）：{$e->getMessage()}", $e->getCode());
} catch (\Exception $e) {
throw new Exception("PDF 读取发生未知错误：{$e->getMessage()}", $e->getCode());
}
}
}
3. 在控制器中调用并捕获异常
在控制器动作中使用 try-catch，区分业务逻辑错误与系统级异常：
use common\components\PdfReader;
use yii\web\BadRequestHttpException;
use yii\web\ServerErrorHttpException;
public function actionReadPdf()
{
$filePath = Yii::getAlias('@upload/pdf/sample.pdf');
try {
$content = PdfReader::extractText($filePath);
return $this->asJson(['success' => true, 'text' => $content]);
} catch (BadRequestHttpException $e) {
// 文件路径/权限类错误 → 前端可提示“文件不存在或无权限”
return $this->asJson(['success' => false, 'error' => '请求参数错误', 'message' => $e->getMessage()]);
} catch (ServerErrorHttpException $e) {
// 解析失败等服务端问题 → 记录日志，返回通用提示
Yii::error($e, 'PdfReader');
return $this->asJson(['success' => false, 'error' => 'PDF 解析失败，请检查文件是否有效']);
} catch (\Exception $e) {
// 兜底异常（如内存不足、扩展缺失）
Yii::error($e, 'PdfReader');
return $this->asJson(['success' => false, 'error' => '服务异常，请稍后重试']);
}
}
4. 补充建议
- PDF 加密文档需提前解密（
smalot/pdfparser支持简单密码，但复杂 AES 加密可能失败） - 大文件（>50MB）建议加内存限制检查：
if (filesize($filePath) > 20 * 1024 * 1024) { throw new Exception('文件过大'); } - 生产环境开启
display_errors = Off，避免敏感路径泄露 - 对 OCR 类 PDF（纯扫描图），该方案无法提取文字，需集成 Tesseract 等工具
