Erro de permissão em pastas PHP: como resolver (chmod 755, 775, 777)
O erro de permissão em pastas PHP é um dos problemas mais comuns em servidores Linux, principalmente ao trabalhar com upload de arquivos, logs, cache ou sistemas PHP puro.
Esse tipo de erro normalmente gera mensagens como 403 Forbidden, falha no upload ou até 500 Internal Server Error.
Se você também enfrenta problemas de acesso ou upload, veja estes guias:
- Como resolver erro 403 Forbidden em sites PHP
- Erro ao fazer upload de arquivos em PHP
- Como resolver erro 500 e 404 em sites PHP
O que são permissões de pastas no Linux
Em servidores Linux, cada arquivo ou pasta possui permissões que definem quem pode ler, escrever ou executar.
Essas permissões são controladas por números como 755, 775 ou 777.
Entendendo chmod 755, 775 e 777
| Permissão | Significado | Uso recomendado |
|---|---|---|
| 755 | Leitura e execução para todos, escrita apenas para o dono | Padrão para pastas |
| 775 | Leitura e escrita para dono e grupo | Upload e cache |
| 777 | Leitura e escrita para todos | Evitar (inseguro) |
Principais causas de erro de permissão em PHP
Pasta sem permissão de escrita
O PHP não consegue salvar arquivos se a pasta não permitir escrita.
---Usuário do servidor diferente do dono da pasta
Em muitas hospedagens, o usuário do Apache ou PHP-FPM não é o mesmo que o dono dos arquivos.
---Permissões alteradas incorretamente
Um chmod errado pode bloquear totalmente o acesso ao sistema.
Como identificar erro de permissão em PHP
Mensagens comuns de erro
- Permission denied
- Failed to open stream
- 403 Forbidden
Testar escrita manualmente
file_put_contents('teste.txt', 'teste');Se falhar, o problema é permissão.
---Como corrigir erro de permissão em pastas PHP
Ajustar permissões via chmod
chmod 755 pasta
chmod 775 pasta_uploadEvitar uso de chmod 777
Apesar de funcionar, o 777 deixa o servidor vulnerável
e deve ser usado apenas para testes.
Conferir dono da pasta (chown)
chown -R www-data:www-data pastaO usuário pode variar conforme a hospedagem.
---Relação entre permissão, erro 403 e upload
Pastas sem permissão adequada podem causar:
- Erro 403 Forbidden
- Falha no upload de arquivos
- Erro 500 em scripts PHP
Por isso, é importante sempre revisar permissões ao resolver esses erros.
---Boas práticas de permissões em PHP
- Usar 755 como padrão
- Usar 775 apenas quando necessário
- Evitar 777 em produção
- Manter pastas de upload separadas
- Revisar permissões após deploy
Conclusão
Erros de permissão em pastas PHP são comuns, mas fáceis de resolver quando se entende como o sistema de permissões funciona.
Com ajustes corretos de chmod e boas práticas de segurança,
é possível evitar falhas de acesso, upload e erros críticos no servidor.