萬盛學電腦網

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

PHP 以日期時間命名目錄並自動創建:實用代碼片段

核心代碼

<?php
// 獲取當前日期(年月日)
$dateDir = date('Ymd'); // 如 20241219

// 目標目錄路徑(相對當前腳本)
$targetDir = "./{$dateDir}/";

// 判斷不存在則創建,權限 0755(建議生產環境避免 0777)
if (!file_exists($targetDir)) {
    if (!mkdir($targetDir, 0755, true)) { // true = 遞歸創建
        die("目錄創建失敗:{$targetDir},請檢查權限");
    }
    echo "目錄創建成功:{$targetDir}";
} else {
    echo "目錄已存在:{$targetDir}";
}
?>

關鍵點解析

  • date('Ymd'):生成無分隔符日期字符串,適合文件系統命名(無特殊字符、按時間自然排序)。
  • mkdir($path, 0755, true):第三參數 true 開啟遞歸創建,父目錄不存在也會自動建立。
  • 權限 0755:擁有者讀寫執行,組/其他讀執行。生產環境禁用 0777(全域可寫),防止安全風險。
  • file_exists() 先判斷避免 mkdir 拋 Warning(目錄已存在時)。

進階封裝:可復用函數

<?php
/**
 * 按日期創建/獲取上傳/日誌/緩存目錄
 * @param string $basePath 基礎路徑(絕對路徑更安全)
 * @param string $format 日期格式,默認 Ymd
 * @param int $mode 目錄權限,默認 0755
 * @return string 完整目錄路徑(以 DIRECTORY_SEPARATOR 結尾)
 */
function getDateDir(string $basePath, string $format = 'Ymd', int $mode = 0755): string {
    $dateStr = date($format);
    $dir = rtrim($basePath, DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR . $dateStr . DIRECTORY_SEPARATOR;
    
    if (!is_dir($dir)) {
        if (!mkdir($dir, $mode, true)) {
            throw new RuntimeException("無法創建目錄:{$dir}");
        }
        // 可選:設置目錄擁有者(需 root 權限)
        // chown($dir, 'www-data');
        // chgrp($dir, 'www-data');
    }
    return $dir;
}

// 使用示例
$uploadDir = getDateDir('/var/www/uploads');
$logDir = getDateDir('/var/log/myapp', 'Y/m/d'); // 多級:2024/12/19/

常見應用場景

  1. 文件上傳分目錄存儲:/uploads/20241219/abc.jpg,避免單目錄文件過多導致 inode 耗盡、ls 卡頓。
  2. 日誌按天切分:/var/log/app/2024/12/19/app.log,配合 logrotate 更優雅。
  3. 緩存/臨時文件隔離:/tmp/cache/20241219/,定時清理昨天目錄釋放空間。
  4. 導出報表輸出目錄:按日期歸檔,便於查找與備份。

總結

「按日期命名目錄 + 遞歸創建 + 安全權限」是文件存儲的基礎最佳實踐。封裝為通用函數 getDateDir() 置於公共庫,全項目複用,統一規範,減少重複造輪子與權限隱患。

copyright © 萬盛學電腦網 all rights reserved