Documentation Commerce Guide de configuration

Autorisations d’accès aux systèmes de fichiers

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

Expérimenté
Administration
Développeur

Cette section explique comment configurer le propriétaire ou les propriétaires du système de fichiers Commerce pour un système de développement et de production. Avant de poursuivre, passez en revue les concepts abordés dans Présentation de la propriété et des autorisations du système de fichiers.

Cette rubrique porte sur les systèmes de développement et de production Commerce. Si vous installez Commerce, reportez-vous à la section Définition de la propriété et des autorisations de pré-installation.

Les sections suivantes abordent les exigences relatives à un ou deux propriétaires de système de fichiers. Cela signifie :

Un utilisateur : généralement nécessaire sur les fournisseurs d’hébergement partagés, qui vous permettent d’accéder à un seul utilisateur sur le serveur. Cet utilisateur peut se connecter, transférer des fichiers par FTP et exécuter également le serveur web.
Deux utilisateurs : nous recommandons deux utilisateurs si vous exécutez votre propre serveur Commerce : un pour transférer des fichiers et exécuter des utilitaires de ligne de commande, ainsi qu’un utilisateur distinct pour le logiciel du serveur web. Dans la mesure du possible, cette option est préférable, car elle est plus sécurisée.

Vous disposez à la place d’utilisateurs distincts :
- Utilisateur du serveur web, qui exécute l’administrateur et le storefront.
- Un utilisateur de ligne de commande, qui est un compte utilisateur local que vous pouvez utiliser pour vous connecter au serveur. Cet utilisateur exécute les tâches Commerce cron et les utilitaires de ligne de commande.

Propriété du système de fichiers de production pour l’hébergement partagé (un utilisateur)

Pour utiliser la configuration propriétaire unique, vous devez vous connecter à votre serveur Commerce en tant qu’utilisateur exécutant le serveur web. Cela est typique pour l’hébergement partagé.

Etant donné que le propriétaire d’un système de fichiers est moins sécurisé, nous vous recommandons de déployer Commerce en production sur un serveur privé plutôt que sur l’hébergement partagé, si possible.

Configuration d’un propriétaire pour le mode par défaut ou développeur

En mode développeur ou par défaut, les répertoires suivants doivent pouvoir être écrits par l’utilisateur :

vendor
app/etc
pub/static
var
Toute autre ressource statique
generated/code
generated/metadata
var/view_preprocessed

Vous pouvez définir ces autorisations à l’aide de la ligne de commande ou d’une application de gestionnaire de fichiers fournie par votre fournisseur d’hébergement partagé.

Configurer un propriétaire pour le mode de production

Lorsque vous êtes prêt à déployer votre site en production, vous devez supprimer l’accès en écriture des fichiers dans les répertoires suivants afin d’améliorer la sécurité :

vendor
app/code
app/etc
pub/static
Toute autre ressource statique
generated/code
generated/metadata
var/view_preprocessed

Pour mettre à jour des composants, installer de nouveaux composants ou mettre à niveau le logiciel Commerce, tous les répertoires précédents doivent être en lecture-écriture.

Lecture seule des fichiers et répertoires de code

Pour supprimer les autorisations d’écriture sur les fichiers et répertoires du groupe d’utilisateurs du serveur web :

Connectez-vous à votre serveur Commerce.
Accédez au répertoire d’installation de Commerce.

Passez en mode de production.

code language-bash
`bin/magento deploy:mode:set production`

Supprimez les autorisations d’écriture pour les répertoires suivants.

code language-bash
`find app/code var/view_preprocessed vendor pub/static app/etc generated/code generated/metadata \( -type f -or -type d \) -exec chmod u-w {} + && chmod o-rwx app/etc/env.php`

Rendez l’outil de ligne de commande exécutable.

code language-bash
`chmod u+x bin/magento`

Rendre les fichiers de code et les répertoires accessibles en écriture

Pour rendre les fichiers et répertoires accessibles en écriture afin de pouvoir mettre à jour les composants et mettre à niveau le logiciel Commerce :

Connectez-vous à votre serveur Commerce.
Accédez au répertoire d’installation de Commerce.

Saisissez les commandes suivantes :

code language-bash
`chmod -R u+w .`

Éventuellement défini `magento_umask`

Voir Éventuellement, définir une tâche dans le Guide d'installation.

Propriété du système de fichiers de production pour l’hébergement privé (deux utilisateurs)

Si vous utilisez votre propre serveur (y compris la configuration du serveur privé d’un fournisseur d’hébergement), il y a deux utilisateurs :

utilisateur du serveur web, qui exécute l’administrateur et le storefront.

Les systèmes Linux ne fournissent généralement pas d’interpréteur de commandes à cet utilisateur ; vous ne pouvez pas vous connecter au serveur Commerce en tant qu’utilisateur du serveur Web, ni le basculer vers ce serveur.

utilisateur de ligne de commande, auquel vous vous connectez à votre serveur Commerce ou vers lequel vous basculez.

Commerce utilise cet utilisateur pour exécuter les commandes de l’interface de ligne de commande et cron.

note info
INFO
L’utilisateur de ligne de commande est également appelé propriétaire du système de fichiers.

Comme ces utilisateurs ont besoin d'un accès aux mêmes fichiers, nous vous recommandons de créer un groupe partagé auquel ils appartiennent tous les deux. Les procédures suivantes supposent que vous avez déjà fait cela.

Consultez l’une des sections suivantes :

Deux propriétaires de système de fichiers en mode Développeur ou par défaut
Deux propriétaires de système de fichiers en mode de production

Configuration de deux propriétaires pour le mode par défaut ou développeur

Les fichiers des répertoires suivants doivent pouvoir être écrits par les utilisateurs en mode développeur et par défaut :

var
generated
pub/static
pub/media
app/etc

Définissez le bit setgid sur les répertoires afin que les autorisations héritent toujours du répertoire parent.

INFO

setgid s’applique uniquement aux répertoires, et non aux fichiers.

En outre, les répertoires doivent pouvoir être écrits par le groupe de serveurs web. Comme le contenu peut exister dans ces répertoires, ajoutez les autorisations de manière récursive.

Définissez des autorisations et `setgid`

Pour définir setgid et les autorisations pour le mode Développeur :

Connectez-vous à votre serveur Commerce en tant que propriétaire du système de fichiers ou passez à .

Saisissez les commandes suivantes dans l’ordre indiqué :

code language-bash
`cd <magento_root>`

code language-bash
`find var generated pub/static pub/media app/etc -type f -exec chmod g+w {} +`

code language-bash
`find var generated pub/static pub/media app/etc -type d -exec chmod g+ws {} +`

Deux propriétaires de système de fichiers en mode de production

Lorsque vous êtes prêt à déployer votre site en production, vous devez supprimer l’accès en écriture des fichiers dans les répertoires suivants afin d’améliorer la sécurité :

vendor
app/code
app/etc
lib
pub/static
Toute autre ressource statique
generated/code
generated/metadata
var/view_preprocessed

Lecture seule des fichiers et répertoires de code

Pour supprimer les autorisations d’écriture sur les fichiers et répertoires du groupe d’utilisateurs du serveur web :

Connectez-vous à votre serveur Commerce.
Accédez au répertoire d’installation de Commerce.

En tant que propriétaire du système de fichiers, saisissez la commande suivante pour passer en mode de production :

code language-bash
`bin/magento deploy:mode:set production`

Saisissez la commande suivante en tant qu’utilisateur disposant des privilèges root :

code language-bash
`find app/code lib pub/static app/etc generated/code generated/metadata var/view_preprocessed \( -type d -or -type f \) -exec chmod g-w {} + && chmod o-rwx app/etc/env.php`

Rendre les fichiers de code et les répertoires accessibles en écriture

Pour rendre les fichiers et répertoires accessibles en écriture afin de pouvoir mettre à jour les composants et mettre à niveau le logiciel Commerce :

Connectez-vous à votre serveur Commerce.
Accédez au répertoire d’installation de Commerce.

Saisissez la commande suivante :

code language-bash
`find app/code lib var generated vendor pub/static pub/media app/etc \( -type d -or -type f \) -exec chmod g+w {} + && chmod o+rwx app/etc/env.php`

recommendation-more-help

386822bd-e32c-40a8-81c2-ed90ad1e198c

Autorisations d’accès aux systèmes de fichiers

Propriété du système de fichiers de production pour l’hébergement partagé (un utilisateur)

Configuration d’un propriétaire pour le mode par défaut ou développeur

Configurer un propriétaire pour le mode de production

Lecture seule des fichiers et répertoires de code

Rendre les fichiers de code et les répertoires accessibles en écriture

Éventuellement défini magento_umask

Propriété du système de fichiers de production pour l’hébergement privé (deux utilisateurs)

Configuration de deux propriétaires pour le mode par défaut ou développeur

Définissez des autorisations et setgid

Deux propriétaires de système de fichiers en mode de production

Lecture seule des fichiers et répertoires de code

Rendre les fichiers de code et les répertoires accessibles en écriture

Éventuellement défini `magento_umask`

Définissez des autorisations et `setgid`