QQ扫一扫联系
文库站搬家最耗人的环节是搬内容。后台一次传一个文件、填一次标题、选一次分类,三千份就是三千轮。手指头会先坏掉。
文库系统增强补的就是这类「批量」能力:批量上传、批量转换重试,还有一个给读者用的资源篮。
界面上传:选文件夹,模块自动筛出可上传的文档类型,其余的跳过。支持 pdf、doc、docx、ppt、pptx、txt、xlsx、xls、csv 这几种,其他的不会进队列。适合几百份的量,传完能去泡杯茶。

传之前有个「批量设置分类」的按钮,勾选文件后一次给它们指定分类和辅助分类,不用一个一个选。价格也能批量设:积分和现金都为 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 跑起来会报一堆看不懂的错。