Создаёт файл с уникальным именем

# tempnam

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

tempnam — Создаёт файл с уникальным именем

### Описание

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

Создаёт файл с уникальным именем в определённой директории с правами 0600. Если эта директория не существует или недоступна для записи, tempnam() может создать файл во временной директории системы и вернуть полный путь к этому файлу, включая его имя.

### Список параметров

`directory`

  Директория, где будет создан временный файл.

`prefix`

  Префикс имени генерируемого файла.

  > Замечание: Используются только первые 63 символа префикса, остальные игнорируются. В Windows используются только первые три символа префикса.

### Возвращаемые значения

Возвращает имя нового временного файла (вместе с путём) или `false` в случае неудачи.

### Список изменений

Версия | Описание
--- | ---
8.4.0 | Имена файлов, которые создаёт функция tempnam(), теперь длиннее на 13 байтов. Общая длина по-прежнему зависит от платформы.
7.1.0 | tempnam() теперь выдаёт уведомление при возврате во временный каталог системы.

### Примеры

Пример #1 Пример использования функции tempnam()

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

    $handle = fopen($tmpfname, "w");
    fwrite($handle, "записываем в во временный файл");
    fclose($handle);

    // здесь мы чего-нибудь делаем

    unlink($tmpfname);
    ?>

### Примечания

> Замечание: Если PHP не может создать файл в указанной директории `directory`, он возвращается к директории по умолчанию вашей системы. На NTFS это также происходит в случае, если указанная директория `directory` содержит более 65534 файлов.

### Смотрите также

- tmpfile() - Создаёт временный файл
- sys_get_temp_dir() - Возвращает путь к директории временных файлов
- unlink() - Удаляет файл

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open