(PHP 4, PHP 5)
mkdir — Создаёт директорию
$pathname
[, int $mode = 0777
[, bool $recursive = false
[, resource $context
]]] )Пытается создать директорию, заданную в pathname.
pathname
Путь к директории.
mode
По умолчанию принимает значение 0777, что означает самые широкие права. Больше информации о режимах доступа можно узнать на странице руководства функции chmod().
Замечание:
Аргумент
modeигнорируется в Windows.
Обратите внимание, что аргумент mode необходимо задавать в виде восьмиричного числа (первой цифрой должен быть ноль). На аргумент mode также влияет текущее значение umask, которое можно изменить при помощи umask().
recursive
Разрешает создание вложенных директорий, указанных в
pathname.
context
Замечание: Поддержка контекста была добавлена в PHP 5.0.0. Для описания контекстов смотрите раздел Потоки.
Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.
| Версия | Описание |
|---|---|
| 5.0.0 |
Добавлен параметр recursive
|
| 5.0.0 | Начиная с версии PHP 5.0.0 mkdir() также может быть использована с некоторыми обертками URL. Обратитесь к Поддерживаемые протоколы и обработчики (wrappers) для полного списка оберток, поддерживающих mkdir(). |
| 4.2.0 |
Параметр mode стал необязательным.
|
Пример #1 Пример использования функции mkdir()
<?php
mkdir("/path/to/my/dir", 0700);
?>
Пример #2 Использование mkdir() с параметром recursive
<?php
// Желаемая структура папок
$structure = './depth1/depth2/depth3/';
// Для создания вложенной структуры необходимо указать параметр
// $recursive в mkdir() .
if (!mkdir($structure, 0, true)) {
die('Не удалось создать директории...');
}
// ...
?>
Замечание: Когда опция safe mode включена, PHP проверяет, имеет ли каталог, с которым вы собираетесь работать, такой же UID (владельца), как и выполняемый скрипт.