Структура каталогов по ID в PHP: практические решения

Расширенные примеры организации каталогов по ID

Ниже приведены более сложные сценарии, которые могут потребоваться в реальных проектах.

Пример 1. Функция с настраиваемой глубиной и корзиной

function buildIdPath(int $id, int $baseDepth = 3, int $bucketSize = 100): string {
    $parts = [];
    $num = $id;
    for ($i = 0; $i < $baseDepth; $i++) {
        $parts[] = $num % $bucketSize;
        $num = intdiv($num, $bucketSize);
    }
    $parts[] = $id; // последний сегмент - сам ID
    return 'storage/' . implode('/', $parts);
}

// Использование:
$path = buildIdPath(123456, 2, 100);
// Результат: storage/56/34/123456
echo $path; 
  

storage/56/34/123456
  

Пояснение: глубина 2, каждый уровень делит ID на 100 (остаток). Функция гарантирует, что в каждой конечной папке лежит не более 100 подпапок, но при этом общая структура остаётся управляемой.

Пример 2. Создание каталога с проверкой прав и обработкой ошибок

function createSecureDirectory(int $id): ?string {
    $base = '/var/www/data';
    $hash = sha1($id);
    $sub1 = substr($hash, 0, 2);
    $sub2 = substr($hash, 2, 4);
    $full = $base . '/' . $sub1 . '/' . $sub2 . '/' . $id;
    
    if (is_dir($full)) {
        return $full;
    }
    
    // Попытка создания с проверкой ошибок
    if (!mkdir($full, 0700, true) && !is_dir($full)) {
        error_log("Не удалось создать каталог: $full");
        return null;
    }
    
    // Дополнительная проверка на запись
    if (!is_writable($full)) {
        chmod($full, 0700);
    }
    
    return $full;
}

$path = createSecureDirectory(202409);
if ($path) {
    echo "Каталог: $path";
} else {
    echo "Ошибка создания";
}
  

Каталог: /var/www/data/a1/bc3d/202409
  

Пояснение: используется SHA-1 для равномерного распределения. Проверка is_dir после mkdir защищает от race conditions. Права выставлены на 0700 (владелец). В реальном приложении логирование ошибок обязательно.

Пример 3. Рекурсивное удаление каталога по ID с подтверждением

function deleteUserDirectory(int $userId, string $basePath = 'uploads'): bool {
    $path = $basePath . '/' . floor($userId / 1000) . '/' . $userId;
    
    if (!is_dir($path)) {
        return false; // каталог не существует
    }
    
    // Удаляем содержимое рекурсивно
    $items = array_diff(scandir($path), ['.', '..']);
    foreach ($items as $item) {
        $itemPath = $path . '/' . $item;
        if (is_file($itemPath)) {
            unlink($itemPath);
        } elseif (is_dir($itemPath)) {
            deleteUserDirectory($userId . '_' . $item, $basePath); // рекурсия
        }
    }
    
    return rmdir($path);
}

// Пример вызова:
$result = deleteUserDirectory(12345);
var_dump($result);
  

bool(true)
  

Пояснение: функция удаляет каталог, созданный по схеме ID/1000. Внимание: рекурсия опасна при глубокой вложенности - лучше использовать итеративный подход (например, RecursiveDirectoryIterator).

Пример 4. Определение количества файлов в каждой корзине для мониторинга

function getBucketStats(string $rootDir = 'users'): array {
    $stats = [];
    $buckets = glob($rootDir . '/*', GLOB_ONLYDIR);
    foreach ($buckets as $bucket) {
        $count = count(glob($bucket . '/*', GLOB_ONLYDIR));
        $bucketName = basename($bucket);
        $stats[$bucketName] = $count;
    }
    return $stats;
}

print_r(getBucketStats());
  

Array
(
    [0] => 100
    [1] => 95
    [2] => 102
    ...
)
  

Пояснение: функция помогает выявить неравномерность распределения. Если одна корзина содержит значительно больше папок, стоит изменить алгоритм разбиения (например, увеличить число корзин).

Пример 5. Использование с базой данных для хранения соответствия

// Предполагаем таблицу user_storage (user_id, path_hash)
// Создание папки и запись в БД
$pdo = new PDO('mysql:host=localhost;dbname=test', 'user', 'pass');
$userId = 98765;
$salt = bin2hex(random_bytes(4));
$fullPath = 'uploads/' . $salt[0] . '/' . $salt[1] . '/' . $userId;

if (!is_dir($fullPath)) {
    mkdir($fullPath, 0755, true);
    $stmt = $pdo->prepare('INSERT INTO user_storage (user_id, path_hash) VALUES (?, ?)');
    $stmt->execute([$userId, $salt]);
}

// Получение пути по ID:
$stmt = $pdo->prepare('SELECT path_hash FROM user_storage WHERE user_id = ?');
$stmt->execute([$userId]);
$hash = $stmt->fetchColumn();
$actualPath = 'uploads/' . $hash[0] . '/' . $hash[1] . '/' . $userId;
echo $actualPath; // uploads/3/a/98765
  

uploads/3/a/98765
  

Пояснение: случайный соль (4 байта в hex) обеспечивает дополнительную защиту от угадывания. Путь генерируется только при первом обращении и сохраняется в БД. Проблема: при потере базы данных восстановить папки невозможно.