URL de medios rota

Hay varias razones por las que las imágenes pueden no mostrarse correctamente en tu instalación de NexoPOS. Esta guía describe los pasos clave para ayudarte a identificar y resolver el problema.

El almacenamiento no está vinculado con enlaces simbólicos

Durante la instalación de NexoPOS, es posible que no se haya creado el enlace simbólico de tu tienda. Dado que los archivos multimedia se almacenan dentro del directorio de almacenamiento, las cargas pueden completarse correctamente, pero aparecer como imágenes rotas.

Para resolver este problema, necesitas crear el enlace simbólico usando el siguiente comando:

php artisan storage:link

Valor incorrecto de APP_URL

Al editar el archivo .env, es posible que hayas olvidado agregar ya sea http:// o https:// como prefijo para tu valor de APP_URL. Aquí tienes un mal ejemplo del valor de APP_URL:

Así es como debería verse en su lugar:

Enlace de almacenamiento roto

Esto puede ocurrir si recientemente moviste archivos. Ten en cuenta que, la mayoría de las veces, los enlaces simbólicos son absolutos; al cambiar la ubicación de los archivos, el enlace ya creado queda invalidado.

Tienes dos opciones para solucionar este problema:

Eliminar el enlace simbólico roto existente

Necesitarás ir a la carpeta «public» y luego eliminar manualmente tu enlace simbólico (elimina el archivo «storage» en la carpeta «public»).

Luego, después de eso, necesitas crear un enlace al almacenamiento como se explicó anteriormente.

Usando un comando

Puedes ejecutar un comando que reescribirá el enlace simbólico existente:

php artisan storage:link --force

Permisos de archivos no válidos

Si se crea el enlace, pero los archivos o directorios tienen permisos no válidos, NexoPOS no podrá acceder al almacenamiento. Debes asegurarte de que tus archivos usen 644 como permisos y 755 para las carpetas.

Desde la CLI, cambia el directorio a la raíz de NexoPOS y ejecuta los siguientes comandos.

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

Es posible que tu usuario tenga capacidad de «sudo» para ejecutar esos comandos.