move_uploaded_file
(PHP 4 >= 4.0.3, PHP 5, PHP 7, PHP 8)
move_uploaded_file — Переміщує завантажений файл у нове місце
Опис
move_uploaded_file(string $from, string $to): bool
Ця функція перевіряє, чи є файл from
завантаженим на сервер (переданим за протоколом HTTP POST). Якщо файл дійсно завантажений на сервер, він буде переміщений до місця, вказаного в аргументі to
Така перевірка особливо важлива в тому випадку, якщо існує шанс того, що будь-які дії, які виконуються над завантаженим файлом, можуть відкрити його вміст користувачеві або навіть іншим користувачам системи.
Список параметрів
from
Шлях до завантаженого файлу.
to
Шлях, яким необхідно перемістити файл.
Значення, що повертаються
У разі успішного виконання повертає true
Якщо from
не є завантаженим файлом, ніяких дій не вживається і move_uploaded_file() повертає false
Якщо from
є завантаженим файлом, але не може бути переміщений з будь-яких причин, ніяких дій не вживається і move_uploaded_file() повертає false
. Крім того, відображається попередження.
Приклади
Приклад #1 Завантаження кількох файлів
Loading...
Примітки
Зауваження :
Функцияmove_uploaded_file() бере до уваги open_basedir. Тим не менш, обмеження накладаються лише на параметр
to
, щоб дозволити переміщення завантажених файлів, оскільки параметрfrom
може конфліктувати з цими обмеженнями . move_uploaded_file() гарантує безпеку цієї операції, працюючи лише з тими файлами, завантаженими через PHP.
Увага
Якщо результуючий файл вже існує, його буде перезаписано.
Дивіться також
- is_uploaded_file() - Визначає, чи файл завантажений за допомогою HTTP POST
- rename() - Перейменовує файл або директорію
- Простий приклад використання цієї функції можна знайти у розділі "Завантаження файлів на сервер"