"""媒体文件管理:浏览和删除上传到 MEDIA_ROOT 的文件。 包含: - list_media_files():按目录结构列出所有文件/子目录 - delete_media_file(rel_path):删除指定相对路径的文件 - get_storage_usage():统计目录占用大小 """ import os from pathlib import Path from django.conf import settings MEDIA_ROOT = settings.MEDIA_ROOT def _rel(path: Path) -> str: """把绝对路径转换为相对于 MEDIA_ROOT 的 Unix 风格路径。""" return path.relative_to(MEDIA_ROOT).as_posix() def _human_size(num_bytes: int) -> str: """把字节数格式化成人类可读字符串。""" for unit in ('B', 'KB', 'MB', 'GB'): if num_bytes < 1024: return f'{num_bytes:.1f} {unit}' if unit != 'B' else f'{int(num_bytes)} {unit}' num_bytes /= 1024 return f'{num_bytes:.1f} TB' def list_media_files(sub_path: str = ''): """列出 MEDIA_ROOT/sub_path 下的文件和子目录。 返回结构: { 'current_path': 'uploads/', 'parent_path': None or 'uploads/', 'subdirs': [{'name': '2026', 'path': 'uploads/2026', 'count': 12, 'size': '1.2 MB'}], 'files': [{'name': 'a.jpg', 'path': 'uploads/a.jpg', 'size': '200 KB', 'url': '/media/uploads/a.jpg', 'modified': datetime}] } """ root = MEDIA_ROOT / Path(sub_path) if sub_path else MEDIA_ROOT # 防止路径穿越 try: root.resolve().relative_to(MEDIA_ROOT.resolve()) except ValueError: root = MEDIA_ROOT if not root.exists(): root.mkdir(parents=True, exist_ok=True) current_rel = _rel(root) if root != MEDIA_ROOT else '' parent_rel = str(Path(current_rel).parent) if current_rel else None if parent_rel == '.': parent_rel = '' subdirs = [] files = [] try: entries = sorted(root.iterdir(), key=lambda p: (p.is_file(), p.name.lower())) except PermissionError: entries = [] for entry in entries: try: if entry.is_dir(): file_count = sum(1 for f in entry.rglob('*') if f.is_file()) total_bytes = sum(f.stat().st_size for f in entry.rglob('*') if f.is_file()) subdirs.append({ 'name': entry.name, 'path': _rel(entry), 'file_count': file_count, 'size': _human_size(total_bytes), }) elif entry.is_file(): stat = entry.stat() rel = _rel(entry) files.append({ 'name': entry.name, 'path': rel, 'size': _human_size(stat.st_size), 'size_bytes': stat.st_size, 'url': f'{settings.MEDIA_URL}{rel}', 'modified': stat.st_mtime, 'is_image': entry.suffix.lower() in {'.jpg', '.jpeg', '.png', '.gif', '.webp', '.bmp', '.svg'}, }) except (PermissionError, OSError): continue # 构建面包屑:每一级的 name 和完整路径 breadcrumb = [] if current_rel: parts = Path(current_rel).parts built = [] for p in parts: built.append(p) breadcrumb.append({'name': p, 'path': '/'.join(built)}) return { 'current_path': current_rel, 'parent_path': parent_rel, 'breadcrumb': breadcrumb, 'subdirs': subdirs, 'files': files, 'total_size': _human_size(sum(f['size_bytes'] for f in files)), } def delete_media_file(rel_path: str) -> tuple[bool, str]: """删除指定相对路径的文件。仅允许删除 MEDIA_ROOT 内的文件。 返回 (是否成功, 提示信息)。 """ if not rel_path: return False, '路径不能为空' target = (MEDIA_ROOT / Path(rel_path)).resolve() try: target.relative_to(MEDIA_ROOT.resolve()) except ValueError: return False, '非法路径:只能删除 media 目录内的文件' if not target.exists(): return False, '文件不存在' if not target.is_file(): return False, '目标不是文件' try: target.unlink() except PermissionError: return False, '没有删除权限,请联系服务器管理员检查 www-data 对 media 目录的权限' except OSError as e: return False, f'删除失败:{e}' return True, f'已删除:{rel_path}' def get_storage_usage() -> dict: """返回 media 根目录各子目录的占用概览。""" summary = [] total_bytes = 0 if not MEDIA_ROOT.exists(): return {'top_dirs': [], 'total': '0 B'} for entry in sorted(MEDIA_ROOT.iterdir(), key=lambda p: p.name.lower()): if entry.is_dir(): size = sum(f.stat().st_size for f in entry.rglob('*') if f.is_file()) count = sum(1 for f in entry.rglob('*') if f.is_file()) total_bytes += size summary.append({ 'name': entry.name + '/', 'size': _human_size(size), 'count': count, }) elif entry.is_file(): size = entry.stat().st_size total_bytes += size return { 'top_dirs': summary, 'total': _human_size(total_bytes), }