把下载地址直接贴进正文，第二天全网都在用你的图床

手册、驱动、规格书这类文件放在产品页上，最省事的做法是传个文件，把链接贴到正文里。省事，但那个链接是公开的：谁都能复制，谁都能贴到别处，谁都能用你的带宽下。

资源下载模块把这件事改了个结构：文件挂在一条「资料」记录上，前台走 /cms_download/down/{id} 下载，真实地址不暴露。

一条资料要填什么

后台「资源下载」里一条记录：

• 分类：树形，两级
• 名称
• 封面
• 摘要
• 下载文件：单个文件，走站点统一的文件存储
• 下载信息：一段纯文本，比如版本号、适用系统、文件大小、解压密码
• 内容：富文本，写详细说明

「下载信息」这个字段单独存在，是因为它经常需要被复制。用户下载完要解压密码，或者想知道适配哪个系统，把这段文字放在详情页显眼位置，比埋在富文本里好找。

分类和内容之外，还有一套自定义字段。如果站里卖的是设备，每条资料可能需要「适用型号」「固件版本」「文件大小」三个字段，这些不用改代码，在自定义字段里加，表单上会多出对应的输入框。这一套是公共组件（AbstractCustomFieldManageController），站点其他模块也用同一个机制。

下载链接是加密的

前台地址是 /cms_download/down/{id}，不是文件存储的真实路径。

配置里有两个开关决定它怎么工作：

登录后才能下载。打开之后，点下载会提示「请先登录」并中断。这一项是给「留资换资料」的场景用的：留个账号再拿文件。关掉就是公开下载。

直接跳转下载。打开，后台会 302 跳到文件的真实地址，浏览器直接从存储上取；关掉，文件内容由应用读出后再吐给浏览器，下载的文件名会被改成「资料名称.扩展名」。

这两档的差别不只是体验：

• 开着「直接跳转」，下载更快（少一层转发），但真实地址暴露了，绕过站点直接下载没有任何障碍；
• 关掉，走应用转发，地址不外泄，代价是大文件会占 PHP 进程和内存，几十兆以上的文件容易超时。

所以实践上的选择是：小的资料（手册、驱动、几兆的压缩包）关掉直连，走转发；大文件（几百兆的镜像）开着直连，靠 CDN 和临时签名地址控制，不要指望应用层扛。

那个「文件名改成资料名称」的细节挺实用：原始文件名常常是 驱动_v2.1_final(1).zip，用户下完找不到东西。改成「XX 型号打印机驱动.zip」，省掉一轮客服。

分类要按「用户找东西的方式」划

一个常见的错误是按部门划分类：市场部资料、技术部资料、产品部资料。用户不知道哪个部门管什么，他只知道「我要找 A4 打印机的驱动」。

按用途划才对：

• 驱动与固件
• 使用说明
• 规格参数
• 安装与部署

两级足够。三个以上层级，用户点到第三层已经忘了自己在找什么。

列表页右侧是分类树，当前分类高亮，父级展开。这一栏在资料超过三十条、分类超过四个之后才有意义，量少的时候可以只用「全部」。

详情页

左上是封面，右边是名称、分类、日期，下面是下载按钮和下载信息，再往下是富文本内容和评论。

下载按钮的状态会跟着配置变：要求登录而当前未登录时，点下去弹提示；能下载时点一下就开始。这里没有「下载次数」统计，记录里不存这个字段。想知道哪些资料被下得多，得靠站点的访问统计（RobotsStatistics 那类模块），按 URL 看。

评论是接的通用评论组件，需要装 Member。资料下面有人问「这个驱动支持 Win11 吗」，比在客服队列里问要好。

几个实际问题

文件放哪。默认走站点的文件存储（本地或者对象存储）。资料类文件生命周期长、体积大，建议直接放对象存储 + CDN，别堆在服务器本地磁盘上。

版本怎么管。同一个资料出新版本，是覆盖原记录还是新建一条？建议新建一条，旧的保留，标题里带版本号，内容里写更新说明。用户手上的旧版出问题，还能找回上一版。

过期资料要不要下架。驱动和固件有兼容性风险，老版本一直挂着会有人下错。在标题上标「仅适用于 V1 硬件」，或者干脆下架，比留着好。

防盗链。如果最终还是用了直连，记得在对象存储或 CDN 上配 Referer 白名单，不然地址一旦外传，别人的站会拿你的文件当自己的下载源。

依赖。这个模块要求 Member，也要求 Vendor:>=3.4.0。会员没装，登录限制那一项和评论区都不会工作。