DiskMaster 3.1 - Améliorations 2025 #

🎯 Nouveautés #

✅ Ce qui a été ajouté #

1. Copie bidirectionnelle : ← COPY

- Copie maintenant de la liste 2 (droite) vers liste 1 (gauche)

- Symétrisation complète des opérations

2. Upload sécurisé : 📤 UPLOAD

- Interface drag & drop (prête pour amélioration)

- Upload multiple de fichiers

- Gestion des doublons automatique

- Progress bar

3. Download sécurisé : 📥 DOWNLOAD

- Plus de lien direct exposant le path

- Passage par diskmaster.mod handler

- Force le téléchargement pour TOUS les types (y compris .md)

- Validation path complète

1. diskmaster.php (modifié) #

Changements :

• Ajout bouton ← COPY (ligne ~652)
• Ajout bouton 📤 UPLOAD (ligne ~656)
• Fonction copyFileReverse() pour copie inverse
• Fonction uploadFile() avec dialog modal
• Fonction downloadFile() utilise maintenant le handler sécurisé

2. diskmaster.mod.php (nouveau) #

Actions supportées :

• download : Téléchargement sécurisé avec validation path
• upload : Upload multiple avec sanitization
• info : Infos fichier (pour usage futur)

Copie bidirectionnelle #

Avant : Seul COPY → (gauche vers droite)

Maintenant :

1. COPY → : Gauche vers droite (comme avant)

2. ← COPY : Droite vers gauche (nouveau!)

Workflow :

1. Sélectionne un fichier dans la liste de DROITE
2. Clique sur "← COPY"
3. Le fichier est copié vers la liste de GAUCHE

Upload de fichiers #

Workflow :

1. Navigue vers le dossier de destination (liste de gauche)
2. Clique sur "📤 UPLOAD"
3. Sélectionne un ou plusieurs fichiers
4. Clique "UPLOAD"
5. La page recharge automatiquement

Fonctionnalités :

• Upload multiple simultané
• Gestion automatique des doublons (ajoute _1, _2, etc.)
• Sanitization des noms de fichiers
• Progress bar visuelle
• Messages d'erreur clairs

Download sécurisé #

Avant :

window.location.href = getCurrentSourcePath() + '/' + selectedSource;
// → Exposait le path, .md affichés comme texte brut

Maintenant :

window.location.href = '?obj=diskmaster.mod&action=download&path=' + filepath;
// → Handler valide le path, force download pour TOUS types

Sécurité :

• ✅ Path traversal impossible (../ bloqué)
• ✅ Validation contre whitelist $allowedDirs
• ✅ Force header Content-Disposition: attachment
• ✅ Fichiers .md téléchargés au lieu d'affichés

Validation des paths #

Tous les paths passent par validatePath() :

function validatePath($path, $allowedDirs) {
	// 1. Sanitize via Parser
	// 2. Remove ../ et backslashes
	// 3. Check contre whitelist
	// 4. Return false si invalide
}

Upload sécurisé #

// 1. Vérif ADMIN level
if(!secure('SYSTEM_LEVEL_ADMIN')) exit;

// 2. Vérif path destination
if(!validatePath($targetDir, $allowedDirs)) exit;

// 3. Sanitize filename
$filename = preg_replace('/[^a-zA-Z0-9._-]/', '_', $filename);

// 4. Vérif upload errors
if($_FILES['files']['error'][$i] !== UPLOAD_ERR_OK) continue;

Download sécurisé #

// 1. Validate path
if(!validatePath($dir, $allowedDirs)) {
	http_response_code(403);
	exit;
}

// 2. Vérif existence
if(!file_exists($fullPath)) {
	http_response_code(404);
	exit;
}

// 3. Force download
header('Content-Disposition: attachment; filename="' . $filename . '"');

Bug #1 : Fichiers .md servis comme HTML #

Avant : window.location.href = path/file.md → Navigateur affiche le markdown brut

Après : Handler force Content-Disposition: attachment → Téléchargement systématique

Bug #2 : Liste 2 inutilisable #

Avant : Impossible de copier liste2 → liste1

Après : Bouton ← COPY fait l'inverse de COPY →

Bug #3 : Pas d'upload #

Avant : Aucun moyen d'envoyer des fichiers

Après : Interface complète avec upload multiple

Test 1 : Copie bidirectionnelle #

1. Créer fichier test.txt dans user/
2. Naviguer vers user/data/ (liste droite)
3. Sélectionner test.txt (liste gauche)
4. COPY → (gauche vers droite)
5. Vérifier présence dans user/data/
6. Sélectionner test.txt (liste DROITE)
7. ← COPY (droite vers gauche)
8. Vérifier copie réussie

Test 2 : Upload #

1. Naviguer vers user/test/
2. Cliquer "📤 UPLOAD"
3. Sélectionner plusieurs fichiers
4. Cliquer "UPLOAD"
5. Vérifier que tous les fichiers sont présents
6. Essayer d'uploader un fichier avec le même nom
7. Vérifier ajout automatique de _1, _2, etc.

Test 3 : Download sécurisé #

1. Créer un fichier test.md avec du contenu
2. Le sélectionner dans la liste
3. Cliquer "📥 DOWNLOAD"
4. Vérifier que le navigateur le TÉLÉCHARGE au lieu de l'afficher
5. Ouvrir le fichier téléchargé
6. Vérifier que le contenu est intact

Test 4 : Sécurité path traversal #

Tenter (via console ou Postman):
GET ?obj=diskmaster.mod&action=download&path=../../etc/passwd

Résultat attendu: 403 Forbidden

Upload drag & drop #

Actuellement : Bouton file input classique

Amélioration :

// Zone drop
<div id="dropZone" ondrop="handleDrop(event)" ondragover="allowDrop(event)">
	Glissez vos fichiers ici
</div>

function handleDrop(e) {
	e.preventDefault();
	const files = e.dataTransfer.files;
	uploadFiles(files);
}

Preview fichiers #

Avant téléchargement, afficher :

• Images : Thumbnail
• Texte : Aperçu 100 premiers caractères
• PDF : Première page

Compression ZIP #

Bouton "Download as ZIP" pour télécharger un dossier complet

Permissions utilisateur #

Actuellement : SYSTEM_LEVEL_ADMIN requis

Amélioration : Permissions granulaires par dossier

$allowedDirs = [
	'user' => ['read', 'write', 'delete'],
	'user/shared' => ['read', 'write'],
	'user/public' => ['read']
];

Permissions serveur #

Upload nécessite permissions d'écriture :

chmod 755 user/
chmod 755 user/data/
# etc.

Taille max upload #

Configurer dans php.ini :

upload_max_filesize = 50M
post_max_size = 50M
max_execution_time = 300

Types MIME #

Le handler détecte automatiquement le MIME type via finfo_file().

Pour forcer un type spécifique :

$mimeType = 'application/octet-stream'; // Force binary download

Logs d'erreurs #

Vérifier :

tail -f /var/log/php/error.log

Troubleshooting #

Upload ne marche pas :

1. Vérifier permissions dossier

2. Vérifier upload_max_filesize PHP

3. Vérifier logs Apache/Nginx

4. Tester avec un petit fichier (<1MB)

Download ne marche pas :

1. Vérifier que le fichier existe

2. Vérifier path validation

3. Vérifier niveau admin user

4. Tester avec curl : curl -v "url?obj=diskmaster.mod&action=download&path=user/test.txt"

Copy← ne fait rien :

1. Vérifier sélection dans liste DROITE

2. Vérifier console JavaScript pour erreurs

3. Vérifier permissions destination

Version : DiskMaster 3.1

Date : 2025.12.29

Auteur : Treveur 'Nowee' Bretaudière