Criar arquivos com nomes únicos em diretórios

Em sistemas que envolvem upload de um número indefinido de arquivos, é possível que o sistema armazene o arquivo no próprio Banco de Dados ou que ele armazene em algum diretório reservado para arquivos submetidos.

O primeiro caso normalmente não exige que os arquivos tenham nomes únicos (exceto por alguma restrição do sistema). No segundo caso, independente da forma como os diretórios são organizados, é necessário garantir que um arquivo tenha um nome único dentro de um diretório.

A estratégia mais indicada para este segundo caso é criar diretórios diferentes para grupos de arquivos diferentes. Por exemplo, se o upload é feito por usuários que possuem uma identificação única (um ID), você pode usar este ID para criar um diretório exclusivo do usuário (usa-se a função do PHP mkdir para criá-lo). Dentro do diretório do usuário, para garantir que o nome do arquivo seja único, é possível adotar algumas estratégias:

• Usar o próprio nome enviado pelo usuário, e não permitir submeter um arquivo cujo nome já consta no diretório.
• Nome auto-incrementável (normalmente com algum prefixo seguido de um número que é controlado pelo programador).
• Nome único (gerado por algum mecanismo que garanta o nome único do arquivo no diretório).

O nome auto-incrementável consiste em definir um padrão de nome (por exemplo: "foto_%d.jpg", onde %d é um número). No momento que uma nova foto é submetida, o sistema verifica qual é a última foto cadastrada (através de uma varredura do diretório e extração da informação sobre o último número utilizando expressão regular). Exemplo:

...

// Obter conteudo do diretorio do usuario
$arquivos = scandir($diretorio_usuario);

// Variavel que guarda o ultimo numero encontrado no diretorio
$ultimo = 0;

foreach ($arquivos as $arquivo) {
    if ($arquivo == '.' || $arquivo == '..') {
        continue;
    }

    // Se o nome do arquivo esta no padrao
    if (preg_match('/^foto_(\d+)\.jpg$/', $arquivo, $matches)) {

        // Extrair o numero do arquivo
        $numero = (int)$matches[1];

        // Guardar o maior numero
        $ultimo = max($numero, $ultimo);
    }
}

// Determinar o proximo numero a ser usado
$proximo = $ultimo + 1;

// Montar o nome do proximo arquivo submetido
$novo_arquivo = $diretorio_usuario.'/'.sprintf('foto_%d.jpg', $proximo);

// Salvar o arquivo em $novo_arquivo
move_uploaded_file($origem, $novo_arquivo);

Esta abordagem é relativamente segura se considerarmos que o mesmo usuário não pode acessar o sistema de forma concorrente. Logo, não existe risco do usuário ler o diretório enquanto um arquivo é criado ali, ocasionando uma "leitura suja".

A segunda estratégia é utilizar uma função que consiga criar um nome único em um diretório com segurança. Em PHP existe a função tempnam, que cria um arquivo com nome único em um diretório e retorna o nome do arquivo gerado. Esta abordagem é útil quando se tem apenas um diretório com arquivos de diferentes usuários.

Além das funções apresentadas, pode ser útil conhecer file_exists para determinar se um arquivo/diretório já existe.

Para casos mais específicos onde pretende-se criar um arquivo temporário, é possível usar a função tmpfile que cria um arquivo com nome único em algum diretório específico para arquivos temporários, e retorna um handle do arquivo (assim como a função fopen, por exemplo). Porém, ao fechar o arquivo (usar fclose sobre o handle), ele é automaticamente excluído. Este recurso pode ser usado para realizar operações em disco (por utilizarem muita memória, por exemplo).