Manual do PHP
Anterior |  | Próxima

# tempnam

(PHP 3, PHP 4 , PHP 5)

tempnam -- Cria um nome de arquivo único

## Descrição

string tempnam ( string dir, string prefix )

Cria um nome de arquivo temporário único no diretório especificado. Se o diretório não existe, tempnam() pode gerar o nome de arquivo no diretório temporário do sistema. Retorna o nome gerado.

Antes do PHP 4.0.6 o comportamento da função tempnam() era dependente do sistema. No Windows a váriavel de ambiente do sistema TMP irá sobreescrever o parâmetro dir; no Linux a váriavel de ambiente TMPDIR tem precedência, enquanto SVR4 irá sempre usar o parâmetro dir se o diretório para o qual ele aponta existe. Consulte a documentação do seu sistema para a função tempnam(3) na dúvida.

> Nota: Se o PHP não conseguir criar um arquivo informado em dir, deve ser por causa de um erro no default do sistema.

Retorna o nome do novo arquivo temporário, ou a string `FALSE` string em caso de erro.

Exemplo 1. Exemplo de tempnam()
`<?php $tmpfname = tempnam ("/tmp", "FOO"); $handle = fopen($tmpfname, "w"); fwrite($handle, "writing to tempfile"); fclose($handle); // fazer alguma coisa unlink($tmpfname); ?>`

> Nota: O comportamento desta função mudou na versão 4.0.3. O arquivo temporário é também criado para evitar uma condição de corrida (race) onde o arquivo pode aparecer no filesystem entre o tempo que a string foi gerada e antes que o script tem tempo para criar o arquivo. Note que você precisa remover o arquivo caso não vá mais utilizá-lo, pois isso não é feito automaticamente.

Veja também tmpfile() e unlink().

Anterior | Principal | Próxima
symlink | Acima | tmpfile