tempnam

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

tempnam — Crée un fichier avec un nom unique

Description

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

Crée un fichier dont le nom est unique, ayant comme permissions d'accès 0600, dans le dossier spécifié. Si le dossier n'existe pas ou qu'il n'est pas accessible en écriture, tempnam() tentera de créer un fichier dans le dossier temporaire système, et retournera le chemin complet de ce fichier, y compris son nom.

Liste de paramètres

directory

Le dossier dans lequel le fichier temporaire sera créé.

prefix

Le préfixe du fichier temporaire généré.

Note: Seuls les 63 premiers caractères du préfixe sont utilisés, le reste est ignoré. Windows utilise uniquement les 3 premiers caractères du préfixe.

Valeurs de retour

Retourne un nouveau fichier temporaire (avec son chemin), ou false si une erreur survient.

Historique

Version Description
7.1.0 tempnam() émet désormais une notice lors du rabat sur le dossier temporaire système.

Exemples

Exemple #1 Exemple avec tempnam()

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

$handle = fopen($tmpfname, "w");
fwrite($handle, "Écriture dans le fichier temporaire");
fclose($handle);

// traitement

unlink($tmpfname);
?>

Notes

Note: Si PHP ne peut pas créer un fichier dans le dossier spécifié par le paramètre directory, il tentera dans le dossier par défaut du système. Sous les systèmes de fichiers NTFS, ceci arrive également si le dossier directory contient plus de 65534 fichiers.

Voir aussi