array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.tempnam.php', 1 => 'tempnam', 2 => 'Cria arquivo com nome único', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Funções de Filesystem', ), 'prev' => array ( 0 => 'function.symlink.php', 1 => 'symlink', ), 'next' => array ( 0 => 'function.tmpfile.php', 1 => 'tmpfile', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', '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 — Cria arquivo com nome único

Descrição

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

Cria um arquivo com nome único, com permissões de acesso definidas para 0600, no diretório especificado. Se o diretório não existir ou não puder ser escrito, tempnam() pode gerar um arquivo no diretório temporário do sistema e retornar o caminho completo ao arquivo, incluindo seu nome.

Parâmetros

directory

O diretório onde o arquivo temporário será criado.

prefix

O prefixo do nome do arquivo temporário gerado.

Nota: Apenas os primeiros 63 caracteres do prefixo são usados, o restante é ignorado. Windows usa apenas os primeiros três caracteres do prefixo.

Valor Retornado

Retorna o novo nome do arquivo temporário (com caminho), ou false em caso de falha.

Registro de Alterações

Versão Descrição
7.1.0 tempnam() agora emite um aviso ao cair de volta no diretório temporário do sistema.

Exemplos

Exemplo #1 Exemplo de tempnam()

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

$handle = fopen($tmpfname, "w");
fwrite($handle, "writing to tempfile");
fclose($handle);

// faz alguma coisa

unlink($tmpfname);
?>

Notas

Nota: Se o PHP não conseguir criar um arquivo no diretório informado directory, ele cria no diretório padrão do sistema. No sistema de arquivos NTFS isto também acontece se o diretório especificado em directory contiver mais que 65534 arquivos.

Veja Também