(PHP 4, PHP 5, PHP 7, PHP 8)
mkdir — Makes directory
$directory
,$permissions
= 0777,$recursive
= false
,$context
= null
Attempts to create the directory specified by directory
.
directory
The directory path.
permissions
The permissions are 0777 by default, which means the widest possible access. For more information on permissions, read the details on the chmod() page.
Note:
permissions
is ignored on Windows.
Note that you probably want to specify the permissions
as an octal number,
which means it should have a leading zero. The permissions
is also modified
by the current umask, which you can change using
umask().
recursive
Allows the creation of nested directories specified in the
directory
.
context
A context stream resource.
Returns true
on success or false
on failure.
Emits an E_WARNING
level error if the directory
already exists.
Emits an E_WARNING
level error if the relevant
permissions prevent creating the directory.
Example #1 mkdir() example
<?php
mkdir("/path/to/my/dir", 0700);
?>
Example #2 mkdir() using the recursive
parameter
<?php
// Desired directory structure
$structure = './depth1/depth2/depth3/';
// To create the nested structure, the $recursive parameter
// to mkdir() must be specified.
if (!mkdir($structure, 0777, true)) {
die('Failed to create directories...');
}
// ...
?>