Manual do PHP
Anterior |  | Próxima

# move_uploaded_file

(PHP 4 >= 4.0.3, PHP 5)

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

## Descrição

bool move_uploaded_file ( string nomedoarquivo, string destino )

Esta função primeiro checa o arquivo informado `nomedoarquivo` é um arquivo válido uploadeado (significando que ele foi carregado 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 carregado válido, então não haverá nenhuma ação e move_uploaded_file() irá retornar `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á emitido.

Este tipo de confirmação é importante principalmente se existe alguma chance que qualquer coisa feita com os arquivos carregados poderem 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 (proprietário) do script que está sendo executado.

> Nota: move_uploaded_file() não é afetado pelas restrições de UIN normais do safe mode. Isto não é inseguro porque move_uploaded_file() somente opera sobre arquivos carregados pelo PHP.

Atenção
Se o arquivo destino já existir, então ele será sobrescrito.

Veja também is_uploaded_file() e a seção Manipulando o upload de arquivos para um exemplo de utilização desta função.

Anterior | Principal | Próxima
mkdir | Acima | parse_ini_file