mkdir

(PHP 4, PHP 5, PHP 7, PHP 8)

mkdirディレクトリを作る

説明

mkdir(
    string$directory,
    int$permissions = 0777,
    bool$recursive = false,
    resource$context = ?
): bool

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

パラメータ

directory

ディレクトリのパス。

permissions

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

注意:

Windows では permissions は無視されます。

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

recursive

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

context

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

返り値

成功した場合に true を、失敗した場合に false を返します。

エラー / 例外

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

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

例1 mkdir() の例

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

例2 mkdir() での recursive パラメータの使用例

<?php
// 作りたいフォルダ構造
$structure './depth1/depth2/depth3/';

// 入れ子構造を作るには、$recursive パラメータを
// mkdir() に指定しなければなりません

if (!mkdir($structure0777true)) {
    die(
'Failed to create folders...');
}

// ...
?>

参考

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