1. 增加服务器图片管理
This commit is contained in:
@@ -0,0 +1,159 @@
|
||||
"""媒体文件管理:浏览和删除上传到 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),
|
||||
}
|
||||
Reference in New Issue
Block a user