网页内部预览DOC\EXCEL\PDF文档，你有什么好方案？

本说明介绍网站 /pdfceshi/ 目录下这套文档预览系统的用法，包括支持的格式、访问与分享链接的方法、上传和更新文档的步骤、页面各部分的含义、常见问题的处理，以及管理员可以调整的设置项。按文中步骤操作，可以独立完成文档上传、链接分发和日常排查。

一、这套系统能做什么

文档的渲染全部在访客的浏览器里完成，不依赖服务器安装 Office，也不调用系统自带的 PDF 阅读器，所以 Windows、macOS 和手机上的显示效果一致。渲染组件都放在本目录的 libs 文件夹里，服务器不需要连接外网。

二、打开和分享预览链接

访问地址由域名、目录名和 file 参数组成：

https://你的域名/pdfceshi/index.php?file=文件名

例如本站域名是 www.diezanrpa.com，要预览 22978.pdf，链接就是：

https://www.diezanrpa.com/pdfceshi/index.php?file=22978.pdf

只访问 index.php（不带 file 参数）时，页面自动打开目录里最近修改的那份文档，适合作为固定入口发给别人。页面左侧列出目录中所有可以预览的文档，点击文件名即可切换；在手机等窄屏设备上，这个列表会移到页面顶部横向排列。右上角的“下载原文件”把原始文件保存到本机。

链接可以直接发给同事或客户，对方用浏览器打开就能看，不需要安装任何软件。页面只呈现文档内容，不会暴露服务器上的目录结构。

三、上传和更新文档

1. 把文件上传到网站目录 /pdfceshi/，与 index.php 放在同一层。

2. 刷新预览页面，左侧列表会自动出现新文件，不需要修改任何代码。

3. 把 index.php?file=文件名 这段链接发给需要查看的人。

文件名可以用中文，也可以包含空格。为了让链接更容易转发，建议使用英文、数字或拼音命名。更新同名文件时直接覆盖即可，页面读取的始终是最新内容。

系统只列出 pdf、docx、xlsx、xls、doc 五种后缀，其它文件不会出现在列表里。放在子文件夹中的文档同样不会列出，需要列出时请放在与 index.php 同一层。

四、各格式的预览表现

PDF。逐页渲染在网页中，滚动即可翻页，扫描件同样可以显示。文件越大首次打开越慢，4MB 左右的 PDF 通常在几秒内完成；超过 10MB 时请留出等待时间。

Word 和 Excel 的新格式（.docx、.xlsx）。按原文档结构显示，标题、加粗、表格以及多个工作表都会保留，可以像在 Office 里一样浏览。

旧版 Excel（.xls）。页面会先把它转换成新格式再显示，表格内容和数值完整，复杂样式、图表可能有细微差异。

旧版 Word（.doc）。这种格式以二进制方式存储，浏览器无法还原排版，所以系统改为提取正文文字显示，页面顶部会提示不含原有排版。如果必须看到原排版，请用 Word 打开后另存为 .docx 再上传，链接只需改后缀。

五、页面组成与文件结构

六、常见问题速查

七、管理员可以调整的设置

· 访问限制。file.php 顶部的 $REQUIRE_LOGIN 默认是 false，知道链接的人都能查看。改成 true 后，需要主站登录过、并且会话里存在 $_SESSION['user'] 才能读取文件。

· 可读取的文件类型。file.php 里的 $ALLOW_EXT 白名单，默认允许 pdf、docx、xlsx、xls、doc、csv。

· 组件缓存版本。index.php 里的 version 目前是 1。更新 libs 里的组件后，把它改成 2、3 等更大的数字，访客浏览器会重新加载组件，不会继续用旧的缓存。

八、部署和更新时的注意事项

· 上传时保持目录结构不变，libs 里的文件名不要修改，否则页面会找不到组件。

· index.php、file.php 和 libs 有任何改动后，都要对应上传，只传其中一个可能不生效。

· 服务器 PHP 版本 5.4 以上即可运行，代码没有使用高版本专有语法。

· 访客如果看到的是修改前的效果，按 Ctrl+F5 强制刷新，或先按第七节的说明提高 version 值。

· 这套系统适合分发公开或内部资料；需要限制范围时，请开启登录校验或把文件放到受保护目录。

九、文件下载

· 上传：https://1824761007.share.123pan.cn/123pan/Eu2njv-Ymfvh?pwd=Z9Tb#