【PHP8.x】tempnam関数の使い方

tempnam関数は、プログラムが一時的にデータを保存するための、安全かつ一意なファイル名を生成する関数です。この関数は、特に複数のプロセスやスクリプトが同時に動作している環境で、ファイル名の衝突を防ぎながら一時的なファイルを利用したい場合に非常に有効です。例えば、ユーザーがアップロードしたファイルを一時的に処理したり、重い計算結果を一時的に保存したりする際に利用されます。

tempnam関数は二つの引数を取ります。最初の引数には、生成される一時ファイル名を格納したいディレクトリのパスを指定します。もしこの引数が省略されるか、アクセスできないディレクトリが指定された場合、PHPはシステムのデフォルトの一時ディレクトリを使用しようとします。二番目の引数には、生成されるファイル名の先頭に追加する文字列（プレフィックス）を指定します。このプレフィックスとランダムな文字列を組み合わせて、他に存在しない一意のファイル名が作成され、そのフルパスが文字列として返されます。ファイル名の生成に失敗した場合は、falseが返されます。

この関数はファイル名を生成するのみで、実際にその名前のファイルを作成するわけではありません。ファイルの実体を作成したり、内容を書き込んだりするのは、この関数が返したファイル名を使って開発者が行う必要があります。また、生成された一時ファイルはシステムリソースを消費するため、使用が終了したら、unlink()関数などを用いて開発者自身が明示的に削除することが非常に重要です。これにより、ディスクスペースの無駄遣いを防ぎ、システムの安定稼働を保つことができます。

<?php

$tempFile = tempnam(sys_get_temp_dir(), 'prefix');

?>

string $directory, string $prefix

• string $directory: 一時ファイルを作成するディレクトリのパス
• string $prefix: 一時ファイル名の先頭に付与する文字列

string|false

指定されたディレクトリ内に一意の一時ファイル名を生成し、そのファイル名を返します。ファイルが正常に作成できなかった場合はfalseを返します。