mkdir

(PHP 4, PHP 5, PHP 7)

mkdir — Создаёт директорию

Описание

mkdir ( string $pathname , int $mode = 0777 , bool $recursive = false , resource $context = ? ) : bool

Пытается создать директорию, заданную в pathname.

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

pathname

Путь к директории.

mode

По умолчанию принимает значение 0777, что означает самые широкие права. Больше информации о режимах доступа можно узнать на странице руководства функции chmod().

Замечание:
Аргумент mode игнорируется в Windows.

Обратите внимание, что аргумент mode необходимо задавать в виде восьмеричного числа (первой цифрой должен быть ноль). На аргумент mode также влияет текущее значение umask, которое можно изменить при помощи umask().

recursive

Разрешает создание вложенных директорий, указанных в pathname.

context

Замечание: Поддержка контекста была добавлена в PHP 5.0.0. Для описания контекстов смотрите раздел Потоки.

Возвращаемые значения

Возвращает true в случае успешного завершения или false в случае возникновения ошибки.

Примеры

Пример #1 Пример использования функции mkdir()


<?php
mkdir("/path/to/my/dir", 0700);
?>

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


<?php
// Желаемая структура папок
$structure = './depth1/depth2/depth3/';

// Для создания вложенной структуры необходимо указать параметр
// $recursive в mkdir().

if (!mkdir($structure, 0777, true)) {
    die('Не удалось создать директории...');
}

// ...
?>

Ошибки

Выдает ошибку уровня E_WARNING, если директория уже существует.

Выдает ошибку уровня E_WARNING, если соответствующие права доступа блокируют создание директории.

Смотрите также

is_dir() - Определяет, является ли имя файла директорией
rmdir() - Удаляет директорию