mkdir - Создаёт директорию
Вернуться к: Файловая система
mkdir
(PHP 4, PHP 5, PHP 7)
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
в случае возникновения ошибки.
Примеры
Пример #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 (владельца), как и выполняемый скрипт.
Смотрите также
Вернуться к: Файловая система