Mail Disk Space

Version 1.0.3 · Extension Store · requiert PHP 7.4+ Suivre l'usage du stockage courriel par compte cPanel, avec surcharges de quota par utilisateur et rapports automatiques de dépassement.

Mail Disk Space mesure l'usage de la boîte de chaque compte (du sur /home/<user>/mail/), le compare à un quota par forfait (en Go) multiplié par un multiplicateur par compte optionnel, et rapporte les comptes dépassant quota + marge — à l'écran, sur la tuile du tableau de bord, et par courriel (cron tous les 3 jours ou à la demande).

Elle peut aussi faire apparaître une entrée « Email disk usage » dans le tableau de bord cPanel de chaque utilisateur, via un hook Perl de ressources optionnel.

---

Onglet Scan

• Recalculate all — réanalyse complète de chaque compte (peut prendre plusieurs minutes sur des serveurs occupés ; un avis de progression vous demande de ne pas fermer l'onglet). Les exécutions sont sérialisées par un verrou, donc une analyse depuis l'interface et le cron ne peuvent pas entrer en collision.
• Send over-quota report — expédie le rapport courant via le Notifier du noyau immédiatement. Si aucun compte n'est en dépassement, rien n'est envoyé (vous obtenez « No account is over quota. »).
• Badge de dernière analyse — âge de l'analyse en cache (vert quand frais, orange quand plus vieux que 3 jours ou jamais exécuté).
• Zone de filtre — filtrage instantané côté client par utilisateur / domaine / forfait.

Le tableau

Une ligne par compte, toutes les colonnes triables (défaut : % used, décroissant) :

Colonne	Signification
User / Domain / Plan	Compte, domaine principal, nom du package WHM.
Used	Taille actuelle de la boîte (Go).
Allowed	quota du forfait × multiplicateur de surcharge (Go).
% used	Barre de progression — vert < 80 %, ambre 80–99 %, rouge ≥ 100 %, ou « — » quand le quota du forfait est désactivé (-1).
Override	Multiplicateur par compte (défaut 1, accepte les décimales 0–100, ex. 1.5 = 150 % du quota du forfait, 6 sur la capture = 6× le forfait). Validé à la perte de focus/Entrée et réanalyse ce compte immédiatement.
Recalc	Réanalyse uniquement ce compte.

Les lignes en dépassement reçoivent une surbrillance chaude ; les lignes dont l'analyse a échoué montrent le nom d'utilisateur en rouge avec l'erreur en info-bulle.

---

Onglet Configuration

Rapport

Les destinataires/canaux sont gérés centralement — le rapport passe par le Notifier du noyau (Options → Notifications), qui délègue SMS/Slack au Contact Manager de cPanel (WHM → Server Contacts).

Champ	Défaut	Notes
Quota buffer (GB)	1	Tolérance ajoutée par-dessus le quota autorisé avant qu'un compte soit considéré en dépassement (décimales acceptées).

Quotas par forfait (Go)

Une ligne par forfait d'hébergement. Les noms de forfait doivent correspondre aux noms de package définis dans WHM → Packages (le nom est lié au package — renommez-le dans WHM, puis retirez + ré-ajoutez l'entrée ici).

• Valeur de quota : un entier positif (Go), 0, ou -1 pour désactiver la vérification de quota pour ce forfait (les comptes concernés sont sautés).
• + Add plan ajoute une ligne ; le bouton × en retire une (au moins un forfait doit rester — utilisez -1 pour neutraliser un forfait plutôt que de supprimer la dernière ligne).
• Les noms de forfait en double sont rejetés.

Défauts livrés : Eco: 1, Essentiel: 1, Plus: 5, Pro: 15, Elite: 15, Dev: 30.

Automatisation de l'analyse

Deux intégrations au niveau serveur, installées à l'installation de l'extension, chacune avec une bascule Enable/Disable :

Intégration	Ce qu'elle fait
Mail disk cron	/etc/cron.d/toolbox-mail-scan — analyse complète tous les 3 jours à 21:00, envoyant le rapport de dépassement automatiquement si au moins un compte dépasse son quota. Journal : /var/log/toolbox-mail-scan.log.
Module de stats courriel cPanel	Hook Perl /var/cpanel/perl/Cpanel/ResourceUsage/Custom/emaildiskusage.pm — fait apparaître « Email disk usage » dans le tableau de bord des ressources cPanel de chaque utilisateur (lit le fichier ~/.cpanel/mailsizeinfo par compte que le scanner maintient).

---

Le rapport de dépassement

Envoyé via le Notifier du noyau (sujet [<hostname>] Astral Toolbox - Mail disk usage over quota) quand au moins un compte dépasse allowed + buffer :

• Courriel HTML — tableau de contexte (serveur, nombre, heure de l'analyse) plus un tableau par compte (Mailbox, Domain, Used, Quota, % used) trié par usage, avec un badge rouge à ≥ 150 %.
• Jumeau texte — une ligne User : <user> (<domain>) is over quota X / Y Gb par compte (c'est ce que reçoivent les canaux SMS/Slack).

Carte des données et fichiers

Chemin	Rôle
extensions/mail-disk-space/config/settings.default.json	Défauts livrés (forfaits, marge)
extensions/mail-disk-space/config/settings.user.json	Vos surcharges (préservées à la mise à jour)
extensions/mail-disk-space/var/scan-cache.json	Résultats de la dernière analyse (root seulement)
extensions/mail-disk-space/var/overrides.json	Multiplicateurs par compte (seules les valeurs ≠ 1.0 sont stockées)
/home/<user>/.cpanel/mailsizeinfo	Deux lignes (octets utilisés, octets autorisés) consommées par le hook cPanel
/etc/cron.d/toolbox-mail-scan	Le cron tous-les-3-jours (quand activé)
/var/log/toolbox-mail-scan.log	Sortie du cron