mkdir: ディレクトリを作る (ファイルシステム関数) - PHPプロ！マニュアル

» 「ファイルシステム関数」に戻る

PHPマニュアル

mkdir: ディレクトリを作る

mkdir

(PHP 4, PHP 5)

mkdir — ディレクトリを作る

説明

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

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

パラメータ

pathname

ディレクトリのパス。

mode

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

注意:

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

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

recursive

pathname で、入れ子構造のディレクトリの作成を許可します。デフォルトは 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);
?>

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

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

// 入れ子構造を作るには、$recursive パラメータを

// mkdir() に指定しなければなりません

if (!mkdir($structure, 0, true)) {

    die('Failed to create folders...');

}

// ...
?>

注意

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

参考

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

mkdir: ディレクトリを作る (ファイルシステム関数) - PHPプロ！マニュアル