tempnam

(PHP 3, PHP 4, PHP 5)

tempnam -- ユニークなファイル名を生成する

説明

string tempnam ( string dir, string prefix )

ユニークなテンポラリファイル名を指定したディレクトリに作成します。 指定したディレクトリが存在しない場合、 tempnam() は、システムのテンポラリディレクトリ にあるファイル名を生成し、その名前を返します。

PHP 4.0.6より前では、関数tempnam()の動作はシス テムに依存していました。WindowsにおいてTMP環境変数は dirパラメータを上書きします。Linuxにおいて は、TMPDIR環境変数が優先されます。一方、SVR4においては指定したディ レクトリが存在する場合は、常にdirパラメー タを使用します。疑問がある場合は、tempnam(3)に関するシステムドキュ メントを参照ください。

注意: PHP が指定されたパラメータ dir にファイルを生成することができない場合、システム標準のフォールバックが 実行されます。

新しいテンポラリファイル名を返し、失敗した場合にはFALSEを返しま す。

例 1. tempnam()の例

<?php
$tmpfname
= tempnam("/tmp", "FOO");

$handle = fopen($tmpfname, "w");
fwrite($handle, "writing to tempfile");
fclose($handle);

// ここで何か行う

unlink($tmpfname);
?>

注意: この関数の動作は、4.0.3 で変更され、文字列が生成された時間の間や スクリプトがファイルの作成にとりかかる前にファイルシステムに現れ る可能性がある場合のファイルとの競合を回避するためにもテンポラリ ファイルは作成されます。このファイルは自動的に削除されないため、 不要となった場合にはこのファイルを削除する必要があることに注意し てください。

tmpfile(), unlink()も参照下 さい。