(PHP 4 >= 4.0.3, PHP 5)
move_uploaded_file — Przenieś uploadowany plik do innej lokalizacji
Funkcja ta sprawdza czy na pewno plik określony przez nazwa_pliku jest prawidło uploadowanym plikiem (to znaczy, że został uploadowany przez PHPowy mechanizm uploadowania HTTP POST). Jeśli plik jest prawidłowy, to zostanie przeniesiony do nazwy pliku wskazanej przez przeznaczenie .
Jeśli nazwa_pliku nie jest prawidło uploadowanym plikiem, to żadna akcja nie zostanie wykonana i move_uploaded_file() zwróci FALSE.
Jeśli nazwa_pliku jest prawidłowo uploadowanym plikiem, ale nie może zostać przeniesiony z jakiś powodów, żadna akcja nie zostanie wykonana i move_uploaded_file() zwróci FALSE. Dodatkowo, zostanie pokazane ostrzeżenie.
Ten rodzaj testów jest szczególnie ważny jeśli istnieje szansa, że cokolwiek robimy z przysłanymi plikami może zdradzić ich treść użytkownikowi lub nawet innym użytkownikom tego samego systemu.
Informacja: Funkcja move_uploaded_file() jest świadoma tryb bezpieczny oraz open_basedir. Jednak, ograniczenia nałożone są tylko na ścieżkę przeznaczenie , ponieważ pozwala na przenoszenie uploadowanych plików w których nazwa_pliku może kolidować z takimi ograniczeniami. move_uploaded_file() zapewnia bezpieczeństwo tej operacji poprzez zezwolenie na przeniesienie tylko tych plików, które były uploadowane przez PHP.
Jeśli już istnieje plik docelowy, to zostanie on nadpisany.
Patrz także: is_uploaded_file() i rozdział Obsługa uploadowanych plików w celu uzyskania prostych przykładów użycia tej funkcji.