引言
在 rails 开发中，有时我们需要在浏览器中直接展示 pdf 文件，而不是将其作为下载项提供。这与通过 send_file 等方法将 pdf 文件发送给用户进行下载或保存是不同的概念。send_file 主要用于服务器端文件传输，而要在 html 页面中内联显示 pdf，我们需要借助前端技术和 rails 提供的路径助手。
方法一：使用 HTML <embed> 标签与 Rails asset_path 助手
这是在 Rails 应用中嵌入由资产管道（Asset Pipeline）管理的 PDF 文件的推荐方法。它利用了 HTML5 的 <embed> 标签，并结合 Rails 的 asset_path 助手来生成正确的资源路径。
1. <embed> 标签基础
HTML 的 <embed> 标签用于嵌入外部内容，包括 PDF 文件。其关键属性包括：
- src: 指定要嵌入的 PDF 文件的 URL。
- width: 指定嵌入内容的宽度。
- height: 指定嵌入内容的高度。
- type: 指定嵌入内容的 MIME 类型，对于 PDF 文件应设置为 application/pdf。
2. 结合 asset_path 助手
如果你的 PDF 文件位于 app/assets 目录下（例如 app/assets/files/menulq2.pdf），并希望通过 Rails 资产管道进行管理，那么使用 asset_path 助手是最佳选择。asset_path 会处理文件名哈希（fingerprinting）等资产管道的特性，确保即使文件名在预编译后发生变化，也能生成正确的 URL。
示例代码：
假设你的 PDF 文件是 app/assets/files/menulq2.pdf。在你的 Rails 视图文件（如 .erb 文件）中，可以这样嵌入：
<embed src="<%= asset_path('files/menulq2.pdf') %>"
width="100%"
height="600px"
type="application/pdf">说明：
- asset_path('files/menulq2.pdf') 会根据你的资产管道配置，生成一个正确的 URL，例如 /assets/files/menulq2-abcdef1234567890.pdf。
- width 和 height 可以根据你的布局需求进行调整，这里使用了响应式宽度 100% 和固定高度 600px。
- type="application/pdf" 告诉浏览器这是一个 PDF 文件，以便浏览器调用相应的 PDF 阅读器插件（如果可用）。
优点：
- 文件名哈希处理： 自动处理资产预编译过程中生成的文件名哈希，无需手动更新 URL。
- CDN 兼容性： 如果你配置了 CDN，asset_path 也能生成正确的 CDN URL。
- 缓存管理： 有助于浏览器正确缓存和更新资源。
方法二：直接链接到静态文件
如果你不希望 PDF 文件经过资产管道处理，或者你的 PDF 文件是放置在 public 目录下作为纯静态文件提供，你可以直接在 HTML 中硬编码文件的 URL。
1. 硬编码 URL
这种方法适用于文件路径已知且不希望被资产管道修改的情况。文件通常放置在 Rails 项目的 public 目录下，该目录下的文件可以直接通过 URL 访问。
示例代码：
假设你的 PDF 文件是 public/files/menulq2.pdf。在你的 Rails 视图文件中，可以这样嵌入：
<embed src="/files/menulq2.pdf"
width="100%"
height="600px"
type="application/pdf">说明：
- src="/files/menulq2.pdf" 直接指定了相对于网站根目录的路径。
- 如果你的文件位于 public/assets/files/menulq2.pdf，那么 src 路径将是 /assets/files/menulq2.pdf。
2. 服务器配置要求
为了让 Rails 应用能够直接提供 public 目录下的静态文件，你需要确保在生产环境中启用了静态文件服务。在开发环境中，这通常是默认启用的。
-
Rails 4 及更早版本： 在 config/environments/production.rb 文件中设置：
config.serve_static_files = true
-
Rails 5 及更高版本： 在 config/environments/production.rb 文件中设置：
config.public_file_server.enabled = true
注意事项：
- 启用静态文件服务意味着 Rails 应用本身会处理静态文件的请求。在生产环境中，通常建议使用 Nginx 或 Apache 等专门的 Web 服务器来直接提供静态文件，以获得更好的性能。在这种情况下，这些 Web 服务器会配置为直接服务 public 目录，Rails 应用则不需要启用 public_file_server.enabled。
- 确保 public 目录下的文件具有正确的读取权限。
注意事项与最佳实践
-
区分文件发送与文件嵌入：
- send_file（通常在控制器中使用）用于将文件作为 HTTP 响应发送给客户端，通常用于下载。
- <embed> 标签用于在 HTML 页面中显示文件内容。两者用途不同，不应混淆。
浏览器兼容性： 虽然现代浏览器普遍支持 <embed> 标签嵌入 PDF，但其行为可能因浏览器和用户安装的 PDF 阅读器插件而异。某些浏览器可能默认使用内置阅读器，而另一些则可能需要用户安装插件。在移动设备上，嵌入 PDF 的体验也可能不尽理想。
替代方案： 如果需要更高级的 PDF 渲染控制（例如自定义工具栏、文本选择、注释等），可以考虑使用 JavaScript 库，如 PDF.js。PDF.js 是一个开源的 JavaScript 库，可以在 Web 浏览器中渲染 PDF 文件，提供更一致和可控的用户体验。
-
文件路径管理：
- 对于经常更新或需要版本控制的 PDF 文件，建议将其放入 app/assets 并使用 asset_path。
- 对于不常变动、或不希望经过资产管道处理的 PDF 文件，可以将其放入 public 目录并直接链接。
总结
在 Rails 应用中嵌入 PDF 文件主要有两种有效途径：一是利用 HTML 的 <embed> 标签结合 Rails 的 asset_path 助手，适用于通过资产管道管理的 PDF 文件；二是直接硬编码 URL 链接到 public 目录下的静态 PDF 文件，并确保服务器已配置为服务静态文件。开发者应根据 PDF 文件的管理方式和项目需求选择最适合的方法，并注意浏览器兼容性及潜在的性能优化。对于更复杂的 PDF 交互需求，可以考虑集成专业的 JavaScript 渲染库。
