三千份资料要上传,一个人点了一整天

文库系统增强 使用文档
文库系统增强 使用文档

文库站搬家最耗人的环节是搬内容。后台一次传一个文件、填一次标题、选一次分类,三千份就是三千轮。手指头会先坏掉。

文库系统增强补的就是这类「批量」能力:批量上传、批量转换重试,还有一个给读者用的资源篮。

批量上传的两条路

界面上传:选文件夹,模块自动筛出可上传的文档类型,其余的跳过。支持 pdf、doc、docx、ppt、pptx、txt、xlsx、xls、csv 这几种,其他的不会进队列。适合几百份的量,传完能去泡杯茶。

批量上传界面:每条是一行待上传的记录,左边缩略图占位,中间是文件名和分类选择,右边填积分兑换和现金购买(都为 0 表示免费)、文档标签,最右是「等待上传」状态和删除按钮;底部一个「选择本地文件」的虚线框

传之前有个「批量设置分类」的按钮,勾选文件后一次给它们指定分类和辅助分类,不用一个一个选。价格也能批量设:积分和现金都为 0 就是免费文档。

命令行上传:Wenku:BatchImport,参数是一个 Excel 文件。

php artisan Wenku:BatchImport /path/to/docs.xlsx

三千份以上用这个。Excel 的列是固定的十列,顺序不能改:

列内容
1用户ID
2标题
3目录(绝对路径)
4文件路径(相对目录)
5分类ID
6辅助分类ID(多个用逗号分隔)
7积分
8现金
9标签(逗号分隔)
10简介(为空自动用标题)

第一行必须是标题行,而且必须和代码里写死的那一行完全一致,差一个字都不行,命令会直接报「请保证excel文件第一行为标题行未修改」。这是它防错的方式:宁可让你改表头,也不要在列错位的情况下把三千条数据灌进错误字段。

第 3、4 列分开是有道理的:目录写一次,文件只写相对路径。同一批文件放在一个目录下,表格里就不用每行重复一长串绝对路径。

逗号支持中文逗号,代码里做了 , 到 , 的替换,从 Excel 里直接敲中文标点不用担心。

转换失败的那一批怎么救

文档上传之后要转成可预览的格式(图片、文本),这个过程会失败。原因很多:PDF 加密、字体缺失、文件损坏。

失败一次就失败,重传一份新的当然可以,但三千份里挑出失败的那几十份,再一个个重传,等于又做一遍。

Wenku:ConvertRetry 按 ID 区间重试:

php artisan Wenku:ConvertRetry 1 3000 --failed-only

两个参数是起止 ID,加了 --failed-only 就只处理之前失败的,成功的跳过。还有一个 --convert-text-only,只重跑纯文本提取,不做图片转换——适合「图没坏、但全文检索搜不到」的情况,速度快很多。

重试也是一条条跑的,三千份要跑一阵。建议放在低峰期,用 nohup 或者进程守护挂着,别在 SSH 窗口里跑,断线就断了。

资源篮:一次买好几份

这是给读者用的功能。文库的单篇购买有个天然的低效:用户想下五份资料,得走五次下单。

资源篮把文档攒在一起,最后一次性结算,金额和积分可以混着用。对于「一套资料十几份」的场景(比如一整套施工验收规范),这个体验差别很大。

实现上它是一个购物车:加、删、清空、批量结算。结算时逐份扣款和开权限,中途失败要有回滚,否则会出现「钱扣了但只解锁了三份」。

什么时候需要它

批量上传:内容从别处迁过来,或者一次买了别人的资料库。几十份的话,手工传更快,不用折腾 Excel。

转换重试:文库跑了一段时间,后台有一批「转换中」永远不动的记录。这时候就需要它。

资源篮:文档有明显成套的结构,用户会一次下多份。全是散篇的站,这个功能用不上。

装之前

依赖 Wenku 和 Vendor:>=4.8.0。前者是内容底座,后者提供命令和队列的注册机制。

两个命令都需要在服务器上执行,虚拟主机那种只能通过面板操作的环境用不了。用之前先确认能 SSH,以及 PHP 的 CLI 版本和站点一致——版本不一致时,artisan 跑起来会报一堆看不懂的错。

更新: 2026-11-09 15:42:52
QQ
微信
客服