萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

FCKeditor / CKEditor 文件上傳:按日期分目錄存儲與自動重命名實現

背景

FCKeditor (現 CKEditor 4) 文件上傳默認全部堆在同一目錄,文件名衝突、目錄文件過多導致 inode 耗盡、列表緩慢。需實現:**按日期自動建立子目錄 + 上傳文件自動重命名 (時間戳 + 隨機數)**。

一、修改配置:按日期分目錄

文件:editor/filemanager/connectors/php/config.php

// 原配置
$Config['UserFilesPath'] = '/userfiles/';

// 修改為動態日期目錄
$Config['UserFilesPath'] = '/userfiles/' . date('Y-m-d') . '/';
$Config['UserFilesAbsolutePath'] = $_SERVER['DOCUMENT_ROOT'] . $Config['UserFilesPath'];

// 確保目錄存在 (config.php 執行早於上傳處理,可在此創建)
if (!is_dir($Config['UserFilesAbsolutePath'])) {
    mkdir($Config['UserFilesAbsolutePath'], 0755, true);
}

二、修改核心上傳邏輯:自動重命名

文件:editor/filemanager/connectors/php/io.php

找到 SanitizeFileName 函數 (約第 100 行),替換為:

function SanitizeFileName($sNewFileName) {
    global $Config;
    $sNewFileName = stripslashes($sNewFileName);

    // 強制單一擴展名
    if ($Config['ForceSingleExtension']) {
        $sNewFileName = preg_replace('/\.(?![^.]*$)/', '_', $sNewFileName);
    }
    // 移除危險字符
    $sNewFileName = preg_replace('/[\|\:\*\?"<>\x00-\x1F]/', '_', $sNewFileName);

    // === 核心:生成唯一文件名 ===
    // 1. 取得擴展名 (小寫)
    $ext = strtolower(pathinfo($sNewFileName, PATHINFO_EXTENSION));
    // 2. 基於時間戳 + 微秒 + 4位隨機數
    $newName = date('YmdHis') . '_' . substr(microtime(), 2, 4) . '_' . mt_rand(1000, 9999);
    // 3. 組合
    return $newName . ($ext ? '.' . $ext : '');
}

三、安全加固 (必須)

  1. 文件類型驗證:在 FileUpload.php 中檢查 MIME 類型、擴展名白名單、文件頭魔數 (如 finfo_file),防止上傳 .php/.jsp/.asp 可執行腳本。
  2. 禁用腳本執行權限:上傳目錄配置 Nginx/Apache location ~ \.php$ { deny all; }。
  3. 限制文件大小:$Config['MaxFileSize'] = 10 * 1024 * 1024; (10MB) + PHP/NGINX 同步限制。
  4. 隨機化目錄結構:/userfiles/2024/05/20/ 避免單目錄文件過多。

四、CKEditor 4/5 現代配置 (參考)

CKEditor 5 建議使用官方 Upload Adapter,後端實現標準 REST API:

// 後端路由 POST /api/upload
// 請求:multipart/form-data file=@image.png
// 響應:{ "url": "https://cdn.example.com/uploads/2024/05/20/abc123.png" }

// 前端配置
ClassicEditor
    .create(document.querySelector('#editor'), {
        simpleUpload: {
            uploadUrl: '/api/upload',
            headers: { 'X-CSRF-TOKEN': $('meta[name=csrf-token]').attr('content') }
        }
    })

結語

修改 config.php 動態設置路徑、重寫 SanitizeFileName 實現唯一命名,並**務必在上傳處理入口加入 MIME/魔數/擴展名三重驗證 + Web Server 禁用腳本執行**。現代項目建議遷移至 CKEditor 5 + 標準上傳 API 架構,分離前後端關注點。

copyright © 萬盛學電腦網 all rights reserved