# 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

- tmpfile() - Crée un fichier temporaire
- sys_get_temp_dir() - Retourne le chemin du répertoire utilisé pour les fichiers temporaires
- unlink() - Supprime un fichier