tempnam

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

tempnam — Erzeugt eine Datei mit eindeutigem Dateinamen

Beschreibung

tempnam(string $directory, string $prefix): string|false

Erzeugt eine Datei mit einem eindeutigen Dateinamen in dem angegebenen Verzeichnis, wobei die Zugriffsberechtigungen auf 0600 gesetzt werden. Wenn das Verzeichnis nicht existiert oder nicht beschreibbar ist, erstellt tempnam() eine Datei im temporären Verzeichnis des Systems und gibt den vollständigen Pfad zu dieser Datei, der den Namen beinhaltet, zurück.

Parameter-Liste

directory

Das Verzeichnis, in dem die temporäre Datei erstellt werden soll.

prefix

Der Präfix des genererierten temporären Dateinamens.

Hinweis: Es werden nur die ersten 63 Zeichen des Präfixes verwendet, der Rest wird ignoriert. Windows nutzt nur die ersten drei Zeichen des Präfixes.

Rückgabewerte

Gibt den neuen temporären Dateinamen (mit Pfad) zurück oder false bei einem Fehler.

Changelog

Version Beschreibung
7.1.0 tempnam() gibt nun eine Meldung aus, wenn sie ins temporäre Verzeichnis des Systems zurückfällt.

Beispiele

Beispiel #1 tempnam()-Beispiel

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

$handle = fopen($tmpfname, "w");
fwrite($handle, "schreiben in Temporärdatei");
fclose($handle);

// tue etwas

unlink($tmpfname);
?>

Anmerkungen

Hinweis: Wenn PHP die Datei nicht im angegebenen Verzeichnis directory erzeugen kann, fällt es auf den Standardwert des Systems zurück. Unter NTFS geschieht dies auch, wenn directory mehr als 65534 Dateien enthält.

Siehe auch