Login or Register Now   Email:  Password:   

PHP Manual

mkdir
PHP Manual
PrevNext

mkdir

(PHP 3, PHP 4, PHP 5)

mkdir -- Makes directory

Description

bool mkdir ( string pathname [, int mode [, bool recursive [, resource context]]] )

Attempts to create the directory specified by pathname.

Parameters

pathname

The directory path.

mode

The mode is 0777 by default, which means the widest possible access. For more information on modes, read the details on the chmod() page.

Note: mode is ignored on Windows.

Note that you probably want to specify the mode as an octal number, which means it should have a leading zero. The mode is also modified by the current umask, which you can change using umask().

recursive

context

Note: Context support was added with PHP 5.0.0. For a description of contexts, refer to Reference CLX, Stream Functions.

Return Values

Returns TRUE on success or FALSE on failure.

ChangeLog

VersionDescription
5.0.0 The recursive parameter was added
5.0.0 As of PHP 5.0.0 mkdir() can also be used with some URL wrappers. Refer to Appendix O for a listing of which wrappers support mkdir()
4.2.0 The mode parameter became optional.

Examples

Example 1. mkdir() example

<?php
mkdir("/path/to/my/dir", 0700);
?>

Notes

Note: When safe mode is enabled, PHP checks whether the directory in which you are about to operate has the same UID (owner) as the script that is being executed.

See Also

rmdir()

PrevHomeNext
lstatUpmove_uploaded_file