Configuration du stockage distant
Le module Stockage distant offre la possibilité de stocker des fichiers multimédias et de planifier les imports et exports dans un conteneur de stockage distant persistant à l’aide d’un service de stockage, tel qu’AWS S3.
Par défaut, l’application Adobe Commerce stocke les fichiers multimédias dans le même système de fichiers que celui qui contient l’application. Cela n’est pas efficace pour les configurations multi-serveurs complexes et peut entraîner une dégradation des performances lors du partage des ressources. Avec le module de stockage distant, vous pouvez stocker des fichiers multimédias dans le répertoire pub/media
et importer/exporter des fichiers dans le répertoire var
du stockage d’objets distants afin de tirer parti du redimensionnement d’image côté serveur.
Le stockage à distance et le stockage de base de données ne peuvent pas être activés en même temps. Vous devez désactiver le stockage de la base de données avant d’activer le stockage à distance.
bin/magento config:set system/media_storage_configuration/media_database 0
L’activation du stockage à distance peut affecter votre expérience de développement établie. Par exemple, certaines fonctions de fichier PHP peuvent ne pas fonctionner comme prévu. L’utilisation de Commerce Framework pour les opérations de fichier doit être appliquée. La liste des fonctions natives PHP interdites est disponible dans le référentiel magento-coding-standard .
-
Le stockage à distance n’est disponible que pour Commerce version 2.4.2 et ultérieure. Voir les notes de mise à jour 2.4.2.
-
Le module de stockage à distance prend en charge limitée dans Adobe Commerce sur l’infrastructure cloud. Adobe ne peut pas résoudre entièrement les problèmes liés au service d’adaptateur de stockage tiers. Voir Configuration de l’espace de stockage distant pour Commerce sur l’infrastructure cloud pour obtenir des conseils sur l’implémentation de l’espace de stockage distant pour les projets cloud.
Options de stockage distant
Vous pouvez configurer le stockage à distance à l’aide de l’option remote-storage
avec la commande setup
CLI. L’option remote-storage
utilise la syntaxe suivante :
--remote-storage-<parameter-name>="<parameter-value>"
parameter-name
fait référence au nom du paramètre de stockage distant spécifique. Le tableau suivant répertorie les paramètres disponibles pour la configuration du stockage à distance :
remote-storage-driver
Valeurs possibles :
file : désactive le stockage distant et utilise le système de fichiers local
aws-s3 : utilisez le service de stockage simple Amazon (Amazon S3)
remote-storage-bucket
remote-storage-prefix
remote-storage-region
remote-storage-key
remote-storage-secret
Adaptateurs de stockage
L’emplacement de stockage par défaut se trouve dans le système de fichiers local. Un adaptateur de stockage vous permet de vous connecter à un service de stockage et de stocker vos fichiers où que vous soyez. Commerce prend en charge la configuration des services de stockage suivants :
Activer le stockage à distance
Vous pouvez installer un stockage distant lors d’une installation Adobe Commerce ou ajouter un stockage distant à une instance Commerce existante. Les exemples suivants montrent chaque méthode utilisant un ensemble de paramètres remote-storage
avec des commandes d’interface de ligne de commande Commerce setup
. Au minimum, vous devez fournir le stockage driver
, bucket
et region
.
-
Exemple : installation de Commerce avec stockage à distance
code language-bash bin/magento setup:install --remote-storage-driver="aws-s3" --remote-storage-bucket="myBucket" --remote-storage-region="us-east-1"
-
Exemple : activer le stockage à distance sur Commerce existant
code language-bash bin/magento setup:config:set --remote-storage-driver="aws-s3" --remote-storage-bucket="myBucket" --remote-storage-region="us-east-1"
Migration de contenu
Après avoir activé le stockage à distance pour un adaptateur spécifique, vous pouvez utiliser l’interface de ligne de commande pour migrer les fichiers media existants vers le stockage à distance.
./magento2ce/bin/magento remote-storage:sync
pub/media
, et non les fichiers d'import/export dans le répertoire var
. Voir Import/Export planifié dans le Guide de l’utilisateur de Commerce 2.4.