Configuration

Variables d'environnement

La taille de tranche décide aussi de la voie d'envoi : un fichier qui tient dedans part en une requête, un fichier plus gros est découpé. Elle ne concerne que l'envoi, jamais la lecture : un téléchargement est streamé quelle que soit sa taille. Voir Fichiers acceptés.

Relever LRVO_MODULE_DRIVE_MAX_FILE_SIZE_MB très au delà de 80 Go sans relever la taille de tranche finit par dépasser les 10 000 parts qu'accepte le stockage. Le module refuse alors l'envoi en nommant l'incohérence plutôt que d'échouer à l'assemblage.

Marque de la page publique

Les quatre dernières variables ne servent qu'à /lrvo/drive/<jeton>, la page que voit un destinataire sans compte. L'administration n'en lit aucune.

..._LOGO_URL_DARK n'existe que parce qu'un logo noir disparaît sur un fond sombre. Sans lui, le logo clair sert dans les deux thèmes, ce qui convient à un logo en couleurs.

Sans ..._SITE_URL, le logo s'affiche sans être cliquable. Sans logo du tout, l'emplacement reste vide : un nom posé là où l'œil attend une image se lit comme un logo qui n'a pas chargé. Le nom du site figure de toute façon en pied de page.

Le nom vient de LRVO_NAME par défaut, le logo et la cible du lien de LRVO_LOGO_URL et LRVO_SITE_URL. Les variables du module ne servent qu'aux sites qui partagent sous une autre enseigne que celle de l'application. Le logo des courriels reste celui du site, LRVO_EMAIL_LOGO. Voir Variables d'environnement.

Espaces personnels

Désactivés par défaut. Une fois LRVO_MODULE_DRIVE_PERSONAL_SPACES=true, un item « Mes fichiers » apparaît dans la barre latérale et chaque utilisateur obtient son espace à sa première visite. Rien n'est créé pour les comptes qui n'y vont jamais.

Un espace personnel n'appartient qu'à son propriétaire. Un administrateur ne l'ouvre pas : ce n'est pas du contenu d'équipe. Ce qui doit être vu par d'autres passe par un partage, lien public ou partage interne.

Désactiver l'option ne supprime rien : les espaces existants deviennent inaccessibles depuis l'interface, et redeviennent visibles si l'option est réactivée.

Quotas

Deux niveaux, indépendants, tous deux vérifiés avant chaque écriture : celui de l'espace où l'on écrit, et celui du site entier.

Ces plafonds se règlent par variable d'environnement, et par aucun autre moyen. Un quota est une décision d'exploitation, liée à la taille réelle du seau : le régler depuis l'admin donnerait l'illusion de pouvoir dépasser ce que l'hébergement permet.

Une valeur à 0 lève la limite. Les variables sont relues à chaque contrôle : relever un quota prend effet au redémarrage qui charge le nouveau .env, sans écriture en base et sans toucher aux fichiers déjà déposés.

Deux points surprennent souvent, et sont voulus :

• un fichier en corbeille occupe toujours le quota, parce qu'il occupe toujours le stockage. Il ne se libère qu'à la purge, immédiate ou automatique ;
• les versions antérieures comptent aussi.

Un compteur peut dériver, par exemple si le processus s'arrête entre l'écriture du stockage et celle de la base. La tâche drive-recount le recalcule depuis la vérité, chaque dimanche.

Permissions

Elles sont semées sur le rôle admin à chaque lrvo-db init et lrvo-db migrate. Les autres rôles se règlent dans /admin/roles.

Tâches planifiées

Toutes passent par un verrou en base, donc une seule instance de serveur les exécute même quand plusieurs tournent.

Elles n'ont pas d'écran : leur déroulement se lit dans lrvo_drive_job_lock, qui garde pour chaque tâche sa dernière exécution, son état et son résumé.

Le fuseau vient de LRVO_TIMEZONE, America/Toronto par défaut.