mkdir
(PHP 4, PHP 5, PHP 7)
mkdir — ディレクトリを作る
説明
$pathname
[, int $mode = 0777
[, bool $recursive = false
[, resource $context
]]] )指定したディレクトリを作成します。
パラメータ
-
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 (所有者)を有しているか どうかを確認します。
忘却曲線を使ってこの関数を確実に記憶に残す
