move_uploaded_file

(PHP 4 >= 4.0.3, PHP 5)

move_uploaded_file — Move um arquivo enviado para uma nova localização

Descrição

bool move_uploaded_file ( string $filename , string $destination )

Esta função verifica para ter certeza de que o arquivo designado por filename é um arquivo de upload válido (que tenha sido enviado pelo mecanismo PHP de envio por POST HTTP). Se o arquivo for válido, ele será movido para o nome de arquivo dado por destination.

Este tipo de verificação é especialmente imporante se existir alguma change que qualquer coisa feita com os arquivos enviados possa revelar seu conteúdo ao usuário, ou mesmo para outros usuários no memo sistema.

Parâmetros

filename

O nome do arquivo enviado.

destination

O destino do arquivo movido.

Valor Retornado

Se filename não for um arquivo enviado válido, então nenhuma ação ocorrerá e move_uploaded_file() retornará FALSE.

Se filename for um arquivo enviado válido, mas não puder ser movido por alguma razão, nenhuma ação ocorrerá e move_uploaded_file() retornará FALSE. Adicionalmente, um alerta será emitido.

Notas

Note:

move_uploaded_file() é afetado tanto por safe mode quanto por open_basedir. Entretanto, restrições são aplicadas apenas no caminho de destination para permitir que arquivos onde filename venha a conflitar com tais restrições possam ser movidos. move_uploaded_file() assegura a segurança desta operação permitindo que apenas arquivos carregados pelo PHP possam ser movidos.

Warning

Se o arquivo de destino já existir, ele será sobrescrito.

Veja Também