Guide
资源
公共资源
Nitro 通过 public/
目录处理资源。
public/
目录中的所有资源将自动提供服务。这意味着您可以直接从浏览器访问它们,而无需任何特殊配置。
public/
image.png <-- /image.png
video.mp4 <-- /video.mp4
robots.txt <-- /robots.txt
package.json
nitro.config.ts
生产环境公共资源
构建您的 Nitro 应用时,public/
目录将被复制到 .output/public/
,并将创建一个包含元数据的清单,并嵌入到服务器包中。
{
"/image.png": {
"type": "image/png",
"etag": "\"4a0c-6utWq0Kbk5OqDmksYCa9XV8irnM\"",
"mtime": "2023-03-04T21:39:45.086Z",
"size": 18956
},
"/robots.txt": {
"type": "text/plain; charset=utf-8",
"etag": "\"8-hMqyDrA8fJ0R904zgEPs3L55Jls\"",
"mtime": "2023-03-04T21:39:45.086Z",
"size": 8
},
"/video.mp4": {
"type": "video/mp4",
"etag": "\"9b943-4UwfQXKUjPCesGPr6J5j7GzNYGU\"",
"mtime": "2023-03-04T21:39:45.085Z",
"size": 637251
}
}
这使得 Nitro 无需扫描目录即可了解公共资源,从而提供高性能的缓存头。
服务器资源
assets/
目录中的所有资源将被添加到服务器包中。在构建应用程序后,您可以在 .output/server/chunks/raw/
目录中找到它们。请注意您的资源大小,因为它们将与服务器包一起打包。
它们可以通过 assets:server
挂载点进行访问,使用 存储层。
例如,您可以将 JSON 文件存储在 assets/data.json
中,并在您的处理程序中检索它:
export default defineEventHandler(async () => {
const data = await useStorage('assets:server').getItem(`data.json`)
return data
})
自定义服务器资源
为了从自定义目录添加资源,您需要在 nitro 配置中定义一个路径。这允许您从 assets/
目录之外的目录添加资源。
export default defineNitroConfig({
serverAssets: [{
baseName: 'my_directory',
dir: './my_directory'
}]
})
您可能想要添加一个包含 HTML 模板的目录,例如。
export default defineNitroConfig({
serverAssets: [{
baseName: 'templates',
dir: './templates'
}]
})
然后您可以使用 assets:templates
基础来检索您的资源。
handlers/success.ts
export default defineEventHandler(async (event) => {
const html = await useStorage('assets:templates').getItem(`success.html`)
return html
})