Crea un fichero con un nombre único

# tempnam

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

tempnam — Crea un fichero con un nombre único

### Descripción

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

Crea un fichero con un nombre único, con permisos de acceso 0600, en el directorio especificado. Si el directorio no existe o no es accesible en escritura, tempnam() intentará crear un fichero en el directorio temporal del sistema, y devolverá la ruta completa de dicho fichero, incluyendo su nombre.

### Parámetros

`directory`

  El directorio en el que se creará el fichero temporal.

`prefix`

  El prefijo del fichero temporal generado.

  > Nota: Solo se utilizan los 63 primeros caracteres del prefijo, el resto se ignora. Windows utiliza únicamente los 3 primeros caracteres del prefijo.

### Valores devueltos

Devuelve un nuevo fichero temporal (con su ruta), o `false` si ocurre un error.

### Historial de cambios

Versión | Descripción
--- | ---
8.4.0 | El nombre de los archivos creados por tempnam() ahora es 13 bytes más largo. La longitud total sigue dependiendo de la plataforma.
7.1.0 | tempnam() ahora emite un aviso al recurrir al directorio temporal del sistema.

### Ejemplos

Ejemplo #1 Ejemplo con tempnam()

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

    $handle = fopen($tmpfname, "w");
    fwrite($handle, "Escritura en el fichero temporal");
    fclose($handle);

    // procesamiento

    unlink($tmpfname);
    ?>

### Notas

> Nota: Si PHP no puede crear un fichero en el directorio especificado por el argumento `directory`, intentará hacerlo en el directorio por defecto del sistema. En sistemas de archivos NTFS, esto también ocurre si el directorio `directory` contiene más de 65534 ficheros.

### Ver también

- tmpfile() - Crea un fichero temporal
- sys_get_temp_dir() - Devuelve la ruta del directorio utilizado para los ficheros temporales
- unlink() - Elimina un fichero

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open