(PHP 4 >= 4.0.3, PHP 5)
move_uploaded_file — Verschiebt eine hochgeladene Datei an einen neuen Ort
$filename
, string $destination
)
Diese Funktion prüft, ob die mit filename
bezeichnete Datei eine gültige Upload-Datei ist (d.h., dass sie
mittels PHP's HTTP POST Upload-Mechanismus upgeloaded wurde).
Ist die Datei gültig, wird sie zum in
destination bezeichneten Dateinamen
verschoben.
Wenn filename keine gültige Datei ist, wird
keine Aktion ausgeführt, und
move_uploaded_file() gibt
FALSE zurück.
Wenn filename eine gültige Datei ist, jedoch
aus irgendeinem Grund nicht verschoben werden kann, wird keine
Aktion ausgeführt, und move_uploaded_file()
gibt FALSE zurück. Zusätzlich wird eine Warnung
ausgegeben.
Diese Prüfung ist speziell dort interessant, wo irgendeine Aktion mit upgeloadeten Dateien deren Inhalt dem User zugänglich machen könnte (oder auch anderen Usern auf dem selben System).
Hinweis: Wenn Safe Mode aktiviert ist, überprüft PHP, ob die Dateien/Verzeichnisse, die mit dem Skript bearbeitet werden sollen, die gleiche UID (Eigentümer) haben wie das Skript selbst.
Hinweis:
move_uploaded_file() ist von den normalen Safe Mode UID-Einschränkungen nicht betroffen. Dies ist nicht unsicher, da move_uploaded_file() nur mit via PHP hochgeladenen Dateien arbeitet.
Sollte die Zieldatei bereits existieren, wird sie überschrieben.
Siehe auch is_uploaded_file(), und das Kapitel Steuerung von Dateiuploads für ein einfaches Anwendungsbeispiel.