(PHP 4 >= 4.0.3, PHP 5)
move_uploaded_file — 将上传的文件移动到新位置
$filename
, string $destination
)
本函数检查并确保由 filename
指定的文件是合法的上传文件（即通过 PHP 的 HTTP POST
上传机制所上传的）。如果文件合法，则将其移动为由
destination 指定的文件。
如果 filename
不是合法的上传文件，不会出现任何操作， move_uploaded_file()
将返回 FALSE。
如果 filename
是合法的上传文件，但出于某些原因无法移动，不会出现任何操作， move_uploaded_file()
将返回 FALSE。此外还会发出一条警告。
这种检查显得格外重要，如果上传的文件有可能会造成对用户或本系统的其他用户显示其内容的话。
Note:
move_uploaded_file() 对安全模式和 open_basedir 都是敏感的。不过，限制只针对
destination路径，因为允许移动上传的文件名filename可能会与这些限制产生冲突。 move_uploaded_file() 仅作用于通过 PHP 上传的文件以确保这个操作的安全性。
如果目标文件已经存在，将会被覆盖。
参见 is_uploaded_file()，以及文件上传处理一章中的简单使用例子。
filename
The filename of the uploaded file.
destination
The destination of the moved file.
Returns TRUE on success.
If filename is not a valid upload file,
then no action will occur, and
move_uploaded_file() will return
FALSE.
If filename is a valid upload file, but
cannot be moved for some reason, no action will occur, and
move_uploaded_file() will return
FALSE. Additionally, a warning will be issued.
Example #1 Uploading multiple files
<?php
$uploads_dir = '/uploads';
foreach ($_FILES["pictures"]["error"] as $key => $error) {
if ($error == UPLOAD_ERR_OK) {
$tmp_name = $_FILES["pictures"]["tmp_name"][$key];
$name = $_FILES["pictures"]["name"][$key];
move_uploaded_file($tmp_name, "$uploads_dir/$name");
}
}
?>
Note:
move_uploaded_file() is both 安全模式 and open_basedir aware. However, restrictions are placed only on the
destinationpath as to allow the moving of uploaded files in whichfilenamemay conflict with such restrictions. move_uploaded_file() ensures the safety of this operation by allowing only those files uploaded through PHP to be moved.
If the destination file already exists, it will be overwritten.