array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.tempnam.php', 1 => 'tempnam', 2 => 'Crea un fichero con un nombre único', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Funciones del Sistema de Archivos', ), 'prev' => array ( 0 => 'function.symlink.php', 1 => 'symlink', ), 'next' => array ( 0 => 'function.tmpfile.php', 1 => 'tmpfile', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/filesystem/functions/tempnam.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

tempnam

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

tempnam — Crea un fichero con un nombre único

Descripción

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
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