mkdir
(PHP 4, PHP 5)
mkdir — ディレクトリを作る
説明
bool mkdir
( string $pathname
[, int $mode
[, bool $recursive
[, resource $context
]]] )
指定したディレクトリを作成します。
パラメータ
- pathname
-
ディレクトリのパス。
- mode
-
モードは 0777 がデフォルトです。 これは最も緩やかなアクセス制限を意味します。 モードに関する詳細は chmod() をご覧ください。
注意: Windows では mode は無視されます。
モードを八進数で指定したくなることもあるかもしれません。 その場合は先頭にゼロをつける必要があります。 また、モードは、現在設定されている umask の影響も受けます。 umask を変更するには umask() を使用します。
- recursive
-
デフォルトは FALSE。
- context
-
注意: コンテキストのサポートは、 PHP 5.0.0 で追加されました。contexts の説明に関しては、 ストリーム 関数 を参照してください。
返り値
成功した場合に TRUE を、失敗した場合に FALSE を返します。
変更履歴
| バージョン | 説明 |
|---|---|
| 5.0.0 | recursive パラメータが追加されました。 |
| 5.0.0 | PHP 5.0.0 以降、mkdir() は いくつかの URL ラッパーを併用することが可能です。 mkdir() をサポートしているラッパーの一覧については、 サポートされるプロトコル/ラッパー を参照ください。 |
| 4.2.0 | mode パラメータがオプションとなりました。 |
例
例1 mkdir() の例
<?php
mkdir("/path/to/my/dir", 0700);
?>
注意
注意: セーフモード が有効の場合、PHP は、 操作を行うディレクトリが、実行するスクリプトと同じ UID (所有者)を有しているか どうかを確認します。