tempnam

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

tempnam — Cria arquivo com nome único

Descrição

function 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
8.4.0 O nome dos arquivos criados por tempnam() agora é 13 bytes mais longo. O comprimento total ainda depende da plataforma.
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