上傳與補傳:佇列、暫停與失敗退避

新上傳

媒體庫上傳(含 REST/XML-RPC 程式化上傳)在生成附件後設資料的同時進桶:主檔案、原圖、各尺寸一個不落。第三方直接放進 uploads 目錄的檔案不會自動進桶——用映象回源,或讓開發者呼叫 wpsss_file_upload()。

存量補傳佇列

工具 → 日常 → 開始補傳。頂部有進度條:百分比按首輪「已處理 + 剩餘」為基線即時推進,文字行同步顯示本輪成功 / 失敗 / 剩餘。

  • 一次一個附件:每個請求只上傳一個附件,不會因閘道器超時中斷整批。
  • 可暫停:點「暫停」立即停;網路中斷自動暫停,再點繼續。
  • 關頁繼續:關掉頁面後,後臺任務每分鐘最多補 2 個附件直到清完(需要站點 cron 正常工作),佇列清空後自動停止。
  • 斷點續傳:按附件編號從新到舊處理,中斷後從上次位置繼續。點「從最新開始」可清掉續傳位置重新掃(已進桶的自動跳過)。

失敗退避

同一個附件連續失敗 3 次後,自動退出補傳佇列(避免一個壞檔案卡住整隊)。佇列清空後如果只剩失敗項,工具頁會明確提示剩多少個、到哪裡查原因:到「工具 → 排障 → 體檢」,修好後點「重試失敗項」,或命令列:

wp sss offload --source=failed

縮圖與主檔案標記

設定裡可以關掉「同時上傳縮圖」。此時外掛給附件打上「主檔案」標記:主檔案地址照常指向桶,各尺寸地址保持本地——前臺不會因為尺寸檔案不在桶裡而裂圖。PDF 附件同理:PDF 本體進桶,預覽縮圖留在本地。0 位元組的損壞檔案也能如實上傳(物件按 0 位元組儲存)。

keep_local:本地備份

預設開啟(推薦):桶與本地各一份,源站掛了也能從本地恢復。關閉後本地檔案在上傳成功後刪除——此時外掛會接管 get_attached_file(編輯圖片等場景退回桶地址),上傳重名檔案也會先查桶避免覆蓋。關閉本地備份需要管理員在高階設定操作。

媒體庫裡也能直接操作

  • 狀態列「物件儲存」:每個附件標出已進桶 / 未進桶 / 失敗(附原因),列表頁還有「全部 / 已進桶 / 未進桶 / 失敗」篩選。
  • 行內動作:未進桶的附件在列表行內點「補傳到桶」;已進桶的可「拉回本地」。
  • 批次操作:列表勾選後批次「補傳到桶」或「拉回本地」。
  • 附件編輯頁側欄:顯示物件鍵與對外地址,可直接開啟,也可單附件補傳 / 拉回。

高階設定裡的上傳開關

  • 遠端已有則跳過:桶裡已有同名物件時不再重複上傳(預設關;適合重建桶後避免覆蓋)。
  • 自動重新命名:同名衝突時的處理——關閉(預設,按原名加 -1、-2 遞增)/ md5 / 時間戳。
  • 不進桶的副檔名:填了就不上傳的副檔名清單;php、htaccess 無論如何都不進桶。
想留言或繼續討論?請到 Cyberforums 賽博論壇參與。參與討論 / 回覆