O envio de arquivos falha com “failed to open stream” ou move_uploaded_file: as causas, por ordem

PHP e ProgramaçãoErros e logs do PHP·· 1.743 visualizações· 4 min de leitura

O arquivo chega ao servidor, o PHP guarda-o numa pasta temporária e o seu código tenta mudá-lo para o lugar definitivo com move_uploaded_file(). Se esse passo falha, o aviso é “failed to open stream: Permission denied”, “No such file or directory” ou “Unable to move”. Não é um problema de tamanho (para isso há enviar arquivos grandes em PHP), é de caminho, permissões ou espaço. Há uma maneira de ver a causa: o código de erro do $_FILES.

Ler o código de erro do envio

Antes de mover o arquivo, o PHP deixa em $_FILES['campo']['error'] um número. Imprima-o numa página de ensaio, ou escreva-o no log de erros.

Código Significa O que fazer
0 O envio deu certo. Se mesmo assim falha, o problema é o passo seguinte: mover o arquivo.
1 Maior do que o limite do PHP. Veja upload_max_filesize e post_max_size.
2 Maior do que o limite do próprio formulário. Procure um campo MAX_FILE_SIZE escondido no formulário.
3 Só chegou uma parte. Conexão cortada. Tente outra vez, com uma rede melhor.
4 Nenhum arquivo enviado. Veja se o formulário tem enctype="multipart/form-data". Sem isso o $_FILES chega vazio.
6 Falta a pasta temporária. Peça-nos ajuda: é do servidor.
7 Não conseguiu escrever no disco. Pode ser o espaço da conta esgotado. Veja o contador no cPanel.
8 Uma extensão do PHP parou o envio. Peça-nos ajuda com o endereço e a hora.

Se o código é 0 e mover falha

1 A pasta de destino existe? “No such file or directory” é quase sempre um caminho errado. Um caminho relativo muda consoante o arquivo que o chama. Prefira um caminho completo, construído a partir de __DIR__.
2 A pasta aceita escrita? Em geral a pasta deve pertencer à sua conta e ter permissão 755 (e os arquivos 644). “Permission denied” numa pasta que criou há pouco, ou que foi criada por outro usuário (num VPS, o root), é a causa mais comum. Veja erro 403: permissões, .htaccess e IPs bloqueados. Não ponha 777 por desespero.
3 O espaço acabou? O disco da conta cheio, ou o limite de arquivos (inodes), faz a escrita falhar. Veja os limites de que ninguém fala.
4 O nome do arquivo tem caracteres difíceis? Espaços, acentos ou o nome vazio dão problemas. Gere o seu próprio nome (uma sequência aleatória mais a extensão) em vez de usar o que o usuário enviou.
5 Leia o log de erros: ele traz o caminho exato que falhou. Veja onde está o log de erros do PHP.
Cuidado com o que permite enviar. Se a pasta de destino está dentro do site e o usuário pode enviar um arquivo .php, quem o enviar corre código no seu servidor. Aceite só os tipos de que precisa, confira o tipo pelo conteúdo (e não só pela extensão), renomeie o arquivo e, se puder, guarde-o fora da pasta pública.
Em WordPress o erro aparece como “HTTP error” ou “Não foi possível mover o arquivo”. Veja aumentar o limite de envio do WordPress. Se o envio é muito grande ou frequente, use o SFTP: veja SFTP em vez de FTP.

Já viu o código de erro e o caminho e ainda falha? Envie-nos a mensagem completa e o endereço da página.

Abrir um pedido de suporte

VEJA TAMBÉM

Enviar arquivos grandes em PHP: upload_max_filesize e post_max_size

Erro 403: permissões, .htaccess e IPs bloqueados

Onde está o log de erros do PHP

Os limites de que ninguém fala: inodes, processos e memória

PRODUTO RECOMENDADO

Hospedagem de sites com cPanel

Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde R$ 36,30/mês (plano de 3 anos, com cupom)

Ver planos
Esta resposta foi útil? Sua resposta nos ajuda a melhorar este artigo.

Artigos Relacionados

Erros e logs do PHP 1.013 Página em branco no PHP: como ver o erro Uma página branca quer dizer que o PHP deu um erro fatal e está configurado para não o mostrar. É a configuração certa p...
Erros e logs do PHP 1.136 Acentos que viram símbolos estranhos no site: UTF-8 do arquivo ao banco de dados A resposta curta: «ação» aparece como «ação», ou como «a��o», ou como «a?o». É sempre o mesmo problema: o texto foi es...
Erros e logs do PHP 896 “Cannot modify header information, headers already sent”: como achar a linha que o causou A mensagem completa é “Warning: Cannot modify header information - headers already sent by (output started at /caminho/a...
Erros e logs do PHP 1.033 Erros depois de passar para o PHP 8: undefined array key, parâmetros nulos e propriedades dinâmicas Passou o site para o PHP 8 e aparecem mensagens novas. Quase todas vêm do mesmo lugar: o PHP 8 ficou menos tolerante com...
Erros e logs do PHP 1.040 Corrigir “Allowed memory size exhausted” A mensagem completa diz “Allowed memory size of … bytes exhausted (tried to allocate … bytes)”. Significa que um único p...
Erros e logs do PHP 1.234 Escrever o seu próprio registro em PHP: error_log e um arquivo que consiga ler Quando uma coisa falha só em produção, o melhor aliado é um registro que o próprio código escreve: uma linha com a hora,...