PHP怎么清空目录内容_PPHP清空目录下所有文件方法

rmdir()

<?php

/**
 * 清空指定目录下的所有文件和子目录。
 * 注意：此函数会删除目标目录内的所有内容，但不会删除目标目录本身。
 * 如果要删除目录本身，需要在调用此函数后额外调用 rmdir()。
 *
 * @param string $dirPath 要清空的目录路径。
 * @return bool 成功返回 true，失败返回 false。
 */
function clearDirectoryContents(string $dirPath): bool
{
    // 确保路径是目录且存在
    if (!is_dir($dirPath)) {
        // 目录不存在，或者不是一个目录，从清空内容角度看，它已经是空的了，
        // 但从操作本身来说，是找不到目标。这里选择返回 false，表示操作未成功执行。
        // 实际场景中，可以根据需求决定是返回 true（认为已是清空状态）还是 false。
        // 我个人倾向于返回 false，因为这代表着预期的“操作”没有发生。
        return false;
    }

    // 尝试打开目录句柄
    $handle = opendir($dirPath);
    if ($handle === false) {
        // 无法打开目录，可能是权限问题
        return false;
    }

    while (($item = readdir($handle)) !== false) {
        // 跳过 '.' 和 '..' 这两个特殊目录
        if ($item === '.' || $item === '..') {
            continue;
        }

        $itemPath = $dirPath . DIRECTORY_SEPARATOR . $item;

        if (is_file($itemPath)) {
            // 如果是文件，直接删除
            if (!unlink($itemPath)) {
                closedir($handle);
                return false; // 删除文件失败
            }
        } elseif (is_dir($itemPath)) {
            // 如果是子目录，先递归清空其内容
            if (!clearDirectoryContents($itemPath)) {
                closedir($handle);
                return false; // 子目录清空失败
            }
            // 子目录内容清空后，删除空子目录
            if (!rmdir($itemPath)) {
                closedir($handle);
                return false; // 删除空子目录失败
            }
        }
    }

    closedir($handle); // 关闭目录句柄
    return true; // 所有操作成功
}

// 示例用法：
// $targetDir = '/path/to/your/data/cache'; // 假设这是你要清空的目录
// if (clearDirectoryContents($targetDir)) {
//     echo "目录内容已成功清空。\n";
// } else {
//     echo "清空目录内容失败，请检查路径和权限。\n";
// }

?>

unlink()

rmdir()

.gitignore

index.html

<?php

/**
 * 清空指定目录下的所有文件和子目录，并可排除特定项。
 *
 * @param string $dirPath 要清空的目录路径。
 * @param array $excludeItems 一个包含要排除的文件名或子目录名的数组。
 *                             例如：['.gitignore', 'config_dir']。
 *                             注意：这里的排除是针对当前层级的名称，不是完整路径。
 * @return bool 成功返回 true，失败返回 false。
 */
function clearDirectoryContentsWithExclusions(string $dirPath, array $excludeItems = []): bool
{
    if (!is_dir($dirPath)) {
        return false;
    }

    $handle = opendir($dirPath);
    if ($handle === false) {
        return false;
    }

    while (($item = readdir($handle)) !== false) {
        if ($item === '.' || $item === '..') {
            continue;
        }

        // 检查当前项是否在排除列表中
        if (in_array($item, $excludeItems, true)) {
            // 如果在排除列表中，就跳过不处理
            continue;
        }

        $itemPath = $dirPath . DIRECTORY_SEPARATOR . $item;

        if (is_file($itemPath)) {
            if (!unlink($itemPath)) {
                closedir($handle);
                return false;
            }
        } elseif (is_dir($itemPath)) {
            // 如果是子目录，且不在排除列表中，则递归处理
            // 注意：这里需要考虑子目录内部是否也需要排除规则，
            // 如果需要，excludeItems参数可能需要更复杂的结构或在递归调用时重新计算。
            // 目前的实现是，如果子目录本身被排除，则其内容也不会被删除。
            // 如果子目录未被排除，则其内容会全部被删除，不考虑子目录内部的排除规则。
            // 这是一个设计上的取舍，通常情况下，我们希望排除的是顶层目录下的特定项。
            if (!clearDirectoryContentsWithExclusions($itemPath, [])) { // 递归调用时，子目录内部不应用父级的排除规则
                closedir($handle);
                return false;
            }
            if (!rmdir($itemPath)) {
                closedir($handle);
                return false;
            }
        }
    }

    closedir($handle);
    return true;
}

// 示例用法：
// $targetDir = '/path/to/your/project/temp';
// $excluded = ['.gitkeep', 'important_config_folder']; // 排除 .gitkeep 文件和 important_config_folder 目录
// if (clearDirectoryContentsWithExclusions($targetDir, $excluded)) {
//     echo "目录内容已清空，并保留了指定项。\n";
// } else {
//     echo "清空目录内容失败。\n";
// }

?>

$excludeItems

/data/cache/important_config

/data/cache

$item

important_config

important_config

clearDirectoryContentsWithExclusions($itemPath, [])

excludeItems

unlink()

rmdir()

max_execution_time

scandir()

readdir()