pdf读取为空需先判断是未读到字节还是解析失败；检查绝对路径、文件权限及selinux限制；确认解析库是否支持文本提取，图像型pdf需ocr；避免sendfile()后读取或视图中直接读取。
PDF文件内容读取为空，通常不是Yii本身的问题，而是底层PDF解析库（如TCPDF、mPDF、FPDI或第三方服务）在加载、权限、路径或编码环节出了偏差。核心要确认：是“根本没读到字节”，还是“读到了但解析不出文本”。
检查文件路径与读取权限
Yii不直接解析PDF，而是调用PHP扩展或外部工具。若用file_get_contents($path)或fopen()读取失败，内容自然为空。
- 确保传入的是绝对路径，例如
Yii::getAlias('@webroot/uploads/invoice.pdf')，不能用@web（那是URL，不是文件系统路径） - 用
is_file($path) && is_readable($path)显式校验，避免静默失败 - Linux服务器注意SELinux或ACL限制，Web用户（如www-data）可能无权读取某些目录
确认PDF解析库是否支持文本提取
很多PDF生成库（如mPDF、TCPDF）专注“写入”，不提供“读取文本”能力。真正做OCR或文本抽取需额外工具：
- 纯文本提取推荐
setasign/fpdi+setasign/fpdf组合，但它只支持标准PDF（无加密、无流压缩） - 更健壮的选择是调用系统命令：
pdftotext（Poppler套件），需服务器预装：exec("pdftotext -enc UTF-8 {$path} -", $output); $text = implode("\n", $output); - 若PDF含扫描图像或加密，必须用OCR方案（如Tesseract），此时空值是正常现象——它本来就没有可提取的文本层
验证PDF本身是否有效且可读
部分PDF由前端JS动态生成或后端流式拼接，可能结构损坏、缺少xref表或被密码保护。
- 用
pdfinfo {$path}检查元信息是否可读；用pdfdetach -list {$path}看是否有嵌入对象干扰 - 尝试用
qpdf --stream-data=uncompress {$in} {$out}解压流，再重试解析 - 打开PDF文件用Adobe Reader或浏览器手动查看：若人工也看不到文字（仅显示图片），说明是图像型PDF，必须走OCR流程
避免Yii响应层意外截断
如果是在控制器中用sendFile()之后还想读内容，会失败——因为sendFile()调用Yii::$app->end()终止脚本，后续代码不执行。
- 读取逻辑必须放在
sendFile()之前 - 不要在视图里用
file_get_contents读PDF再echo，容易触发HTTP头冲突或输出缓冲问题 - 大文件建议用
fread()分块读取，避免内存溢出导致返回空字符串
