Package Laravel inovertix/control-backup

Package Laravel inovertix/control-backupPackage Laravel qui sauvegarde la base de l'application et la dépose sur CONTROL (module INOBACKUP). Chaque sauvegarde reçue par CONTROL est conservée à la fois sur son propre disque et sur un stockage objet hors-site.Installation en 5 lignes

bash

composer config repositories.control-backup path ../CONTROL/integrations/laravel-control-backup
composer require inovertix/control-backup:@dev
php artisan vendor:publish --tag=control-backup-config
printf '\nCONTROL_BACKUP_URL=https://plateforme.inovertix.com/api/inobackup\nCONTROL_BACKUP_KEY=CTRLBK_votre_cle\n' >> .env
php artisan control:backup

Le dépôt path peut aussi pointer vers une copie locale du dossier, ou être remplacé par un dépôt Git privé (composer config repositories.control-backup vcs git@…).

Configurationconfig/control-backup.php (publiable) — toutes les valeurs sont pilotables par .env :

Clé	Variable	Défaut	Rôle
`url`	`CONTROL_BACKUP_URL`	`https://plateforme.inovertix.com/api/inobackup`	Base de l'API de dépôt
`key`	`CONTROL_BACKUP_KEY`	—	Clé `CTRLBK_…` créée dans CONTROL
`connection`	`CONTROL_BACKUP_CONNECTION`	connexion par défaut	Connexion Laravel à sauvegarder
`paths`	`CONTROL_BACKUP_PATHS`	vide	Chemins de fichiers à archiver en plus de la base (séparés par des virgules)
`exclude`	—	`node_modules, .git, vendor, *.log`	Motifs exclus de l'archive de fichiers
`tmp_path`	`CONTROL_BACKUP_TMP_PATH`	`storage/app/control-backup`	Dossier des dumps temporaires
`keep_local_days`	`CONTROL_BACKUP_KEEP_LOCAL_DAYS`	`0`	Rétention locale (0 = suppression immédiate)
`mysqldump_path`	`CONTROL_BACKUP_MYSQLDUMP`	`mysqldump`	Chemin du binaire si hors PATH
`dump_timeout` / `upload_timeout`	`CONTROL_BACKUP_DUMP_TIMEOUT` / `..._UPLOAD_TIMEOUT`	`1800`	Délais en secondes

Enregistrement dans le schedulerDans routes/console.php (Laravel 11/12) :

php

use Illuminate\Support\Facades\Schedule;

Schedule::command('control:backup')->dailyAt('02:00')->withoutOverlapping();

ou, pour un app/Console/Kernel.php (Laravel 10 et antérieurs) :

php

$schedule->command('control:backup')->dailyAt('02:00')->withoutOverlapping();

L'heure doit correspondre à la planification déclarée pour l'application côté CONTROL (sinon l'alerte « sauvegarde manquante » se déclenchera).Vérifiez que le cron système du scheduler tourne bien :

texte

* * * * * cd /chemin/vers/app && php artisan schedule:run >> /dev/null 2>&1

Utilisation manuelle

bash

php artisan control:backup                       # connexion par défaut
php artisan control:backup --connection=analytics
php artisan control:backup --keep                # garde le dump local après envoi

Codes de retour : 0 succès, 1 échec (message explicite sur la sortie d'erreur et dans storage/logs/laravel.log).Sauvegarder aussi des fichiers

env

CONTROL_BACKUP_PATHS=/var/www/monapp/storage/app/public,/var/www/monapp/.env

La commande dépose alors deux sauvegardes : le dump SQL (nature base de données) puis une archive .tar.gz des chemins (nature fichiers).

Attention

Les motifs de exclude s'appliquent à n'importe quel composant du chemin : ajouter cache exclurait aussi /home/cache-client/public_html en entier. Un tar sans aucune entrée étant un .tar.gz valide d'une quarantaine d'octets, la commande refuse d'envoyer une archive sans entrée et affiche leur nombre à chaque exécution — surveillez-le dans laravel.log.

Un chemin inexistant est signalé en avertissement et ignoré ; si aucun n'existe, la commande échoue.Pré-requis

PHP 8.2+, Laravel 11 ou 12, extension zlib (compression gzip à la volée).

Le binaire mysqldump doit être disponible (hébergement mutualisé : demander à l'hébergeur, ou utiliser integrations/inobackup.sh en cron si proc_open est bloqué).

Base MySQL ou MariaDB (les autres pilotes sont refusés avec un message clair).