function drupal_mkdir

Creates a directory using Drupal's default mode.

PHP's mkdir() does not respect Drupal's default permissions mode. If a mode is not provided, this function will make sure that Drupal's is used.

Compatibility: normal paths and stream wrappers.

Parameters

$uri: A URI or pathname.

$mode: By default the Drupal mode is used.

$recursive: Default to FALSE.

$context: Refer to http://php.net/manual/ref.stream.php

Return value

Boolean TRUE on success, or FALSE on failure.

See also

mkdir()

http://drupal.org/node/515192

Related topics

File interface
Common file handling functions.
PHP wrapper functions
Functions that are wrappers or custom implementations of PHP functions.
5 calls to drupal_mkdir()
drupal_install_mkdir in drupal/includes/install.inc
Creates a directory with the specified permissions.
FileTestCase::createDirectory in drupal/modules/simpletest/tests/file.test
Create a directory and assert it exists.
file_prepare_directory in drupal/includes/file.inc
Checks that the directory exists and is writable.
RetrieveFileTestCase::testFileRetrieving in drupal/modules/system/system.test
Invokes system_retrieve_file() in several scenarios.
system_check_directory in drupal/modules/system/system.module
Checks the existence of the directory specified in $form_element.

File

drupal/includes/file.inc, line 2433
API for handling file uploads and server file management.

Code

function drupal_mkdir($uri, $mode = NULL, $recursive = FALSE, $context = NULL) {
  if (!isset($mode)) {
    $mode = variable_get('file_chmod_directory', 0775);
  }
  if (!isset($context)) {
    return mkdir($uri, $mode, $recursive);
  }
  else {
    return mkdir($uri, $mode, $recursive, $context);
  }
}