URL de média cassée

Il existe plusieurs raisons pour lesquelles les images peuvent ne pas s’afficher correctement sur votre installation NexoPOS. Ce guide présente les étapes clés pour vous aider à identifier et à résoudre le problème.

Le stockage n’est pas lié aux liens symboliques

Lors de l’installation de NexoPOS, il est possible que le lien symbolique de votre boutique n’ait pas été créé. Comme les fichiers multimédias sont stockés dans le répertoire de stockage, les téléversements peuvent se terminer correctement, mais apparaître comme des images cassées.

Pour résoudre ce problème, vous devez créer le lien symbolique à l’aide de la commande suivante :

php artisan storage:link

Valeur APP_URL incorrecte

En modifiant le fichier .env, il est possible que vous ayez oublié d’ajouter soit http:// soit https:// comme préfixe à la valeur de votre APP_URL. Voici un mauvais exemple de valeur pour APP_URL :

Voici à quoi cela devrait ressembler à la place :

Lien de stockage rompu

Cela peut se produire si vous avez récemment déplacé des fichiers. Notez que, la plupart du temps, les liens symboliques sont absolus ; le changement d’emplacement des fichiers rend le lien déjà créé invalide.

Vous avez deux options pour résoudre ce problème :

Supprimer le lien symbolique rompu existant

Vous devrez vous rendre dans le dossier « public », puis supprimer manuellement votre lien symbolique (supprimez le fichier « storage » dans le dossier « public »).

Ensuite, vous devez créer un lien vers le stockage comme expliqué ci-dessus.

En utilisant une commande

Vous pouvez exécuter une commande qui réécrira le lien symbolique existant :

php artisan storage:link --force

Autorisations de fichiers invalides

Si le lien est créé, mais que les fichiers/dossiers disposent de permissions non valides, NexoPOS ne pourra pas accéder au stockage. Vous devez vous assurer que vos fichiers utilisent 644 comme permissions et 755 pour les dossiers.

Depuis la ligne de commande, accédez au répertoire racine de NexoPOS et exécutez les commandes suivantes.

find -type d -exec chmod 755 {} \;
find -type f -exec chmod 644 {} \;

Votre utilisateur peut avoir la capacité « sudo » pour exécuter ces commandes.