(PHP 4 >= 4.0.3, PHP 5)
move_uploaded_file — Move um arquivo enviado para uma nova localização
$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.
filename
O nome do arquivo enviado.
destination
O destino do arquivo movido.
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.
Nota:
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 ondefilename
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.
Se o arquivo de destino já existir, ele será sobrescrito.