【PHP8.x】STREAM_MKDIR_RECURSIVE定数の使い方

STREAM_MKDIR_RECURSIVE定数は、ファイルシステム上に新しいディレクトリを作成する際に、その作成処理の振る舞いを指定するための定数です。この定数は、PHPでディレクトリを作成する関数、例えば mkdir() や stream_mkdir() などで使用されるオプションの一部として利用されます。

通常、mkdir()関数で存在しない親ディレクトリを含むパスを指定した場合、その親ディレクトリが存在しないとエラーになりますが、STREAM_MKDIR_RECURSIVE定数をオプションとして指定することで、その挙動を変更できます。具体的には、この定数を指定すると、作成しようとするディレクトリパスの途中に、まだ存在しない親ディレクトリがあったとしても、それらの中間ディレクトリもすべて自動的に作成する「再帰的な作成」を有効にします。

例えば、「/var/www/html/project/uploads」というパスで「project」や「uploads」ディレクトリが存在しない場合、通常は「project」が存在しないためエラーになります。しかし、STREAM_MKDIR_RECURSIVE定数を指定して実行すると、「project」ディレクトリが作成され、その中に「uploads」ディレクトリが作成されます。

この機能は、ファイルのアップロード先や一時ファイルの保存場所など、動的に深い階層のディレクトリを作成する必要がある場合に非常に便利です。開発者が一つずつ親ディレクトリの存在を確認したり、手動で作成したりする手間を省き、より安全で効率的なコードを書くのに役立ちます。これにより、ファイルシステム操作の信頼性と簡潔さが向上します。

Copy
1mkdir('/path/to/new/directory/recursively', 0777, STREAM_MKDIR_RECURSIVE);

引数なし

引数はありません

戻り値なし

戻り値はありません