[PaaS uniquement]{class="badge informative" title="S’applique uniquement aux projets Adobe Commerce on Cloud (infrastructure PaaS gérée par Adobe) et aux projets On-premise."}

Configurer le stockage distant

Le module de stockage étendu permet de stocker des fichiers multimédias et de planifier des imports et des 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 l’application. Cette approche n’est pas efficace pour les configurations complexes multi-serveurs et peut entraîner une dégradation des performances lors du partage de ressources. Grâce au module de stockage étendu, 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 distant afin de tirer parti du redimensionnement des images côté serveur.

Le stockage distant et le stockage dans la 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 distant.

bin/magento config:set system/media_storage_configuration/media_database 0

L’activation du stockage distant peut affecter votre expérience de développement. Par exemple, certaines fonctions de fichier PHP peuvent ne pas fonctionner comme prévu. L’utilisation du framework Commerce pour les opérations sur les fichiers doit être appliquée. La liste des fonctions natives PHP interdites est disponible dans le référentiel magento-coding-standard.

Options de stockage à distance

Vous pouvez configurer le stockage distant à 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>"

Le 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 distant :

Adaptateurs de stockage

L’emplacement de stockage par défaut est 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 n'importe où. Commerce prend en charge la configuration des services de stockage suivants :

Activer le stockage distant

Vous pouvez installer le stockage distant lors d’une installation d’Adobe Commerce ou ajouter du stockage distant à une instance Commerce existante. Les exemples suivants illustrent chaque méthode à l’aide d’un ensemble de paramètres remote-storage avec des commandes d’interface de ligne de commande Commerce setup. Vous devez au minimum fournir les driver, bucket et region de stockage.

Migration du contenu

Après avoir activé le stockage distant pour une carte spécifique, vous pouvez utiliser l'interface de ligne de commande pour migrer les fichiers media existants vers le stockage distant.

./magento2ce/bin/magento remote-storage:sync