Documentation du plugin optimiseur de fichiers

Compressez les images, PDF, vidéos et audios stockés sur votre site — localement ou via des API cloud — générez des copies WebP, et laissez le serveur web servir de manière transparente les versions optimisées à la place des originaux. Vos fichiers originaux ne sont jamais modifiés.

Comment ça marche

1. Analyse — l'add-on indexe chaque fichier optimisable de votre stockage public dans son propre catalogue (chemin, type, taille).
2. Optimisation — chaque fichier est compressé par le moteur que vous avez sélectionné. Lorsque le résultat est plus petit que l'original (d'au moins le seuil configuré), la copie optimisée est enregistrée dans le dossier miroir storage/app/public/_optimized/<same path>. Pour les images, une copie .webp optionnelle est également générée.
3. Diffusion — les règles de réécriture ajoutées à votre serveur web vérifient, pour chaque requête /storage/..., si une copie optimisée (ou une variante WebP, lorsque le navigateur l'accepte) existe. Si oui, elle est servie ; sinon, le fichier original est servi exactement comme avant.

Cas d'utilisation

Accélérer un site existant

Des années de téléversements s'accumulent. Analysez le stockage une fois, cliquez sur “Tout optimiser”, et laissez l'add-on compresser toute votre bibliothèque multimédia en arrière-plan — puis servez du WebP aux ~97 % de navigateurs qui le prennent en charge.

Améliorer les Core Web Vitals & le SEO

Des images plus petites signifient un LCP plus rapide et de meilleurs scores PageSpeed. L'en-tête Vary: Accept est correctement défini afin que les caches et les CDN continuent de fonctionner.

Réduire les coûts de bande passante & de stockage

Des économies de 30 à 70 % sur les images sont courantes. La page de vue d'ensemble suit le nombre exact d'octets économisés par type de fichier.

Compresser les documents lourds

Les PDF scannés et les brochures rétrécissent considérablement avec le préréglage ebook de Ghostscript tout en restant parfaitement lisibles à l'écran.

Prérequis

• L'une des plateformes prises en charge :
  • Larapen CMS v1.0.0 ou ultérieur
  • LaraClassifier v19.0.0 ou ultérieur
  • JobClass v19.0.0 ou ultérieur
• PHP 8.3+, MySQL 8.0+
• Le lien symbolique du stockage public (php artisan storage:link) — standard sur chaque installation
• Binaires locaux optionnels selon les moteurs que vous activez :
  • Images : jpegoptim, optipng, pngquant, svgo, gifsicle
  • WebP : cwebp (ou les extensions PHP Imagick / GD)
  • PDF : gs (Ghostscript)
  • Vidéos & audios : ffmpeg

Installation

Étape 1 : Téléverser l'add-on

Dans le panneau d'administration, allez dans Admin → Extensions → Add-ons et cliquez sur le bouton Téléverser un add-on. Sélectionnez le fichier ZIP de l’add-on : le système l'extrait automatiquement et l'add-on apparaît dans la liste des add-ons installés.

Étape 2 : Activer l'add-on

Trouvez File Optimizer dans la liste et cliquez sur Activer. L'activation :

• exécute les migrations de base de données (deux tables préfixées par fileoptimizer_),
• enregistre les permissions d'administration,
• installe les règles de réécriture dans public/.htaccess (serveurs Apache/LiteSpeed).

Étape 3 : Configurer & Analyser

Ouvrez Admin → File Optimizer → Paramètres pour choisir vos moteurs, puis allez sur la page Vue d'ensemble et cliquez sur Analyser le stockage.

Code d'achat (clé de licence)

File Optimizer est vendu comme un produit distinct, il possède donc son propre code d'achat (clé de licence) — différent du code d'achat de l'application principale et de celui de tout autre add-on. Il vous est demandé lorsque vous activez File Optimizer dans Panneau d'administration → Add-ons.

Nos produits sont vendus sur trois plateformes. La manière dont vous recevez un code d'achat dépend de l'endroit où vous avez acheté le produit.

1. Boutique bedigit.com (achat sur le site)

• Dès que le statut de paiement de la commande devient Payé, une clé de licence est générée automatiquement pour chaque article sous licence de la commande (une clé par unité achetée — acheter 3 unités donne 3 clés distinctes).
• Elle est envoyée par e-mail à l'adresse utilisée pour la commande, soit dans un e-mail de licence dédié, soit dans l'e-mail de confirmation de commande. Vérifiez votre boîte de réception et votre dossier spam / courrier indésirable.
• La clé reste disponible dans votre compte sous Mon compte → Mes licences. Les clés sont masquées dans la liste ; ouvrez la page de détail de la licence pour révéler et copier la clé complète, voir les domaines sur lesquels elle est activée, et désactiver un domaine pour libérer un emplacement d'activation.
• La facture correspondante se trouve sous Mon compte → Mes commandes.

2. Gumroad

• Un achat sur Gumroad produit deux e-mails distincts : le reçu Gumroad (envoyé par Gumroad, donnant accès aux fichiers) et un e-mail de clé de licence (envoyé par bedigit.com) qui contient votre code d'achat.
• L'e-mail de clé de licence est généré dès que Gumroad nous notifie la vente, il arrive donc normalement quelques secondes après le paiement. Ici aussi, vérifiez votre boîte de réception et votre dossier spam / courrier indésirable.
• Lorsque le produit Gumroad utilise la fonctionnalité de clé de licence propre à Gumroad, la même clé apparaît également dans votre reçu Gumroad et sous Bibliothèque → votre achat sur gumroad.com.
• Utilisez la même adresse e-mail sur bedigit.com que sur Gumroad : vos clés sont alors liées automatiquement à votre compte et listées sous Mon compte → Mes licences, même si vous vous inscrivez après l'achat. Vous pouvez également ajouter une clé Gumroad manuellement depuis Mon compte → Mes licences Gumroad.

3. Envato Market (CodeCanyon)

• Les codes d'achat Envato sont émis et livrés par Envato Market, jamais envoyés par e-mail par nous — il n'y a donc rien à chercher dans votre dossier spam : vous récupérez le code depuis votre compte Envato.
• Connectez-vous à votre compte Envato / CodeCanyon, ouvrez la page Downloads, trouvez l'article, et choisissez License certificate & purchase code dans le menu déroulant Download. Le code est inscrit dans ce certificat.
• Un code d'achat Envato ressemble à 12345678-90ab-cdef-1234-567890abcdef (8-4-4-4-12 caractères). Il ne change jamais, et le renouvellement du support de l'article n'en émet pas de nouveau.
• Article officiel d'Envato : Where Is My Purchase Code?

Démarrage rapide (2 minutes)

1. Activez l'add-on.
2. Allez dans File Optimizer → Vue d'ensemble et cliquez sur Analyser le stockage.
3. Cliquez sur Tout optimiser et gardez la page ouverte jusqu'à ce que la barre de progression soit terminée (ou laissez votre worker de file d'attente faire le travail).
4. Ouvrez Paramètres → Règles de réécriture et cliquez sur Tester les règles (sonde en direct) pour confirmer que les copies optimisées sont bien servies.

Admin : Page Vue d'ensemble

Admin → File Optimizer affiche en un coup d'œil :

• le nombre total de fichiers indexés et l'espace total économisé,
• une carte par type de fichier (Images, PDF, Vidéos, Audios) avec ses compteurs — total, optimisés, en attente, échoués — son utilisation disque et ses économies, ainsi que des boutons rapides Parcourir et Optimiser,
• les exécutions d'optimisation récentes et leurs résultats,
• la barre de progression en direct d'une exécution en cours (elle survit aux rechargements de page).

Un badge « en pause » sur une carte signifie que l'optimisation est désactivée pour ce type dans les paramètres.

Analyser le stockage

L'analyseur parcourt le stockage public et indexe chaque fichier dont l'extension correspond à un type activé. Il s'exécute par lots courts (quelques secondes chacun), il peut donc indexer des dizaines de milliers de fichiers sans expiration de délai ni pics de mémoire.

• Les nouveaux fichiers sont ajoutés comme En attente.
• Les fichiers modifiés (taille ou date changée depuis la dernière analyse) sont remis En attente et leurs copies optimisées obsolètes sont supprimées immédiatement, afin qu'un contenu périmé ne soit jamais servi.
• Les fichiers supprimés sont retirés du catalogue ainsi que leurs copies optimisées.

Relancez l'analyse chaque fois que vous ajoutez ou remplacez des fichiers. Vous pouvez aussi l'automatiser — voir Commandes console.

Parcourir les fichiers

La barre latérale propose une page par type : Images, PDF, Vidéos et Audios. Chaque page liste les fichiers indexés avec une miniature (images), le chemin, la taille d'origine, la taille optimisée, le pourcentage d'économie, le badge WebP et le statut.

Filtres & Recherche

L'en-tête de la liste propose :

• un champ de recherche portant sur le chemin du fichier (met à jour le tableau au fur et à mesure de la saisie),
• un filtre de statut (En attente, En file d'attente, En cours, Optimisé, Ignoré, Échoué),
• un filtre d'extension listant les extensions réellement présentes,
• un bouton Effacer réinitialisant tous les filtres.

Le filtrage ne rafraîchit que le tableau, sans recharger la page.

Actions sur les fichiers

Optimiser les fichiers

Fichier unique

Cliquez sur le bouton éclair de n'importe quelle ligne. La ligne se met à jour sur place avec la nouvelle taille, l'économie et le statut.

En masse & Tout optimiser

• Sélection — cochez les cases (ou la case de l'en-tête) et cliquez sur Optimiser la sélection (n).
• Type entier — cliquez sur Optimiser tous les <type> dans l'en-tête de la page.
• Tout — cliquez sur Tout optimiser sur la page Vue d'ensemble.

Seuls les fichiers au statut En attente ou Échoué sont mis en file d'attente ; les types désactivés dans les paramètres sont ignorés.

Barre de progression

Chaque exécution en masse affiche une barre de progression avec les compteurs traités / optimisés / ignorés / échoués et les octets économisés jusqu'à présent, ainsi qu'un bouton Annuler. Deux modes de traitement existent (voir Paramètres généraux) :

• Piloté par le navigateur (par défaut lorsqu'aucun worker de file d'attente n'est configuré) — la page envoie une courte requête toutes les quelques secondes ; chacune traite une poignée de fichiers. Gardez la page ouverte jusqu'à ce que la barre soit terminée.
• File d'attente — un job par fichier est envoyé à votre worker de file d'attente ; la page ne fait qu'interroger la progression. Vous pouvez quitter la page en toute sécurité.

L'annulation d'une exécution remet les fichiers restants En attente.

Supprimer les copies optimisées

Pour revenir aux fichiers originaux : utilisez le bouton corbeille de la ligne pour un seul fichier, ou sélectionnez plusieurs lignes et cliquez sur Supprimer les optimisées (n). Les copies optimisées et WebP sont supprimées du dossier miroir et les originaux sont à nouveau servis immédiatement.

Paramètres : Général

Paramètres : Images & WebP

Paramètres : PDF

Paramètres : Vidéos

La compression vidéo s'exécute localement via FFmpeg et est désactivée par défaut : le transcodage est gourmand en CPU et doit être un choix explicite.

La copie optimisée conserve le conteneur/l'extension d'origine (WebM reste WebM avec VP9/Opus, MP4 reste MP4 avec H.264/AAC), afin que les règles de réécriture puissent la servir sous l'URL d'origine.

Paramètres : Audios

La compression audio s'exécute également localement via FFmpeg et est désactivée par défaut.

Paramètres : Binaires du serveur

Sous Paramètres → Général → Binaires du serveur, vous pouvez :

• définir un chemin absolu pour chaque binaire lorsqu'il se trouve en dehors du PATH système (fréquent avec PHP-FPM),
• cliquer sur Vérifier les binaires pour voir quels outils sont installés et leur version — un badge vert Disponible ou rouge Introuvable apparaît à côté de chaque champ,
• suivre le lien Site web & téléchargement sous chaque champ pour installer un outil manquant.

Installation typique sur un serveur Debian/Ubuntu :

sudo apt-get install jpegoptim optipng pngquant gifsicle webp ghostscript ffmpeg
sudo npm install -g svgo

Paramètres : Identifiants API

Les moteurs cloud ne nécessitent qu'une clé API, saisie sous Paramètres → Images → Identifiants API (un lien “Obtenir votre clé API” est affiché sous chaque champ) :

Les clés sont stockées dans la base de données (table des paramètres).

Servir les fichiers optimisés : Règles de réécriture

Les règles de réécriture font servir par le serveur web, pour chaque requête sous /storage/ :

1. la variante WebP lorsque le navigateur accepte WebP et qu'une copie .webp existe (avec le bon Content-Type et un en-tête Vary: Accept pour les caches),
2. sinon la copie optimisée lorsqu'elle existe,
3. sinon le fichier original, exactement comme avant.

Gérez tout depuis Paramètres → Règles de réécriture : serveur web détecté, statut des règles, boutons d'installation / suppression, sonde en direct et extraits prêts à copier.

Apache / LiteSpeed

Les règles sont écrites automatiquement dans public/.htaccess, à l'intérieur d'un bloc clairement délimité (# BEGIN FileOptimizer … # END FileOptimizer) :

• installées lorsque l'add-on est activé,
• rafraîchies lorsque les paramètres sont enregistrés,
• supprimées lorsque l'add-on est désactivé ou retiré.

Vous pouvez aussi installer/supprimer le bloc manuellement avec les boutons de la page des paramètres.

Nginx

Nginx ne peut pas être configuré automatiquement depuis PHP. La page des paramètres génère un extrait prêt à coller (un bloc map pour le contexte http {} et un bloc location pour votre contexte server {}). Collez-le dans la configuration de votre serveur, exécutez nginx -t et rechargez nginx.

Tester les règles (sonde en direct)

Cliquez sur Tester les règles (sonde en direct) : l'add-on crée un fichier de test temporaire ainsi qu'une copie “optimisée”, demande l'URL publique en HTTP, et indique quelle variante votre serveur web a réellement renvoyée — y compris si la variante WebP est livrée. Cela fonctionne sur tout type de serveur et constitue la vérification définitive que tout est correctement câblé.

Commandes console

# Index the storage (same as the Scan button)
php artisan fileoptimizer:scan

# Optimize every pending file (all types, or one type, optionally capped)
php artisan fileoptimizer:optimize
php artisan fileoptimizer:optimize --type=image
php artisan fileoptimizer:optimize --type=pdf --limit=100

Automatisation cron typique (analyser puis optimiser les nouveaux fichiers chaque nuit) :

0 3 * * * cd /path/to/your/site && php artisan fileoptimizer:scan && php artisan fileoptimizer:optimize >> /dev/null 2>&1

Workers de file d'attente

Lorsque QUEUE_CONNECTION est défini sur database, redis, etc., et que le mode de traitement est Automatique ou File d'attente, les exécutions en masse envoient un job par fichier sur la file d'attente fileoptimizer. Assurez-vous que votre worker l'écoute :

php artisan queue:work --queue=fileoptimizer,default

Pas de worker ? Conservez le mode Automatique : la boucle pilotée par le navigateur n'a besoin de rien d'autre qu'une page d'administration ouverte.

Désactivation & Suppression

• Désactiver — les règles de réécriture sont retirées du .htaccess ; les originaux sont à nouveau servis. Le catalogue, les paramètres et les copies optimisées sont conservés, donc la réactivation restaure tout.
• Supprimer — supprime en plus les tables de l'add-on, tout le dossier miroir (_optimized) et les fichiers de l'add-on. Vos fichiers originaux restent intacts.

Dépannage

Les fichiers échouent avec “engine is not configured”

Le moteur sélectionné nécessite des binaires ou des identifiants qui sont manquants. Lancez Vérifier les binaires sur la page des paramètres, installez les outils manquants (des liens sont fournis sous chaque champ) ou passez à un moteur cloud et saisissez sa clé API.

La sonde indique que les copies optimisées ne sont PAS servies

• Apache : vérifiez que le bloc est installé (Paramètres → Règles de réécriture), que mod_rewrite et AllowOverride All sont activés, et que public/.htaccess est accessible en écriture.
• Nginx : collez l'extrait généré, exécutez nginx -t, rechargez, relancez la sonde.

“Could not write public/.htaccess”

Corrigez les permissions du fichier pour que PHP puisse y écrire (par ex. chown www-data public/.htaccess ou chmod 664), puis cliquez à nouveau sur Installer les règles.

L’exécution en masse ne progresse pas en mode file d'attente

Votre worker n'est pas en cours d'exécution ou n'écoute pas la file d'attente fileoptimizer. Démarrez-le (voir Workers de file d'attente) ou basculez le mode de traitement sur Piloté par le navigateur et relancez.

La plupart des images finissent “Ignorées”

Elles sont déjà bien compressées — le résultat n'a pas dépassé le seuil d'Économie minimale. C'est voulu (servir une copie à peine plus petite n'en vaut pas la peine). Essayez le niveau Agressif ou activez WebP pour des économies supplémentaires.

Un fichier a changé mais l'ancienne version optimisée s'affiche

Lancez une Analyse : les fichiers modifiés sont détectés par taille/date, leurs copies obsolètes sont supprimées immédiatement et ils sont mis en file d'attente pour ré-optimisation.

FAQ

Mes fichiers originaux sont-ils modifiés ?

Jamais. Les copies optimisées sont stockées dans un dossier miroir séparé ; supprimez-les à tout moment pour servir à nouveau les originaux.

Que se passe-t-il si je désactive l'add-on ?

Les règles de réécriture sont supprimées et le site sert les fichiers originaux, exactement comme avant l'installation de l'add-on. Rien d'autre ne change.

Est-ce que cela fonctionne sur un hébergement mutualisé ?

Oui. Le mode piloté par le navigateur ne nécessite ni worker de file d'attente ni accès shell ; le moteur reSmush.it fonctionne même sans aucun binaire ni API payante. Seul le fichier .htaccess doit être accessible en écriture pour l'installation automatique des règles.

WebP va-t-il casser les navigateurs qui ne le prennent pas en charge ?

Non. La variante WebP n'est servie que lorsque le navigateur annonce explicitement sa prise en charge via son en-tête Accept ; tous les autres reçoivent le format d'origine. L'en-tête Vary: Accept maintient les proxys et les CDN cohérents.

Combien de CPU consomme-t-il ?

Le travail s'effectue par étapes courtes (quelques fichiers à la fois) précisément pour que le front-end ne ralentisse jamais. Le transcodage vidéo/audio est plus lourd — c'est pourquoi il est désactivé par défaut et qu'il vaut mieux l'exécuter via un worker de file d'attente ou un cron la nuit.

File Optimizer v1.0.0 · Add-on LaraClassifier / JobClass · par BeDigit