move_uploaded_file

(PHP 4 >= 4.0.3)

move_uploaded_file -- Move um arquivo uploadeado para uma nova localização

Descrição

bool move_uploaded_file ( string nomedoarquivo, string destino)

Esta função está disponível somente em versões do PHP 3 depois da 3.0.16, e em versões do PHP 4 depois da 4.0.2.

Esta função checa para ter certeza que o arquivo designado por nomedoarquivo é um arquivo válido uploadeado (significando que ele foi uploadeado pelo mecanismo do PHP de HTTP POST). Se o arquivo é válido, ele será movido para o nomedoarquivo dado pelo destino.

Se nomedoarquivo não é um arquivo uploadeado válido, então não haverá nenhuma ação e move_uploaded_file() irá retornar FALSE. FALSE.

Se nomedoarquivo é um arquivo uploadeado válido e não pode ser movido por alguma razão, nenhuma ação irá ocorrer, e move_uploaded_file() irá retornar FALSE. Adicionalmente, um aviso será transmitido.

Este tipo de confirmação é importante principalmente se existe alguma chance que qualquer coisa feita com os arquivos uploadeados poderiam revelar o seu conteúdo para o usuário, ou mesmo para outros usuários no mesmo sistema.

Nota: Quando o safe-mode está ativo, o PHP verifica se o(s) arquivo(s) e/ou diretório(s) que serão afetados por esta operação tem o mesmo UID do script que está sendo executado.

Veja também is_uploaded_file(), e a seção Handling file uploads para um simples exemplo de utilização desta função.