mkdir

(PHP 4, PHP 5)

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

Описание

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

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

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

pathname

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

mode

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

Замечание:

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

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

recursive

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

context

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

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

Возвращает 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($structure0true)) {
    die(
'Не удалось создать директории...');
}

// ...
?>

Примечания

Замечание: Когда опция safe mode включена, PHP проверяет, имеет ли каталог, с которым вы собираетесь работать, такой же UID (владельца), как и выполняемый скрипт.

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

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


Участник рейтинга Тэглайн 2010