(PHP 4, PHP 5, PHP 7)
mkdir — Создаёт директорию
$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, если соответствующие
права доступа блокируют создание директории.
Замечание: Когда опция safe mode включена, PHP проверяет, имеет ли каталог, с которым вы собираетесь работать, такой же UID (владельца), как и выполняемый скрипт.