ディレクトリを作る

# mkdir

(PHP 4, PHP 5, PHP 7)

mkdir — ディレクトリを作る

### 説明

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

指定したディレクトリを作成します。

### パラメータ

`pathname`

  ディレクトリのパス。

`mode`

  モードは 0777 がデフォルトです。 これは最も緩やかなアクセス制限を意味します。 モードに関する詳細は chmod() をご覧ください。

  > 注意:

  > Windows では `mode` は無視されます。

  モードを八進数で指定したくなることもあるかもしれません。 その場合は先頭にゼロをつける必要があります。 また、モードは、現在設定されている umask の影響も受けます。 umask を変更するには umask() を使用します。

`recursive`

  `pathname` で、入れ子構造のディレクトリの作成を許可します。

`context`

  > 注意: コンテキストのサポートは、 PHP 5.0.0 で追加されました。contexts の説明に関しては、 ストリーム を参照してください。

### 返り値

成功した場合に `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('Failed to create folders...');
}
// ...
?>`

### エラー / 例外

ディレクトリが既に存在する場合は `E_WARNING` レベルのエラーが発生します。

ディレクトリの作成権限がない場合は `E_WARNING` レベルのエラーが発生します。

### 注意

> 注意: セーフモード が有効の場合、PHP は、 操作を行うディレクトリが、実行するスクリプトと同じ UID (所有者)を有しているか どうかを確認します。

### 参考

- rmdir() - ディレクトリを削除する