ファイルアップロード処理

目次

• 概要
• 使用場面
• クイックスタート
• リファレンスガイド
• ベストプラクティス

概要

検証、サニタイゼーション、ウイルススキャン、効率的なストレージ管理、CDN統合、適切なファイル配信メカニズムを備えた、セキュアでロバストなファイルアップロードシステムを様々なバックエンドフレームワークで構築します。

使用場面

• ファイルアップロード機能の実装
• ユーザーアップロードドキュメントの管理
• メディアファイルの保存と配信
• プロフィール画像アップロードの実装
• ドキュメント管理システムの構築
• バルクファイルインポートの処理

クイックスタート

最小限の動作例：

# config.py
import os

class Config:
    MAX_CONTENT_LENGTH = 50 * 1024 * 1024  # 50 MB
    UPLOAD_FOLDER = 'uploads'
    ALLOWED_EXTENSIONS = {'txt', 'pdf', 'png', 'jpg', 'jpeg', 'gif', 'docx', 'doc'}
    UPLOAD_DIRECTORY = os.path.join(os.path.dirname(__file__), UPLOAD_FOLDER)

# file_service.py
import os
import mimetypes
import hashlib
import secrets
from werkzeug.utils import secure_filename
from datetime import datetime
import magic
import aiofiles

class FileUploadService:
    def __init__(self, upload_dir, allowed_extensions, max_size=50*1024*1024):
        self.upload_dir = upload_dir
        self.allowed_extensions = allowed_extensions
        self.max_size = max_size
        self.mime = magic.Magic(mime=True)
// ... (完全な実装についてはリファレンスガイドを参照してください)

リファレンスガイド

references/ ディレクトリ内の詳細な実装：

ガイド	内容
Python/Flask ファイルアップロード	Python/Flask ファイルアップロード
Node.js Express Multer を使用したファイルアップロード	Node.js Express Multer を使用したファイルアップロード
FastAPI ファイルアップロード	FastAPI ファイルアップロード
S3/クラウドストレージ統合	S3/クラウドストレージ統合

ベストプラクティス

✅ する

• ファイル拡張子と MIME タイプを検証する
• ファイルサイズを処理前にチェックする
• ディレクトリトラバーサルを防ぐため、セキュアなファイル名を使用する
• ファイルをウェブルート外に保存する
• ウイルススキャンを実装する
• ファイル配信に CDN を使用する
• 直接アクセス用に署名付き URL を生成する
• ファイルアップロード/ダウンロードイベントをログに記録する
• アクセス制御チェックを実装する
• 一時ファイルをクリーンアップする

❌ しない

• ユーザー提供のファイル名を信頼する
• ウェブアクセス可能なディレクトリにファイルを保存する
• 任意のファイルタイプを許可する
• アップロードされたファイルのウイルススキャンをスキップする
• 絶対ファイルパスを公開する
• 無制限のファイルサイズを許可する
• アクセス制御を無視する
• 予測可能なファイルパスを使用する
• ファイル名に機密メタデータを保存する
• ファイルコンテンツの検証を忘れる