mkdir

(PHP 4, PHP 5, PHP 7, PHP 8)

mkdir - Створює директорію

Опис

mkdir(    string $directory,    int $permissions = 0777,    bool $recursive = false,    ?resource $context = null): bool

Намагається створити директорію, задану в directory

Список параметрів

directory

Шлях до директорії.

Підказка

У цю функцію як ім'я файлу можна передавати URL-адреси, якщо була включена директива fopen wrappers. Докладніше про те, як вказати ім'я файлу, описано в описі функції fopen(). В розділі "Підтримувані протоколи та обгортки» також дано посилання на інформацію про можливості підтримуваних обгорток, зауваження щодо роботи з ними та список визначених змінних, які вони дають.

permissions

За замовчуванням набуває значення 0777, що означає найширші права. Більше інформації про права доступу можна дізнатися на сторінці посібника функції chmod()

Зауваження :

Аргументpermissions ігнорується у Windows.

Обратите внимание, что аргументpermissions необхідно задавати у вигляді восьмеричного числа (першою цифрою має бути нуль). На аргумент permissions також впливає поточне значення umask, яке можна змінити за допомогою umask()

recursive

Если указано значение**true**, то всі батьківські каталоги для вказаного параметра directory також буде створено, з тими ж дозволами.

context

Ресурс (resource) сконтекстом потоку

Значення, що повертаються

Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.

Зауваження :

Якщо каталог, що створюється, вже існує, це вважається помилкою і буде повернено значення **false**Используйте функциюis_dir() або file_exists(), щоб перевірити, чи існує каталог, перш ніж намагатися його створити.

Помилки

Видає помилку рівня **E_WARNING**якщо директорія вже існує.

Видає помилку рівня **E_WARNING**якщо відповідні права доступу блокують створення директорії.

Приклади

Приклад #1 Приклад використання функції mkdir()****

Loading...

Приклад #2 Использованиеmkdir()с параметромrecursive

Loading...

Дивіться також

  • is_dir() - Визначає, чи є ім'я файлу директорією
  • rmdir() - видаляє директорію
  • umask() - Змінює поточну маску прав доступу для новостворених файлів та каталогів (umask)