URL de mídia quebrada

Existem várias razões pelas quais as imagens podem não ser exibidas corretamente na sua instalação do NexoPOS. Este guia descreve as principais etapas para ajudar você a identificar e resolver o problema.

O armazenamento não está vinculado a links simbólicos

Durante a instalação do NexoPOS, é possível que o link simbólico da sua loja não tenha sido criado. Como os arquivos de mídia são armazenados dentro do diretório de armazenamento, os envios podem ser concluídos com sucesso, mas aparecer como imagens quebradas.

Para resolver este problema, você precisa criar o link simbólico usando o seguinte comando:

php artisan storage:link

Valor incorreto de APP_URL

Ao editar o arquivo .env, pode ter se esquecido de adicionar o http:// ou o https:// como prefixo para o valor do APP_URL. Aqui vai um exemplo ruim do valor do APP_URL:

Aqui está como deveria ser em vez disso:

Link de Armazenamento Quebrado

Isso pode acontecer se você tiver movido arquivos recentemente. Observe que, na maioria das vezes, os links simbólicos são absolutos; ao alterar o local dos arquivos, o link já criado fica inválido.

Você tem duas opções para corrigir este problema:

Excluir link simbólico quebrado existente

Você precisará ir até a pasta “public” e, em seguida, excluir manualmente seu link simbólico (exclua o arquivo “storage” na pasta “public”).

Depois disso, você precisa criar um link para o armazenamento conforme explicado acima.

Usando um comando

Você pode executar um comando que irá reescrever o link simbólico existente:

php artisan storage:link --force

Permissões de Arquivos Inválidas

Se o link for criado, mas os arquivos/diretórios tiverem permissões inválidas, o NexoPOS não conseguirá acessar o armazenamento. Você precisa garantir que seus arquivos usem 644 como permissões e 755 para as pastas.

Pela CLI, altere o diretório para a raiz do NexoPOS e execute os seguintes comandos.

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

Seu usuário pode ter capacidade de executar esses comandos com "sudo".