PHP: полный мануал с примерами, функциями и ООП

PHP 4+ · standard

basename(string $path, string $suffix = ""): string

Показать короткое имя отчёта вместо полного пути.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. function name($x) { ... } объявляет повторяемое действие; return отдаёт результат вызову. foreach берёт элементы массива по одному, форма as $key => $value также читает ключ. [...] создаёт массив; $row["size"] читает поле по ключу; [$a, $b] = ... раскладывает список. Переменные; Вызов и return; Поток и позиция чтения.

<?php
echo basename('exports/monthly.csv'), "\n";
echo basename('exports/monthly.csv', '.csv'), "\n";
echo basename('exports/monthly.CSV', '.csv'), "\n";

monthly.csv
monthly
monthly.CSV

<?php
function reportLabel($path) { return basename($path); }
foreach (['private/reports/jan.csv', 'private/reports/feb.csv'] as $path) {
    echo reportLabel($path), "\n";
}

jan.csv
feb.csv

Применение и границы. Не понимает семантику .. и symlink. На Windows разделители / и \, на прочих ОС обычно только /. Функция зависит от locale для многобайтового имени; некорректные байты дают неопределённый результат. Это не разрешение доступа и не защита от подмены пути. Пользователь выбирает разрешённый идентификатор, приложение задаёт путь; права ОС и проверки самой операции остаются обязательными.

Сравните: dirname, pathinfo, realpath. Полный выбор файловых операций.

• PHP: basename

PHP 4+ · standard

dirname(string $path, int $levels = 1): string

Получить родительский путь для размещения соседнего файла.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. function name($x) { ... } объявляет повторяемое действие; return отдаёт результат вызову. try выполняет попытку, catch обрабатывает указанный отказ, finally освобождает ресурс и не подавляет ошибку. throw new RuntimeException сообщает о сбое. Переменные; Вызов и return; Поток и позиция чтения.

Параметр levels существует с PHP 7.0; здесь код рассчитан на PHP 8.2+.

<?php
echo dirname('app/reports/daily.csv'), "\n";
echo dirname('app/reports/daily.csv', 2), "\n";
echo dirname('daily.csv'), "\n";

app/reports
app
.

<?php
function manifestFor($report) { return dirname($report) . '/manifest.json'; }
echo manifestFor('export/report.csv'), "\n";
try { dirname('export/report.csv', 0); }
catch (ValueError $error) { echo "Нужен хотя бы один уровень\n"; }

export/manifest.json
Нужен хотя бы один уровень

Применение и границы. Не разрешает .. и ссылки. Цикл подъёма должен останавливаться, когда родитель не меняется, иначе dirname(".") снова даёт ".". Windows учитывает обе косые черты и текущую codepage; другие ОС требуют ASCII-совместимой кодировки пути.

Сравните: basename, pathinfo, realpath. Полный выбор файловых операций.

• PHP: dirname

PHP 4.0.3+ · standard

pathinfo(string $path, int $flags = PATHINFO_ALL): array|string

Разобрать текст пути на каталог, имя и расширение.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. [...] создаёт массив; $row["size"] читает поле по ключу; [$a, $b] = ... раскладывает список. Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

foreach (['exports/archive.tar.gz', 'README'] as $path) {
    $parts = pathinfo($path);
    echo $parts['basename'], ' — расширение: ', $parts['extension'] ?? 'нет', "\n";
}
echo 'Основа архива: ', pathinfo('exports/archive.tar.gz', PATHINFO_FILENAME), "\n";

archive.tar.gz — расширение: gz
README — расширение: нет
Основа архива: archive.tar

<?php
echo pathinfo('.env', PATHINFO_EXTENSION), "\n";
var_dump(pathinfo('.env', PATHINFO_FILENAME));
var_dump(pathinfo('report.', PATHINFO_EXTENSION));

env
string(0) ""
string(0) ""

Применение и границы. На Windows \ — разделитель, на прочих ОС обычный символ. Для многобайтовых имён важна locale. Не разрешает symlink/..; для URL нужен разбор URL, а для проверки загруженного файла — содержимое и правила uploads.

Сравните: basename, dirname, realpath. Полный выбор файловых операций.

• PHP: pathinfo

PHP 4+ · standard

clearstatcache(bool $clear_realpath_cache = false, string $filename = ""): void

Перечитать метаданные после изменения файла вместо использования старого stat-кэша.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

$path = __DIR__ . '/events.log';
echo 'До дополнения: ', filesize($path), " байт\n";
file_put_contents($path, "paid\n", FILE_APPEND);
clearstatcache();
echo 'После дополнения: ', filesize($path), " байт\n";
echo file_get_contents($path);

До дополнения: 8 байт
После дополнения: 13 байт
created
paid

<?php
$path = __DIR__ . '/state.txt';
realpath($path);
clearstatcache(true, $path);
echo basename(realpath($path)), "\n";
unlink($path);
var_dump(file_exists($path));

state.txt
bool(false)

Применение и границы. Влияет на stat/lstat, file_exists, is_*, размеры, время, inode, владельца, группу, тип и права. Не вызывайте на каждой итерации без причины; при внешнем изменении он нужен для актуального запроса, но не блокирует конкурента. Результат относится к моменту проверки и может кэшироваться; clearstatcache() обновляет stat-кэш, но не устраняет гонку между проверкой и действием.

Сравните: stat, filesize, realpath_cache_get, realpath_cache_size. Полный выбор файловых операций.

• PHP: clearstatcache

PHP 5.3.2+ · standard

realpath_cache_get(): array

Исследовать, какие пути процесс уже разрешил и сохранил в кэше.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. foreach берёт элементы массива по одному, форма as $key => $value также читает ключ. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". try выполняет попытку, catch обрабатывает указанный отказ, finally освобождает ресурс и не подавляет ошибку. throw new RuntimeException сообщает о сбое. [...] создаёт массив; $row["size"] читает поле по ключу; [$a, $b] = ... раскладывает список. Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

clearstatcache(true);
$target = realpath(__DIR__ . '/pickup.txt');
foreach (realpath_cache_get() as $original => $entry) {
    if ($entry['realpath'] === $target) {
        echo basename($original), ': ', $entry['is_dir'] ? 'каталог' : 'файл', "\n";
    }
}

pickup.txt: файл

<?php
realpath(__DIR__ . '/cache.txt');
clearstatcache(true);
echo count(realpath_cache_get()), "\n";

0

Применение и границы. Не публикуйте диагностический дамп внутренних путей в веб-ответ. Опции realpath_cache_size и realpath_cache_ttl относятся к конфигурации ядра; open_basedir отключает realpath-кэш. expires — момент истечения, не гарантия существования файла.

Сравните: realpath_cache_size, clearstatcache, realpath. Полный выбор файловых операций.

• PHP: realpath_cache_get

PHP 5.3.2+ · standard

realpath_cache_size(): int

Узнать текущий расход памяти кэша путей, а не число файлов.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. Переменные; Вызов и return; Поток и позиция чтения.

<?php
clearstatcache(true);
echo realpath_cache_size(), "\n";

0

<?php
declare(strict_types=1);

clearstatcache(true);
$before = realpath_cache_size();
realpath(__DIR__ . '/pickup.txt');
$after = realpath_cache_size();
echo 'Начальный расход: ', $before, " байт\n";
echo $after > $before
    ? "Путь отчёта добавлен в кэш процесса.\n"
    : "Кэш отключён или путь не добавлен.\n";

Начальный расход: 0 байт
Путь отчёта добавлен в кэш процесса.

Применение и границы. Полезно при диагностике большого проекта, но увеличение лимита без измерения нагрузки не является универсальным ускорением. Кэш метаданных и realpath-кэш различаются.

Сравните: realpath_cache_get, clearstatcache. Полный выбор файловых операций.

• PHP: realpath_cache_size

PHP 4.3+ · standard

glob(string $pattern, int $flags = 0): array|false

Найти локальные отчёты по маске, например только CSV в известной папке.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. foreach берёт элементы массива по одному, форма as $key => $value также читает ключ. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". Переменные; Вызов и return; Поток и позиция чтения.

<?php
$paths = glob(__DIR__ . '/*.csv');
if ($paths === false) { throw new RuntimeException('Поиск не выполнен'); }
foreach ($paths as $path) { echo basename($path), "\n"; }

a.csv
b.csv

<?php
declare(strict_types=1);

$reports = glob(__DIR__ . '/missing-*.csv');
if ($reports === false) { throw new RuntimeException('Поиск не выполнен'); }
if ($reports === []) { echo "Готовых CSV-отчётов нет.\n"; }
$fallback = glob('missing-*.csv', GLOB_NOCHECK);
echo 'NOCHECK вернул шаблон: ', $fallback[0], "\n";

Готовых CSV-отчётов нет.
NOCHECK вернул шаблон: missing-*.csv

Применение и границы. Только локальная файловая система, не HTTP/FTP. GLOB_BRACE не существует на некоторых не-GNU системах (например Alpine/Solaris); проверяйте defined(). Unix зависит от libc, Windows использует POSIX-совместимую реализацию. Это не рекурсивный обход и не подтверждение доступа.

Сравните: fnmatch, is_file, opendir. Полный выбор файловых операций.

• PHP: glob

PHP 4.3+ · standard

fnmatch(string $pattern, string $filename, int $flags = 0): bool

Проверить пользовательскую маску имени без чтения каталога.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. [...] создаёт массив; $row["size"] читает поле по ключу; [$a, $b] = ... раскладывает список. Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

$names = ['report-7.csv', 'report-10.csv', 'report-X.csv'];
foreach ($names as $name) {
    if (fnmatch('report-[0-9].csv', $name)) {
        echo 'В дневную подборку: ', $name, "\n";
    } else {
        echo 'Другой формат имени: ', $name, "\n";
    }
}

В дневную подборку: report-7.csv
Другой формат имени: report-10.csv
Другой формат имени: report-X.csv

<?php
declare(strict_types=1);

$names = ['report.csv', 'sub/report.csv', '.draft.csv'];
foreach ($names as $name) {
    if (fnmatch('*.csv', $name, FNM_PATHNAME | FNM_PERIOD)) {
        echo 'В подборку: ', $name, "\n";
    }
}
echo fnmatch('*.CSV', 'report.csv', FNM_CASEFOLD)
    ? "Режим без учёта регистра принял report.csv.\n"
    : "Регистр отличается.\n";

В подборку: report.csv
Режим без учёта регистра принял report.csv.

Применение и границы. Используется и для обычных строк. Диапазоны описаны ASCII-кодами, не обещайте полноценное лингвистическое Unicode-сравнение. Это не разрешение доступа и не защита от подмены пути. Пользователь выбирает разрешённый идентификатор, приложение задаёт путь; права ОС и проверки самой операции остаются обязательными.

Сравните: glob, basename. Полный выбор файловых операций.

• PHP: fnmatch

PHP 4+ · standard

stat(string $filename): array|false

Получить набор метаданных файла; символическая ссылка ведёт к цели.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. function name($x) { ... } объявляет повторяемое действие; return отдаёт результат вызову. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". [...] создаёт массив; $row["size"] читает поле по ключу; [$a, $b] = ... раскладывает список. Переменные; Вызов и return; Поток и позиция чтения.

Тип в mode задаётся старшими битами: 0140000 socket, 0120000 link, 0100000 обычный файл, 0060000 block, 0040000 каталог, 0020000 char, 0010000 fifo. Нижние права — другая часть битовой маски.

<?php
declare(strict_types=1);

$path = __DIR__ . '/pickup.txt';
$info = stat($path);
if ($info === false) { throw new RuntimeException('Не получить метаданные'); }
echo basename($path), ': ', $info['size'], " байт\n";
echo $info['size'] === 0 ? "Пустой документ\n" : "Документ содержит данные\n";

pickup.txt: 11 байт
Документ содержит данные

<?php
function reportInfo($path) {
    $info = stat($path);
    if ($info === false) { throw new RuntimeException('Метаданные'); }
    return ['name' => basename($path), 'bytes' => $info['size']];
}
$info = reportInfo(__DIR__ . '/report.txt');
echo $info['name'], ': ', $info['bytes'], "\n";

report.txt: 6

Применение и границы. Windows: uid/gid равны 0; blksize/blocks обычно −1. С PHP 7.4 dev — serial тома, ino — ID файла; это unsigned 64-bit значения и возможен выход за signed int (до 7.4 значения были иными). mode отражает readonly-атрибут одинаково для owner/group/other, не Windows ACL. На 32-bit возможны проблемы с файлами >2 ГБ; точность времени зависит от ФС. Не каждое поле имеет одинаковый смысл на разных ОС. Результат относится к моменту проверки и может кэшироваться; clearstatcache() обновляет stat-кэш, но не устраняет гонку между проверкой и действием. Некоторые обёртки поддерживают stat, другие нет.

Сравните: fstat, lstat, filesize, filemtime, clearstatcache. Полный выбор файловых операций.

• PHP: stat

PHP 4+ · standard

fstat(resource $stream): array|false

Получить набор метаданных открытого файла.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. fopen возвращает открытый поток (resource), а не содержимое файла. rb читает байты, w+b создаёт/очищает файл и разрешает чтение с записью. fclose освобождает поток. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". try выполняет попытку, catch обрабатывает указанный отказ, finally освобождает ресурс и не подавляет ошибку. throw new RuntimeException сообщает о сбое. [...] создаёт массив; $row["size"] читает поле по ключу; [$a, $b] = ... раскладывает список. Переменные; Вызов и return; Поток и позиция чтения.

Тип в mode задаётся старшими битами: 0140000 socket, 0120000 link, 0100000 обычный файл, 0060000 block, 0040000 каталог, 0020000 char, 0010000 fifo. Нижние права — другая часть битовой маски.

<?php
declare(strict_types=1);

$stream = fopen(__DIR__ . '/pickup.txt', 'rb');
if ($stream === false) { throw new RuntimeException('Не открыть документ'); }
try {
    $info = fstat($stream);
    if ($info === false) { throw new RuntimeException('Не получить метаданные'); }
    echo 'Размер: ', $info['size'], " байт\n";
    echo 'Следующее чтение: ', fgets($stream);
} finally { fclose($stream); }

Размер: 11 байт
Следующее чтение: 104: ready

<?php
declare(strict_types=1);

$stream = fopen(__DIR__ . '/pickup.txt', 'w+b');
if ($stream === false) { throw new RuntimeException('Не создать отчёт'); }
try {
    fwrite($stream, "104: ready\n");
    fflush($stream);
    $info = fstat($stream);
    if ($info === false) { throw new RuntimeException('Не получить размер'); }
    rewind($stream);
    echo 'pickup.txt (', $info['size'], " байт):\n", stream_get_contents($stream);
} finally { fclose($stream); }

pickup.txt (11 байт):
104: ready

Применение и границы. Windows: uid/gid равны 0; blksize/blocks обычно −1. С PHP 7.4 dev — serial тома, ino — ID файла; это unsigned 64-bit значения и возможен выход за signed int (до 7.4 значения были иными). mode отражает readonly-атрибут одинаково для owner/group/other, не Windows ACL. На 32-bit возможны проблемы с файлами >2 ГБ; точность времени зависит от ФС. Не каждое поле имеет одинаковый смысл на разных ОС. Результат относится к моменту проверки и может кэшироваться; clearstatcache() обновляет stat-кэш, но не устраняет гонку между проверкой и действием. Для fstat нужен совместимый локальный файловый поток; удалённый HTTP-источник не получает такие гарантии.

Сравните: stat, lstat, filesize, filemtime, clearstatcache. Полный выбор файловых операций.

• PHP: fstat

PHP 4+ · standard

lstat(string $filename): array|false

Получить набор метаданных самой ссылки или обычного файла.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". try выполняет попытку, catch обрабатывает указанный отказ, finally освобождает ресурс и не подавляет ошибку. throw new RuntimeException сообщает о сбое. [...] создаёт массив; $row["size"] читает поле по ключу; [$a, $b] = ... раскладывает список. & оставляет биты маски, ~ инвертирует биты; число с ведущим 0 восьмеричное. Переменные; Вызов и return; Поток и позиция чтения.

Тип в mode задаётся старшими битами: 0140000 socket, 0120000 link, 0100000 обычный файл, 0060000 block, 0040000 каталог, 0020000 char, 0010000 fifo. Нижние права — другая часть битовой маски.

<?php
declare(strict_types=1);

$path = __DIR__ . '/pickup.txt';
$info = lstat($path);
if ($info === false) { throw new RuntimeException('Не получить метаданные'); }
echo basename($path), ': ', $info['size'], " байт\n";
echo $info['size'] === 0 ? "Пустой документ\n" : "Документ содержит данные\n";

pickup.txt: 11 байт
Документ содержит данные

<?php
$target = __DIR__ . '/target.txt';
$shortcut = __DIR__ . '/shortcut';
if (!symlink($target, $shortcut)) { throw new RuntimeException('Создание ссылки'); }
try {
    $linkInfo = lstat($shortcut);
    $fileInfo = stat($shortcut);
    if ($linkInfo === false || $fileInfo === false) { throw new RuntimeException('Метаданные'); }
    echo ($linkInfo['mode'] & 0170000) === 0120000 ? 'Ссылка' : 'Другой тип';
    echo "\n", $fileInfo['size'], "\n";
} finally { unlink($shortcut); }

Применение и границы. Windows: uid/gid равны 0; blksize/blocks обычно −1. С PHP 7.4 dev — serial тома, ino — ID файла; это unsigned 64-bit значения и возможен выход за signed int (до 7.4 значения были иными). mode отражает readonly-атрибут одинаково для owner/group/other, не Windows ACL. На 32-bit возможны проблемы с файлами >2 ГБ; точность времени зависит от ФС. Не каждое поле имеет одинаковый смысл на разных ОС. Результат относится к моменту проверки и может кэшироваться; clearstatcache() обновляет stat-кэш, но не устраняет гонку между проверкой и действием. Некоторые обёртки поддерживают stat, другие нет.

Сравните: stat, fstat, filesize, filemtime, clearstatcache. Полный выбор файловых операций.

• PHP: lstat

PHP 4+ · standard

filemtime(string $filename): int|false

Показать время последнего изменения содержимого отчёта.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". Переменные; Вызов и return; Поток и позиция чтения.

<?php
$path = __DIR__ . '/report.txt';
if (!touch($path, 1600000000, 1600000060)) { throw new RuntimeException('Время'); }
clearstatcache();
$time = filemtime($path);
if ($time === false) { throw new RuntimeException('Метаданные'); }
echo gmdate('Y-m-d H:i:s', $time), "\n";

2020-09-13 12:26:40

<?php
$path = __DIR__ . '/report.txt';
touch($path, 1600000000, 1600000060);
clearstatcache();
$stamp = filemtime($path);
if ($stamp === false) { throw new RuntimeException('Нет метки'); }
echo $stamp < 1600000100 ? 'Старше контрольного момента' : 'Новее';
echo "\n";

Старше контрольного момента

Применение и границы. Когда менялись блоки данных; подходит для «Обновлено». Это не всегда момент появления файла. Результат относится к моменту проверки и может кэшироваться; clearstatcache() обновляет stat-кэш, но не устраняет гонку между проверкой и действием. Точность и частота обновления зависят от ФС; некоторые wrappers поддерживают stat, не все.

Сравните: stat, touch, filectime. Полный выбор файловых операций.

• PHP: filemtime

PHP 4+ · standard

fileatime(string $filename): int|false

Исследовать время доступа к файлу.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". Переменные; Вызов и return; Поток и позиция чтения.

<?php
$path = __DIR__ . '/report.txt';
if (!touch($path, 1600000000, 1600000060)) { throw new RuntimeException('Время'); }
clearstatcache();
$time = fileatime($path);
if ($time === false) { throw new RuntimeException('Метаданные'); }
echo gmdate('Y-m-d H:i:s', $time), "\n";

2020-09-13 12:27:40

<?php
$path = __DIR__ . '/report.txt';
touch($path, 1600000000, 1600000060);
clearstatcache();
$stamp = fileatime($path);
if ($stamp === false) { throw new RuntimeException('Нет метки'); }
echo $stamp < 1600000100 ? 'Старше контрольного момента' : 'Новее';
echo "\n";

Старше контрольного момента

Применение и границы. Предполагаемое время чтения данных. noatime/relatime и политика ФС могут отключать/откладывать обновление; не журнал посещений. Результат относится к моменту проверки и может кэшироваться; clearstatcache() обновляет stat-кэш, но не устраняет гонку между проверкой и действием. Точность и частота обновления зависят от ФС; некоторые wrappers поддерживают stat, не все.

Сравните: stat, touch, filemtime. Полный выбор файловых операций.

• PHP: fileatime

PHP 4+ · standard

filectime(string $filename): int|false

Различать изменение inode и изменение содержимого.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". [...] создаёт массив; $row["size"] читает поле по ключу; [$a, $b] = ... раскладывает список. Переменные; Вызов и return; Поток и позиция чтения.

<?php
$stamp = filectime(__DIR__ . '/report.txt');
if ($stamp === false) { throw new RuntimeException('Нет метки'); }
echo get_debug_type($stamp), "\n";
var_dump($stamp > 0);

int
bool(true)

<?php
$record = ['created_at' => '2026-10-12T09:00:00Z', 'path' => __DIR__ . '/report.txt'];
$inodeChanged = filectime($record['path']);
if ($inodeChanged === false) { throw new RuntimeException('Нет метки'); }
echo $record['created_at'], "\n";
echo 'Метка файловой системы получена отдельно', "\n";

2026-10-12T09:00:00Z
Метка файловой системы получена отдельно

Применение и границы. На Unix меняется при изменении прав/владельца/группы/метаданных. ctime не означает creation time; на Windows платформа может связывать его с созданием, это не переносимый договор. Результат относится к моменту проверки и может кэшироваться; clearstatcache() обновляет stat-кэш, но не устраняет гонку между проверкой и действием. Точность и частота обновления зависят от ФС; некоторые wrappers поддерживают stat, не все.

Сравните: stat, touch, filemtime. Полный выбор файловых операций.

• PHP: filectime

PHP 4+ · standard

filesize(string $filename): int|false

Проверить размер небольшого файла до обработки или показать число байтов.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". Переменные; Вызов и return; Поток и позиция чтения.

<?php
echo filesize(__DIR__ . '/tea.txt'), "\n";
var_dump(filesize(__DIR__ . '/empty.txt'));

6
int(0)

<?php
$path = __DIR__ . '/import.txt';
$size = filesize($path);
if ($size === false) { throw new RuntimeException('Размер недоступен'); }
echo $size <= 1024 ? 'В пределах 1 КиБ' : 'Слишком большой';
echo "\n";

В пределах 1 КиБ

Применение и границы. Результат относится к моменту проверки и может кэшироваться; clearstatcache() обновляет stat-кэш, но не устраняет гонку между проверкой и действием. На 32-bit файлы >2 ГБ могут дать непригодный результат. Размер каталога не равен сумме его файлов; для рекурсии нужен отдельный обход. Не загружайте файл целиком только ради подсчёта размера.

Сравните: stat, file_get_contents, fread. Полный выбор файловых операций.

• PHP: filesize

PHP 4+ · standard

filetype(string $filename): string|false

Узнать вид записи файловой системы, не MIME содержимого.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. function name($x) { ... } объявляет повторяемое действие; return отдаёт результат вызову. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". Переменные; Вызов и return; Поток и позиция чтения.

<?php
echo filetype(__DIR__ . '/report.txt'), "\n";
echo filetype(__DIR__), "\n";

file
dir

<?php
declare(strict_types=1);

foreach (['report.txt', 'archive'] as $name) {
    $path = __DIR__ . '/' . $name;
    if (filetype($path) !== 'file') {
        echo 'Пропущен каталог: ', $name, "\n";
        continue;
    }
    echo 'Документ ', $name, ': ', file_get_contents($path);
}

Документ report.txt: 104: ready
Пропущен каталог: archive

Применение и границы. Результат относится к моменту проверки и может кэшироваться; clearstatcache() обновляет stat-кэш, но не устраняет гонку между проверкой и действием. link обозначает символическую ссылку; для решения «обычный файл по конечной цели» есть is_file. MIME проверяется отдельно, например через fileinfo. Не создавайте устройства/fifo для простого импорта.

Сравните: is_file, is_dir, is_link, lstat. Полный выбор файловых операций.

• PHP: filetype

PHP 4+ · standard

fileowner(string $filename): int|false

Получить числовой ID владельца для диагностики доступа.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". try выполняет попытку, catch обрабатывает указанный отказ, finally освобождает ресурс и не подавляет ошибку. throw new RuntimeException сообщает о сбое. [...] создаёт массив; $row["size"] читает поле по ключу; [$a, $b] = ... раскладывает список. Переменные; Вызов и return; Поток и позиция чтения.

<?php
$first = fileowner(__DIR__ . '/a.txt');
$second = fileowner(__DIR__ . '/b.txt');
if ($first === false || $second === false) { throw new RuntimeException('ID недоступен'); }
echo get_debug_type($first), "\n";
var_dump($first === $second);

int
bool(true)

<?php
$id = fileowner(__DIR__ . '/report.txt');
if ($id === false) { throw new RuntimeException('ID недоступен'); }
$entry = posix_getpwuid($id);
if ($entry === false) { throw new RuntimeException('Имя не найдено'); }
echo $entry['name'], "\n";

Применение и границы. Результат относится к моменту проверки и может кэшироваться; clearstatcache() обновляет stat-кэш, но не устраняет гонку между проверкой и действием. UID/GID владельца файла не равен пользователю приложения из сессии. Веб-процесс работает под системной учётной записью сервера. ACL/группы и права прохода по каталогам также влияют на доступ.

Сравните: stat, filegroup, is_readable. Полный выбор файловых операций.

• PHP: fileowner

PHP 4+ · standard

filegroup(string $filename): int|false

Получить числовой ID группы для диагностики доступа.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". try выполняет попытку, catch обрабатывает указанный отказ, finally освобождает ресурс и не подавляет ошибку. throw new RuntimeException сообщает о сбое. [...] создаёт массив; $row["size"] читает поле по ключу; [$a, $b] = ... раскладывает список. Переменные; Вызов и return; Поток и позиция чтения.

<?php
$first = filegroup(__DIR__ . '/a.txt');
$second = filegroup(__DIR__ . '/b.txt');
if ($first === false || $second === false) { throw new RuntimeException('ID недоступен'); }
echo get_debug_type($first), "\n";
var_dump($first === $second);

int
bool(true)

<?php
$id = filegroup(__DIR__ . '/report.txt');
if ($id === false) { throw new RuntimeException('ID недоступен'); }
$entry = posix_getgrgid($id);
if ($entry === false) { throw new RuntimeException('Имя не найдено'); }
echo $entry['name'], "\n";

Применение и границы. Результат относится к моменту проверки и может кэшироваться; clearstatcache() обновляет stat-кэш, но не устраняет гонку между проверкой и действием. UID/GID владельца файла не равен пользователю приложения из сессии. Веб-процесс работает под системной учётной записью сервера. ACL/группы и права прохода по каталогам также влияют на доступ.

Сравните: stat, fileowner, is_readable. Полный выбор файловых операций.

• PHP: filegroup

PHP 4+ · standard

fileinode(string $filename): int|false

Получить файловый идентификатор и понять, что два жёстких имени могут вести к одному файлу.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". try выполняет попытку, catch обрабатывает указанный отказ, finally освобождает ресурс и не подавляет ошибку. throw new RuntimeException сообщает о сбое. [...] создаёт массив; $row["size"] читает поле по ключу; [$a, $b] = ... раскладывает список. Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

$original = __DIR__ . '/pickup.txt';
$alias = __DIR__ . '/copy-name.txt';
if (!link($original, $alias)) { throw new RuntimeException('Не создать второе имя'); }
try {
    echo fileinode($original) === fileinode($alias)
        ? "Один файл под двумя именами.\n" : "Разные файловые записи.\n";
    file_put_contents($alias, "104: выдан\n");
    echo 'Через исходное имя: ', file_get_contents($original);
} finally { unlink($alias); }

Один файл под двумя именами.
Через исходное имя: 104: выдан

<?php
$path = __DIR__ . '/a.txt';
$info = stat($path);
$inode = fileinode($path);
if ($info === false || $inode === false) { throw new RuntimeException('Метаданные'); }
$identity = ['device' => $info['dev'], 'inode' => $inode];
echo implode(', ', array_keys($identity)), "\n";

device, inode

Применение и границы. Результат относится к моменту проверки и может кэшироваться; clearstatcache() обновляет stat-кэш, но не устраняет гонку между проверкой и действием. Идентификаторы могут переиспользоваться после удаления. На Windows до PHP 7.4 inode всегда был 0, теперь это 64-битный ID с возможным переполнением signed int. Сравнение путей не заменяется одним inode без учёта тома.

Сравните: stat, link, lstat. Полный выбор файловых операций.

• PHP: fileinode

PHP 4+ · standard

fileperms(string $filename): int|false

Исследовать биты типа и прав доступа, не смешивая их с итоговой проверкой доступа процесса.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". & оставляет биты маски, ~ инвертирует биты; число с ведущим 0 восьмеричное. Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

$mode = fileperms(__DIR__ . '/pickup.txt');
if ($mode === false) { throw new RuntimeException('Режим недоступен'); }
$type = $mode & 0170000;
echo $type === 0100000 ? "pickup.txt: обычный файл\n" : "pickup.txt: другой тип\n";

pickup.txt: обычный файл

<?php
$path = __DIR__ . '/report.txt';
if (!chmod($path, 0640)) { throw new RuntimeException('Права'); }
clearstatcache();
$mode = fileperms($path);
if ($mode === false) { throw new RuntimeException('Режим'); }
printf("%04o\n", $mode & 07777);

Применение и границы. На POSIX 0400/0200/0100 — r/w/x владельца, 0040/0020/0010 группы, 0004/0002/0001 остальных; 04000 setuid, 02000 setgid, 01000 sticky. Для каталога x означает проход. Windows: uid/gid равны 0; blksize/blocks обычно −1. С PHP 7.4 dev — serial тома, ino — ID файла; это unsigned 64-bit значения и возможен выход за signed int (до 7.4 значения были иными). mode отражает readonly-атрибут одинаково для owner/group/other, не Windows ACL. На 32-bit возможны проблемы с файлами >2 ГБ; точность времени зависит от ФС. Не каждое поле имеет одинаковый смысл на разных ОС. Результат относится к моменту проверки и может кэшироваться; clearstatcache() обновляет stat-кэш, но не устраняет гонку между проверкой и действием.

Сравните: chmod, stat, is_readable, is_writable. Полный выбор файловых операций.

• PHP: fileperms

PHP 4+ · standard

file_exists(string $filename): bool

Проверить наличие файла или каталога.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. function name($x) { ... } объявляет повторяемое действие; return отдаёт результат вызову. Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

foreach (['pickup.txt', 'missing.txt'] as $name) {
    $path = __DIR__ . '/' . $name;
    if (file_exists($path) && is_file($path)) {
        echo 'Памятка ', $name, ': ', file_get_contents($path);
    } else {
        echo 'Нет подходящей памятки: ', $name, "\n";
    }
}

Памятка pickup.txt: 104: ready
Нет подходящей памятки: missing.txt

<?php
declare(strict_types=1);

foreach (['pickup.txt', 'archive'] as $name) {
    $path = __DIR__ . '/' . $name;
    $accepted = file_exists($path) && is_file($path);
    echo $name, $accepted ? ": можно предложить как файл\n" : ": не предлагать как файл\n";
}

pickup.txt: можно предложить как файл
archive: не предлагать как файл

Применение и границы. Проверка не утверждает, что цель обычный файл или доступна для чтения. Windows UNC-путь использует //computer/share/file либо \\computer\share\file; проверка описана через real UID/GID. Результат относится к моменту проверки и может кэшироваться; clearstatcache() обновляет stat-кэш, но не устраняет гонку между проверкой и действием. Некоторые wrappers умеют stat; это не общий способ проверить HTTP URL. Это не разрешение доступа и не защита от подмены пути. Пользователь выбирает разрешённый идентификатор, приложение задаёт путь; права ОС и проверки самой операции остаются обязательными.

Сравните: is_file, is_dir, is_readable, is_writable, clearstatcache. Полный выбор файловых операций.

• PHP: file_exists

PHP 4+ · standard

is_dir(string $filename): bool

Отличить каталог от обычного файла.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. function name($x) { ... } объявляет повторяемое действие; return отдаёт результат вызову. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

foreach (['pickup.txt', 'archive'] as $name) {
    echo $name, is_dir(__DIR__ . '/' . $name) ? ": папка\n" : ": документ\n";
}

pickup.txt: документ
archive: папка

<?php
declare(strict_types=1);

$folder = __DIR__ . '/pickup';
if (!is_dir($folder) && !mkdir($folder)) {
    throw new RuntimeException('Не создать папку выдачи');
}
$path = $folder . '/104.txt';
$text = "Выдать две дрели\n";
if (file_put_contents($path, $text) !== strlen($text)) { throw new RuntimeException('Не записать памятку'); }
echo 'pickup/104.txt: ', file_get_contents($path);

pickup/104.txt: Выдать две дрели

Применение и границы. CWD влияет на относительный путь. open_basedir может дополнительно ограничивать доступ; ссылка на каталог также даст true. Результат относится к моменту проверки и может кэшироваться; clearstatcache() обновляет stat-кэш, но не устраняет гонку между проверкой и действием. Некоторые wrappers умеют stat; это не общий способ проверить HTTP URL. Это не разрешение доступа и не защита от подмены пути. Пользователь выбирает разрешённый идентификатор, приложение задаёт путь; права ОС и проверки самой операции остаются обязательными.

Сравните: file_exists, is_file, is_readable, is_writable, clearstatcache. Полный выбор файловых операций.

• PHP: is_dir

PHP 4+ · standard

is_file(string $filename): bool

Отобрать только обычные файлы по конечной цели.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. function name($x) { ... } объявляет повторяемое действие; return отдаёт результат вызову. Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

foreach (['pickup.txt', 'missing.txt'] as $name) {
    $path = __DIR__ . '/' . $name;
    if (is_file($path)) {
        echo 'Памятка ', $name, ': ', file_get_contents($path);
    } else {
        echo 'Нет подходящей памятки: ', $name, "\n";
    }
}

Памятка pickup.txt: 104: ready
Нет подходящей памятки: missing.txt

<?php
declare(strict_types=1);

foreach (['pickup.txt', 'archive'] as $name) {
    $path = __DIR__ . '/' . $name;
    $accepted = is_file($path) && is_file($path);
    echo $name, $accepted ? ": можно предложить как файл\n" : ": не предлагать как файл\n";
}

pickup.txt: можно предложить как файл
archive: не предлагать как файл

Применение и границы. Символическая ссылка на обычный файл даст true. Для запрета самой ссылки дополнительно проверяют is_link, но две проверки сами по себе не устраняют гонку. Результат относится к моменту проверки и может кэшироваться; clearstatcache() обновляет stat-кэш, но не устраняет гонку между проверкой и действием. Некоторые wrappers умеют stat; это не общий способ проверить HTTP URL. Это не разрешение доступа и не защита от подмены пути. Пользователь выбирает разрешённый идентификатор, приложение задаёт путь; права ОС и проверки самой операции остаются обязательными.

Сравните: file_exists, is_dir, is_readable, is_writable, clearstatcache. Полный выбор файловых операций.

• PHP: is_file

PHP 4+ · standard

is_readable(string $filename): bool

Предварительно проверить возможность чтения существующего пути.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. function name($x) { ... } объявляет повторяемое действие; return отдаёт результат вызову. Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

foreach (['pickup.txt', 'missing.txt'] as $name) {
    $path = __DIR__ . '/' . $name;
    if (is_readable($path) && is_file($path)) {
        echo 'Памятка ', $name, ': ', file_get_contents($path);
    } else {
        echo 'Нет подходящей памятки: ', $name, "\n";
    }
}

Памятка pickup.txt: 104: ready
Нет подходящей памятки: missing.txt

<?php
declare(strict_types=1);

foreach (['pickup.txt', 'archive'] as $name) {
    $path = __DIR__ . '/' . $name;
    $accepted = is_readable($path) && is_file($path);
    echo $name, $accepted ? ": можно предложить как файл\n" : ": не предлагать как файл\n";
}

pickup.txt: можно предложить как файл
archive: не предлагать как файл

Применение и границы. На POSIX проверяется real UID/GID, не effective. Пользователь ОС веб-сервера может отличаться от CLI. Читаемый каталог не является файлом. Результат относится к моменту проверки и может кэшироваться; clearstatcache() обновляет stat-кэш, но не устраняет гонку между проверкой и действием. Некоторые wrappers умеют stat; это не общий способ проверить HTTP URL. Это не разрешение доступа и не защита от подмены пути. Пользователь выбирает разрешённый идентификатор, приложение задаёт путь; права ОС и проверки самой операции остаются обязательными.

Сравните: file_exists, is_file, is_dir, is_writable, clearstatcache. Полный выбор файловых операций.

• PHP: is_readable

PHP 4+ · standard

is_writable(string $filename): bool

Проверить запись в существующий файл либо каталог назначения.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

$future = __DIR__ . '/pickup.txt';
echo is_writable($future) ? "Файл допускает запись\n" : "Будущий файл ещё не существует\n";
echo is_writable(dirname($future)) ? "Родитель допускает создание файла\n" : "Нет доступа к родителю\n";

Будущий файл ещё не существует
Родитель допускает создание файла

<?php
declare(strict_types=1);

$folder = __DIR__;
if (!is_writable($folder)) { throw new RuntimeException('Нет доступа к учебной папке'); }
$path = $folder . '/pickup.txt';
$text = "Заказ 104 готов\n";
if (file_put_contents($path, $text) !== strlen($text)) { throw new RuntimeException('Запись не завершена'); }
echo file_get_contents($path);

Заказ 104 готов

Применение и границы. Для будущего файла проверяют родительский каталог, но успешное создание всё равно может сорваться: права, квота, место, гонка. Существующий файл и право создать новый — разные проверки. Результат относится к моменту проверки и может кэшироваться; clearstatcache() обновляет stat-кэш, но не устраняет гонку между проверкой и действием. Некоторые wrappers умеют stat; это не общий способ проверить HTTP URL. Это не разрешение доступа и не защита от подмены пути. Пользователь выбирает разрешённый идентификатор, приложение задаёт путь; права ОС и проверки самой операции остаются обязательными.

Сравните: file_exists, is_file, is_dir, is_readable, clearstatcache. Полный выбор файловых операций.

• PHP: is_writable

PHP 4+ · standard

is_writeable(string $filename): bool

Распознать альтернативное имя is_writable в старом проекте.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

$future = __DIR__ . '/pickup.txt';
echo is_writeable($future) ? "Файл допускает запись\n" : "Будущий файл ещё не существует\n";
echo is_writeable(dirname($future)) ? "Родитель допускает создание файла\n" : "Нет доступа к родителю\n";

Будущий файл ещё не существует
Родитель допускает создание файла

<?php
declare(strict_types=1);

$folder = __DIR__;
if (!is_writeable($folder)) { throw new RuntimeException('Нет доступа к учебной папке'); }
$path = $folder . '/pickup.txt';
$text = "Заказ 104 готов\n";
if (file_put_contents($path, $text) !== strlen($text)) { throw new RuntimeException('Запись не завершена'); }
echo file_get_contents($path);

Заказ 104 готов

Применение и границы. Alias не исправляет проблемы предшествующей проверки. В новом коде удобно последовательно использовать is_writable. Результат относится к моменту проверки и может кэшироваться; clearstatcache() обновляет stat-кэш, но не устраняет гонку между проверкой и действием. Некоторые wrappers умеют stat; это не общий способ проверить HTTP URL. Это не разрешение доступа и не защита от подмены пути. Пользователь выбирает разрешённый идентификатор, приложение задаёт путь; права ОС и проверки самой операции остаются обязательными.

Сравните: file_exists, is_file, is_dir, is_readable, is_writable, clearstatcache. Полный выбор файловых операций.

• PHP: is_writeable

PHP 4+ · standard

is_link(string $filename): bool

Проверить, является ли сама запись символической ссылкой.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". try выполняет попытку, catch обрабатывает указанный отказ, finally освобождает ресурс и не подавляет ошибку. throw new RuntimeException сообщает о сбое. Переменные; Вызов и return; Поток и позиция чтения.

<?php
var_dump(is_link(__DIR__ . '/a.txt'));
var_dump(is_link(__DIR__ . '/missing'));

bool(false)
bool(false)

<?php
$path = __DIR__ . '/shortcut';
if (!symlink('missing-target.txt', $path)) { throw new RuntimeException('Создание ссылки'); }
try {
    var_dump(is_link($path));
    var_dump(file_exists($path));
} finally { unlink($path); }

Применение и границы. Результат относится к моменту проверки и может кэшироваться; clearstatcache() обновляет stat-кэш, но не устраняет гонку между проверкой и действием. is_file/is_dir идут по ссылке, is_link исследует саму запись. Это не проверка hard link: у него нет отдельного «ссылочного» типа. Без контроля родительского каталога результат можно подменить до следующего вызова.

Сравните: readlink, symlink, lstat, file_exists. Полный выбор файловых операций.

• PHP: is_link

PHP 4+ · standard

is_executable(string $filename): bool

Предварительно узнать, считает ли ОС файл исполняемым.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". Переменные; Вызов и return; Поток и позиция чтения.

<?php
var_dump(is_executable(__DIR__ . '/README.txt'));
var_dump(is_executable(__DIR__ . '/missing'));

bool(false)
bool(false)

<?php
$path = __DIR__ . '/worker.sh';
if (!chmod($path, 0700)) { throw new RuntimeException('Права'); }
clearstatcache();
var_dump(is_executable($path));

Применение и границы. На POSIX важны исполняемые биты и доступ к пути. Windows с PHP 7.4 использует GetBinaryType, а .bat/.cmd оставлены исполняемыми для совместимости; PATHEXT не учитывается. Ранее хватало непустого .exe/.com. Это не разрешение запускать присланный пользователем файл. Результат относится к моменту проверки и может кэшироваться; clearstatcache() обновляет stat-кэш, но не устраняет гонку между проверкой и действием.

Сравните: fileperms, chmod, is_file. Полный выбор файловых операций.

• PHP: is_executable

PHP 4.1+ · standard

disk_free_space(string $directory): float|false

Узнать доступное место файловой системы, содержащей каталог.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". Переменные; Вызов и return; Поток и позиция чтения.

<?php
$bytes = disk_free_space(__DIR__);
if ($bytes === false) { throw new RuntimeException('Объём недоступен'); }
echo get_debug_type($bytes), "\n";
var_dump($bytes >= 0);

float
bool(true)

<?php
$bytes = disk_free_space(__DIR__);
if ($bytes === false) { throw new RuntimeException('Объём недоступен'); }
$plannedBytes = 1024;
echo $bytes >= $plannedBytes ? 'Объём больше учебного экспорта' : 'Объём меньше экспорта';
echo "\n";

Объём больше учебного экспорта

Применение и границы. Не работает для произвольного удалённого URL. Байты не равны МиБ: для представления делят на 1024², но сам результат уже float и не является произвольной точности целым. Для размера дерева нужен обход файлов.

Сравните: disk_total_space, filesize. Полный выбор файловых операций.

• PHP: disk_free_space

PHP 4.1+ · standard

disk_total_space(string $directory): float|false

Узнать общий объём файловой системы, содержащей каталог.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". Переменные; Вызов и return; Поток и позиция чтения.

<?php
$bytes = disk_total_space(__DIR__);
if ($bytes === false) { throw new RuntimeException('Объём недоступен'); }
echo get_debug_type($bytes), "\n";
var_dump($bytes >= 0);

float
bool(true)

<?php
$bytes = disk_total_space(__DIR__);
if ($bytes === false) { throw new RuntimeException('Объём недоступен'); }
$plannedBytes = 1024;
echo $bytes >= $plannedBytes ? 'Объём больше учебного экспорта' : 'Объём меньше экспорта';
echo "\n";

Объём больше учебного экспорта

Применение и границы. Не работает для произвольного удалённого URL. Байты не равны МиБ: для представления делят на 1024², но сам результат уже float и не является произвольной точности целым. Для размера дерева нужен обход файлов.

Сравните: disk_free_space, filesize. Полный выбор файловых операций.

• PHP: disk_total_space

PHP 4+ · standard

diskfreespace(string $directory): float|false

Альтернативное имя disk_free_space: узнать доступное место.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". Переменные; Вызов и return; Поток и позиция чтения.

<?php
$bytes = diskfreespace(__DIR__);
if ($bytes === false) { throw new RuntimeException('Объём недоступен'); }
echo get_debug_type($bytes), "\n";
var_dump($bytes >= 0);

float
bool(true)

<?php
$bytes = diskfreespace(__DIR__);
if ($bytes === false) { throw new RuntimeException('Объём недоступен'); }
$plannedBytes = 1024;
echo $bytes >= $plannedBytes ? 'Объём больше учебного экспорта' : 'Объём меньше экспорта';
echo "\n";

Объём больше учебного экспорта

Применение и границы. Не работает для произвольного удалённого URL. Alias имеет тот же договор и не выполняет другую проверку. Байты не равны МиБ: для представления делят на 1024², но сам результат уже float и не является произвольной точности целым. Для размера дерева нужен обход файлов.

Сравните: disk_free_space, disk_total_space, filesize. Полный выбор файловых операций.

• PHP: diskfreespace

PHP 4+ · standard

fclose(resource $stream): bool

Закрыть поток после последней операции и освободить файловый дескриптор.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. fopen возвращает открытый поток (resource), а не содержимое файла. rb читает байты, w+b создаёт/очищает файл и разрешает чтение с записью. fclose освобождает поток. try выполняет попытку, catch обрабатывает указанный отказ, finally освобождает ресурс и не подавляет ошибку. throw new RuntimeException сообщает о сбое. Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

$path = __DIR__ . '/pickup.txt';
$stream = fopen($path, 'rb');
if ($stream === false) { throw new RuntimeException('Не открыть памятку'); }
echo fgets($stream);
if (!fclose($stream)) { throw new RuntimeException('Не закрыть поток'); }
echo 'После закрытия файл читается заново: ', file_get_contents($path);

104: ready
После закрытия файл читается заново: 104: ready

<?php
declare(strict_types=1);

$stream = fopen(__DIR__ . '/order.json', 'rb');
if ($stream === false) { throw new RuntimeException('Не открыть заказ'); }
try {
    try { json_decode(stream_get_contents($stream), true, 8, JSON_THROW_ON_ERROR); }
    finally { fclose($stream); }
} catch (JsonException $error) {
    echo "Заказ не импортирован: исправьте JSON.\n";
}
echo is_resource($stream) ? "Поток ещё открыт.\n" : "Файл закрыт после отказа.\n";

Заказ не импортирован: исправьте JSON.
Файл закрыт после отказа.

Применение и границы. Закрытие не означает бизнес-успех импорта и не обещает сохранность при отключении питания. Для процесса popen используйте pclose, чтобы получить статус дочерней программы.

Сравните: fopen, fflush, fsync, pclose. Полный выбор файловых операций.

• PHP: fclose

PHP 4+; nullable length с PHP 8.0 · standard

fputs(resource $stream, string $data, ?int $length = null): int|false

Псевдоним fwrite с теми же параметрами и правилами. Записать байты в открытый поток и узнать, сколько удалось записать.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. fopen возвращает открытый поток (resource), а не содержимое файла. rb читает байты, w+b создаёт/очищает файл и разрешает чтение с записью. fclose освобождает поток. function name($x) { ... } объявляет повторяемое действие; return отдаёт результат вызову. while (условие) повторяет блок, пока условие истинно; после чтения важно различать конец и ошибку. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". try выполняет попытку, catch обрабатывает указанный отказ, finally освобождает ресурс и не подавляет ошибку. throw new RuntimeException сообщает о сбое. Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

$path = __DIR__ . '/pickup.txt';
$stream = fopen($path, 'w+b');
if ($stream === false) { throw new RuntimeException('Не создать памятку'); }
try {
    fputs($stream, "Выдача заказа 104\n");
    fputs($stream, "Дрель: 2\n");
    rewind($stream);
    echo stream_get_contents($stream);
} finally { fclose($stream); }

Выдача заказа 104
Дрель: 2

<?php
function writeBytes($h, $data) {
    $offset = 0;
    while ($offset < strlen($data)) {
        $written = fputs($h, substr($data, $offset));
        if ($written === false || $written === 0) { throw new RuntimeException('write stopped'); }
        $offset += $written;
    }
    return $offset;
}
$h = fopen(__DIR__ . '/result.txt', 'w+b');
try { echo writeBytes($h, "104: ready\n"), "
"; }
finally { fclose($h); }
echo file_get_contents(__DIR__ . '/result.txt');

11
104: ready

Применение и границы. На сети возможна частичная запись. В append-режиме локальная ОС может обеспечивать неделимость одного небольшого write, но оговорки платформы, размера блока и файловой системы не дают общего обещания для записи из нескольких вызовов или чтения–изменения–записи. Для общей договорённости процессов нужен flock; для долговечности отдельно fflush/fsync. b сохраняет двоичные данные.

Сравните: fwrite, file_put_contents, flock, fflush. Полный выбор файловых операций.

• PHP: fputs

PHP 4+ · standard

fgetc(resource $stream): string|false

Получить один байт; строка "0" — полноценные данные.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. fopen возвращает открытый поток (resource), а не содержимое файла. rb читает байты, w+b создаёт/очищает файл и разрешает чтение с записью. fclose освобождает поток. while (условие) повторяет блок, пока условие истинно; после чтения важно различать конец и ошибку. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". [...] создаёт массив; $row["size"] читает поле по ключу; [$a, $b] = ... раскладывает список. Переменные; Вызов и return; Поток и позиция чтения.

<?php
$h = fopen(__DIR__ . '/flags.txt', 'rb');
while (($byte = fgetc($h)) !== false) { echo '[', $byte, ']'; }
fclose($h);
echo "
";

[0][A]

<?php
$h = fopen(__DIR__ . '/letter.txt', 'rb');
echo bin2hex(fgetc($h)), ' ', bin2hex(fgetc($h)), "
";
fclose($h);

d0 af

Применение и границы. Подходит для небольшого байтового протокола. Для большого файла вызов на каждый байт часто создаёт лишние вызовы PHP: fread порциями удобнее. Не используйте как Unicode-итератор.

Сравните: fgets, fread, feof. Полный выбор файловых операций.

• PHP: fgetc

PHP 4+ · standard

feof(resource $stream): bool

Узнать состояние конца потока после чтения; это не прогноз успешности следующего чтения.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. fopen возвращает открытый поток (resource), а не содержимое файла. rb читает байты, w+b создаёт/очищает файл и разрешает чтение с записью. fclose освобождает поток. while (условие) повторяет блок, пока условие истинно; после чтения важно различать конец и ошибку. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". try выполняет попытку, catch обрабатывает указанный отказ, finally освобождает ресурс и не подавляет ошибку. throw new RuntimeException сообщает о сбое. Переменные; Вызов и return; Поток и позиция чтения.

<?php
$h = fopen(__DIR__ . '/one.txt', 'rb');
var_dump(feof($h));
echo fgetc($h), "
";
var_dump(fgetc($h), feof($h));
fclose($h);

bool(false)
A
bool(false)
bool(true)

<?php
declare(strict_types=1);

$stream = fopen(__DIR__ . '/orders.txt', 'rb');
if ($stream === false) { throw new RuntimeException('Не открыть заявки'); }
try {
    while (($line = fgets($stream)) !== false) {
        echo 'Принята заявка: ', rtrim($line, "\r\n"), "\n";
    }
    if (!feof($stream)) { throw new RuntimeException('Чтение прервано'); }
} finally { fclose($stream); }

Принята заявка: 0
Принята заявка: 104

Применение и границы. Для сокета true может означать тайм-аут, а ожидание данных способно блокировать. Настройте время ожидания и анализируйте stream_get_meta_data, лимит объёма и общий бюджет. feof не является гарантией полноты прикладного сообщения.

Сравните: fgets, fread, fgetc. Полный выбор файловых операций.

• PHP: feof

PHP 4+ · standard

fseek(resource $stream, int $offset, int $whence = SEEK_SET): int

Переставить позицию в байтах: от начала, текущего места или конца.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. fopen возвращает открытый поток (resource), а не содержимое файла. rb читает байты, w+b создаёт/очищает файл и разрешает чтение с записью. fclose освобождает поток. Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

$stream = fopen(__DIR__ . '/stock.txt', 'rb');
if ($stream === false) { throw new RuntimeException('Не открыть остаток'); }
try {
    if (fseek($stream, -2, SEEK_END) !== 0) { throw new RuntimeException('Не перейти к количеству'); }
    echo 'Чай на складе: ', fread($stream, 2), " шт.\n";
} finally { fclose($stream); }

Чай на складе: 12 шт.

<?php
$h = fopen(__DIR__ . '/gap.bin', 'w+b');
fwrite($h, 'A');
fseek($h, 3, SEEK_SET);
fwrite($h, 'B');
rewind($h);
echo bin2hex(fread($h, 4)), "
";
fclose($h);

41000042

Применение и границы. В append запись всё равно идёт в конец. Не все обёртки поддерживают seek; движение вперёд иногда имитируется чтением и отбрасыванием, поэтому это может быть дорого и не обеспечивает произвольный доступ. Для UTF-8 нельзя считать байтовую позицию номером буквы.

Сравните: ftell, rewind, ftruncate. Полный выбор файловых операций.

• PHP: fseek

PHP 4+ · standard

ftell(resource $stream): int|false

Получить текущий байтовый адрес чтения или записи.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. fopen возвращает открытый поток (resource), а не содержимое файла. rb читает байты, w+b создаёт/очищает файл и разрешает чтение с записью. fclose освобождает поток. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

$stream = fopen(__DIR__ . '/orders.txt', 'rb');
if ($stream === false) { throw new RuntimeException('Не открыть заявки'); }
try {
    echo 'Первая заявка: ', fgets($stream);
    echo 'Следующая начинается с байта: ', ftell($stream), "\n";
    echo 'Вторая заявка: ', fgets($stream);
} finally { fclose($stream); }

Первая заявка: 104
Следующая начинается с байта: 4
Вторая заявка: 105

<?php
declare(strict_types=1);

$stream = fopen(__DIR__ . '/orders.txt', 'rb');
if ($stream === false) { throw new RuntimeException('Не открыть заявки'); }
try {
    fgets($stream);
    $checkpoint = ftell($stream);
    if ($checkpoint === false) { throw new RuntimeException('Нет позиции'); }
    echo 'Предпросмотр: ', fgets($stream);
    if (fseek($stream, $checkpoint) !== 0) { throw new RuntimeException('Не вернуться к записи'); }
    echo 'В обработку: ', fgets($stream);
} finally { fclose($stream); }

Предпросмотр: 105
В обработку: 105

Применение и границы. Ограничения размера PHP int особенно заметны в 32-битных сборках на файлах >2 ГиБ. Для CWD/сетевых/append-потоков не обещайте одинаковой семантики. При сохранении checkpoint отдельно фиксируйте версию файла.

Сравните: fseek, rewind. Полный выбор файловых операций.

• PHP: ftell

PHP 4+ · standard

rewind(resource $stream): bool

Вернуться к началу потока; содержимое при этом не очищается.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. fopen возвращает открытый поток (resource), а не содержимое файла. rb читает байты, w+b создаёт/очищает файл и разрешает чтение с записью. fclose освобождает поток. Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

$stream = fopen(__DIR__ . '/pickup.txt', 'rb');
if ($stream === false) { throw new RuntimeException('Не открыть список'); }
try {
    echo 'Первый просмотр: ', fgets($stream);
    if (!rewind($stream)) { throw new RuntimeException('Не вернуться в начало'); }
    echo 'Повторный просмотр: ', fgets($stream);
} finally { fclose($stream); }

Первый просмотр: 104: ready
Повторный просмотр: 104: ready

<?php
declare(strict_types=1);

$stream = fopen(__DIR__ . '/state.txt', 'r+b');
if ($stream === false) { throw new RuntimeException('Не открыть состояние'); }
try {
    fwrite($stream, 'ready');
    rewind($stream);
    echo 'Без обрезания: ', stream_get_contents($stream), "\n";
    if (!ftruncate($stream, strlen('ready')) || !rewind($stream)) {
        throw new RuntimeException('Не завершить замену');
    }
    echo 'После обрезания: ', stream_get_contents($stream), "\n";
} finally { fclose($stream); }

Без обрезания: readyssing
После обрезания: ready

Применение и границы. Не путайте перемотку, обнуление и закрытие. При общей записи подготовьте блокировку до изменения.

Сравните: fseek, ftruncate, flock. Полный выбор файловых операций.

• PHP: rewind

PHP 4+ · standard

ftruncate(resource $stream, int $size): bool

Изменить длину открытого файла, не перемещая текущую позицию.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. fopen возвращает открытый поток (resource), а не содержимое файла. rb читает байты, w+b создаёт/очищает файл и разрешает чтение с записью. fclose освобождает поток. Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

$stream = fopen(__DIR__ . '/orders.txt', 'r+b');
if ($stream === false) { throw new RuntimeException('Не открыть заявки'); }
try {
    fgets($stream);
    $endOfFirst = ftell($stream);
    if ($endOfFirst === false || !ftruncate($stream, $endOfFirst)) {
        throw new RuntimeException('Не удалить отменённую заявку');
    }
    echo 'Позиция после обрезания: ', ftell($stream), "\n";
    rewind($stream);
    echo 'Осталась заявка: ', stream_get_contents($stream);
} finally { fclose($stream); }

Позиция после обрезания: 4
Осталась заявка: 104

<?php
$h = fopen(__DIR__ . '/data.txt', 'r+b');
ftruncate($h, 4);
echo bin2hex(fread($h, 4)), "
";
fclose($h);

41420000

Применение и границы. При c+ и LOCK_EX обнуляйте только после получения блокировки. Для текстового обрезания на UTF-8 границе сначала определите корректную байтовую позицию.

Сравните: fopen, rewind, flock. Полный выбор файловых операций.

• PHP: ftruncate

PHP 4+ · standard

fpassthru(resource $stream): int

Отправить оставшиеся байты потока в вывод, а не вернуть их строкой.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. fopen возвращает открытый поток (resource), а не содержимое файла. rb читает байты, w+b создаёт/очищает файл и разрешает чтение с записью. fclose освобождает поток. Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

$stream = fopen(__DIR__ . '/document.txt', 'rb');
if ($stream === false) { throw new RuntimeException('Не открыть документ'); }
try {
    fgets($stream);
    $bytes = fpassthru($stream);
    echo 'Выведено: ', $bytes, " байт\n";
} finally { fclose($stream); }

104: ready
Выведено: 11 байт

<?php
$h = fopen(__DIR__ . '/report.txt', 'rb');
ob_start();
$bytes = fpassthru($h);
$body = ob_get_clean();
fclose($h);
echo $body, ':', $bytes, "
";

OK:2

Применение и границы. Для HTTP скачивания сначала проверьте доступ к документу и отправьте заголовки до тела. Content-Length должен относиться к фактически отдаваемым байтам; нельзя добавлять echo после двоичного файла. После записи перед выводом нужен rewind. Для целого файла проще readfile.

Сравните: readfile, rewind, fread. Полный выбор файловых операций.

• PHP: fpassthru

PHP 4+ · standard

readfile(string $filename, bool $use_include_path = false, ?resource $context = null): int|false

Отдать весь файл в вывод; переменная получит число байтов, не текст.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". [...] создаёт массив; $row["size"] читает поле по ключу; [$a, $b] = ... раскладывает список. Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

$bytes = readfile(__DIR__ . '/pickup.txt');
if ($bytes === false) { throw new RuntimeException('Не показать памятку'); }
echo 'Выведено: ', $bytes, " байт\n";

104: ready
Выведено: 11 байт

<?php
$documents = ['rules' => __DIR__ . '/rules.txt'];
$id = 'rules';
if (!isset($documents[$id])) { throw new RuntimeException('unknown document'); }
if (readfile($documents[$id]) === false) { throw new RuntimeException('read'); }

RULES

Применение и границы. Сама функция передаёт файл порциями, но output buffering/веб-сервер/прокси могут накопить ответ. Для больших выгрузок учитывайте весь маршрут и тайм-аут запроса. Файл PHP здесь читается как данные, а не исполняется; не отдавайте исходники и секретные конфиги.

Сравните: fpassthru, file_get_contents, file. Полный выбор файловых операций.

• PHP: readfile

PHP 4+ · standard

file(string $filename, int $flags = 0, ?resource $context = null): array|false

Получить весь небольшой файл как массив строк.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. foreach берёт элементы массива по одному, форма as $key => $value также читает ключ. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". | объединяет поддерживаемые флаги; это допустимо только для параметра-маски. Переменные; Вызов и return; Поток и позиция чтения.

<?php
$rows = file(__DIR__ . '/names.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
echo json_encode($rows), "
";

["Tea","Coffee"]

<?php
$rows = file(__DIR__ . '/guide.txt', FILE_IGNORE_NEW_LINES);
if ($rows === false) { throw new RuntimeException('read'); }
foreach ($rows as $index => $line) { echo $index + 1, ': ', $line, "
"; }

1: Open
2: Save

Применение и границы. В памяти одновременно массив и строки: большой журнал обрабатывайте fgets. Для CR-only файлов нужна явная нормализация; auto_detect_line_endings deprecated8.1. FILE_NO_DEFAULT_CONTEXT отключает стандартный контекст, не права и не проверку TLS.

Сравните: fgets, file_get_contents, readfile. Полный выбор файловых операций.

• PHP: file

PHP 4+ · standard

copy(string $from, string $to, ?resource $context = null): bool

Скопировать файл, сохранив источник.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

$from = __DIR__ . '/draft.txt';
$to = __DIR__ . '/pickup.txt';
if (!copy($from, $to)) { throw new RuntimeException('Не подготовить документ'); }
echo 'pickup.txt: ', file_get_contents($to);
echo file_exists($from) ? "Черновик остался.\n" : "Имя черновика перенесено.\n";

pickup.txt: 104: ready
Черновик остался.

<?php
$from = __DIR__ . '/new.txt';
$to = __DIR__ . '/current.txt';
if (!copy($from, $to)) { throw new RuntimeException('copy'); }
echo file_get_contents($to), "
";

NEW

Применение и границы. copy не копирует дерево каталога и не обещает сохранить все метаданные/ACL. Читатель назначения может увидеть процесс записи; для смены готового файла применяют отдельно подготовку и rename.

Сравните: rename, unlink, move_uploaded_file. Полный выбор файловых операций.

• PHP: copy

PHP 4+ · standard

rename(string $from, string $to, ?resource $context = null): bool

Переместить или переименовать файл/каталог.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

$from = __DIR__ . '/draft.txt';
$to = __DIR__ . '/pickup.txt';
if (!rename($from, $to)) { throw new RuntimeException('Не подготовить документ'); }
echo 'pickup.txt: ', file_get_contents($to);
echo file_exists($from) ? "Черновик остался.\n" : "Имя черновика перенесено.\n";

pickup.txt: 104: ready
Имя черновика перенесено.

<?php
$from = __DIR__ . '/new.txt';
$to = __DIR__ . '/current.txt';
if (!rename($from, $to)) { throw new RuntimeException('rename'); }
echo file_get_contents($to), "
";

NEW

Применение и границы. Неделимую смену имени обычно обсуждают для одной локальной файловой системы. Не переносите это обещание на разные тома, сетевые обёртки и все Windows-сценарии с открытыми handles. Не обещает fsync/сохранность питания. Права и итог операции проверяются даже после предварительных проверок.

Сравните: copy, unlink, move_uploaded_file. Полный выбор файловых операций.

• PHP: rename

PHP 4+ · standard

unlink(string $filename, ?resource $context = null): bool

Удалить имя файла; удаление каталога выполняется другой функцией.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". try выполняет попытку, catch обрабатывает указанный отказ, finally освобождает ресурс и не подавляет ошибку. throw new RuntimeException сообщает о сбое. Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

$path = __DIR__ . '/draft-104.txt';
echo 'Черновик: ', file_get_contents($path);
if (!unlink($path)) { throw new RuntimeException('Не удалить черновик'); }
echo file_exists($path) ? "Черновик ещё существует.\n" : "draft-104.txt удалён.\n";

Черновик: 104: ready
draft-104.txt удалён.

<?php
$path = __DIR__ . '/work.txt';
try { echo file_get_contents($path), "
"; }
finally {
    if (!unlink($path)) { throw new RuntimeException('cleanup'); }
}

READY

Применение и границы. Это необратимая файловая операция, поэтому задавайте точный доверенный путь. Не используйте пользовательское имя как путь. На Windows с7.3 допускается unlink при открытых handles, но повторное создание имени до их закрытия всё ещё ограничено. На Unix освобождение содержимого зависит также от других имён/открытых handles.

Сравните: rmdir, rename, is_link. Полный выбор файловых операций.

• PHP: unlink

Навигационный пункт Manual, не функция · standard

delete — такой встроенной функции и ключевого слова нет

Официальный пункт delete — указатель на разные операции, а не API.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

$path = __DIR__ . '/pickup.txt';
$text = file_get_contents($path);
unset($text);
echo 'Повторное чтение с диска: ', file_get_contents($path);

Повторное чтение с диска: 104: ready

<?php
declare(strict_types=1);

$path = __DIR__ . '/pickup.txt';
$text = file_get_contents($path);
if ($text === false || !unlink($path)) { throw new RuntimeException('Операция не завершена'); }
echo 'Сохранено в переменной: ', $text;
echo file_exists($path) ? "Файл существует.\n" : "Файл удалён с диска.\n";

Сохранено в переменной: 104: ready
Файл удалён с диска.

Применение и границы. У PHP нет универсального delete для всех сущностей. Для строки базы данных нужен отдельный запрос, для файла unlink, для переменной unset.

Сравните: unlink, rmdir. Полный выбор файловых операций.

• PHP: delete

PHP4.0.1+ · standard

fscanf(resource $stream, string $format, mixed &...$vars): array|int|false|null

Прочитать физическую строку и извлечь значения по известному текстовому формату.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. fopen возвращает открытый поток (resource), а не содержимое файла. rb читает байты, w+b создаёт/очищает файл и разрешает чтение с записью. fclose освобождает поток. Переменные; Вызов и return; Поток и позиция чтения.

<?php
$h = fopen(__DIR__ . '/stock.txt', 'rb');
$row = fscanf($h, '%s %d');
echo json_encode($row), "
";
fclose($h);

["TEA",8]

<?php
declare(strict_types=1);

$stream = fopen(__DIR__ . '/stock.txt', 'rb');
if ($stream === false) { throw new RuntimeException('Не открыть остатки'); }
try {
    while (($row = fscanf($stream, '%s %d')) !== false) {
        if (!is_array($row) || count($row) !== 2 || !is_string($row[0]) || !is_int($row[1])) {
            echo "Строка отклонена: нет целого количества.\n";
            continue;
        }
        echo $row[0], ': ', $row[1], " шт.\n";
    }
} finally { fclose($stream); }

TEA: 8 шт.
Строка отклонена: нет целого количества.

Применение и границы. Парсер не locale-aware; F/g/G/b не поддерживаются в отличие от семейства форматирования. В scanf * подавляет присваивание, а не задаёт динамическую ширину; позиционное argnum$ здесь не тот договор, что у sprintf. Каждый вызов потребляет строку. Проверка синтаксиса числа не заменяет диапазон и обязательность полей.

Сравните: fgets, fgetcsv. Полный выбор файловых операций.

Второй способ получения результата — передать переменные, которые fscanf заполнит по ссылке. Вы не пишете & перед аргументами вызова: это свойство параметров самой функции. Возврат тогда означает число присваиваний, а значения лежат в переменных.

<?php
declare(strict_types=1);

$stream = fopen(__DIR__ . '/stock.txt', 'rb');
if ($stream === false) { throw new RuntimeException('Нет остатков'); }
try {
    $sku = null; $quantity = null;
    $assigned = fscanf($stream, '%s %d', $sku, $quantity);
    if ($assigned !== 2) { throw new UnexpectedValueException('Нужны артикул и целое количество'); }
    echo $sku, ': доступно ', $quantity, " шт.\n";
} finally { fclose($stream); }

TEA: доступно 8 шт.

• PHP: fscanf

PHP4+ · standard

parse_ini_file(string $filename, bool $process_sections = false, int $scanner_mode = INI_SCANNER_NORMAL): array|false

Разобрать файл конфигурации INI в ассоциативный массив.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". [...] создаёт массив; $row["size"] читает поле по ключу; [$a, $b] = ... раскладывает список. Переменные; Вызов и return; Поток и позиция чтения.

INI — строки ключ = значение, комментарии после ;, секции [mail]. roles[] добавляет элемент списка, urls[docs] задаёт ключ вложенного массива. Это разбор данных приложения: он не меняет уже загруженный php.ini. Для внешнего текста допустим только RAW, после которого всё равно нужны собственные проверки ключей и значений.

В NORMAL/TYPED отдельное имя константы может раскрыть её значение; magic constants вроде __FILE__ не вычисляются этим правилом. ${NAME} читает окружение или ранее определённую настройку; | & ^ ~ и скобки имеют значение в выражении. Для буквального ${...} в двойных кавычках экранируют доллар. Не передавайте недоверенный INI этим режимам: он способен раскрыть секретную константу.

Ключами не служат null, yes, no, true, false, on, off, none; специальные ?{}|&~!()^" также запрещены в ключах, квадратные скобки имеют синтаксическое назначение массивов. Строка без = игнорируется, а key = создаёт пустое значение. Небуквенно-цифровые значения заключайте в двойные кавычки. Экранирование кавычки/backslash отличается от PHP: обычные / не превращаются в перенос и табуляцию. Есть особое правило завершающего backslash Windows-пути перед концом строки; для сложного многострочного текста лучше выбрать явный формат данных. Соседние строки в кавычках могут соединяться. Храните конфигурацию с секретами вне public: веб-сервер обычно отдаёт .ini как текст.

<?php
declare(strict_types=1);

$config = parse_ini_file(__DIR__ . '/settings.ini', true, INI_SCANNER_TYPED);
if ($config === false) { throw new RuntimeException('Не разобрать настройки'); }
$settings = $config['pickup'] ?? null;
if (!is_array($settings) || !is_bool($settings['enabled'] ?? null) || !is_int($settings['max_items'] ?? null)) {
    throw new UnexpectedValueException('Нужны enabled и max_items');
}
echo $settings['enabled'] ? "Самовывоз включён.\n" : "Самовывоз выключен.\n";
echo 'Предметов за одну выдачу: ', $settings['max_items'], "\n";

Самовывоз включён.
Предметов за одну выдачу: 3

<?php
define("APP_LABEL", "internal");
$config = parse_ini_file(__DIR__ . '/input.ini', false, INI_SCANNER_RAW);
echo $config["label"], "\n";
echo implode(",", $config["roles"]), "\n";

APP_LABEL
reader,author

Применение и границы. Не отдавайте разобранные настройки пользователю целиком. Поддерживаемые ключи, типы, длины и значения проверяются после разбора. PHP-конфигурация уже загружена: этот вызов её не переустанавливает.

Сравните: parse_ini_string, file_get_contents. Полный выбор файловых операций.

• PHP: parse_ini_file

PHP5.3+ · standard

parse_ini_string(string $ini_string, bool $process_sections = false, int $scanner_mode = INI_SCANNER_NORMAL): array|false

Разобрать строку конфигурации INI в ассоциативный массив.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". [...] создаёт массив; $row["size"] читает поле по ключу; [$a, $b] = ... раскладывает список. Переменные; Вызов и return; Поток и позиция чтения.

INI — строки ключ = значение, комментарии после ;, секции [mail]. roles[] добавляет элемент списка, urls[docs] задаёт ключ вложенного массива. Это разбор данных приложения: он не меняет уже загруженный php.ini. Для внешнего текста допустим только RAW, после которого всё равно нужны собственные проверки ключей и значений.

В NORMAL/TYPED отдельное имя константы может раскрыть её значение; magic constants вроде __FILE__ не вычисляются этим правилом. ${NAME} читает окружение или ранее определённую настройку; | & ^ ~ и скобки имеют значение в выражении. Для буквального ${...} в двойных кавычках экранируют доллар. Не передавайте недоверенный INI этим режимам: он способен раскрыть секретную константу.

Ключами не служат null, yes, no, true, false, on, off, none; специальные ?{}|&~!()^" также запрещены в ключах, квадратные скобки имеют синтаксическое назначение массивов. Строка без = игнорируется, а key = создаёт пустое значение. Небуквенно-цифровые значения заключайте в двойные кавычки. Экранирование кавычки/backslash отличается от PHP: обычные / не превращаются в перенос и табуляцию. Есть особое правило завершающего backslash Windows-пути перед концом строки; для сложного многострочного текста лучше выбрать явный формат данных. Соседние строки в кавычках могут соединяться. Храните конфигурацию с секретами вне public: веб-сервер обычно отдаёт .ini как текст.

<?php
declare(strict_types=1);

$config = parse_ini_string("[pickup]\nenabled = true\nmax_items = 3\n", true, INI_SCANNER_TYPED);
if ($config === false) { throw new RuntimeException('Не разобрать настройки'); }
$settings = $config['pickup'] ?? null;
if (!is_array($settings) || !is_bool($settings['enabled'] ?? null) || !is_int($settings['max_items'] ?? null)) {
    throw new UnexpectedValueException('Нужны enabled и max_items');
}
echo $settings['enabled'] ? "Самовывоз включён.\n" : "Самовывоз выключен.\n";
echo 'Предметов за одну выдачу: ', $settings['max_items'], "\n";

Самовывоз включён.
Предметов за одну выдачу: 3

<?php
define("APP_LABEL", "internal");
$config = parse_ini_string("label = APP_LABEL\nroles[] = reader\nroles[] = author\n", false, INI_SCANNER_RAW);
echo $config["label"], "\n";
echo implode(",", $config["roles"]), "\n";

APP_LABEL
reader,author

Применение и границы. Не отдавайте разобранные настройки пользователю целиком. Поддерживаемые ключи, типы, длины и значения проверяются после разбора. PHP-конфигурация уже загружена: этот вызов её не переустанавливает.

Сравните: parse_ini_file, file_get_contents. Полный выбор файловых операций.

• PHP: parse_ini_string

PHP4–7; deprecated7.3, removed8.0 · standard

Исторически: fgetss(resource $handle, int $length = ?, string $allowable_tags = ?): string|false

Удалённая функция чтения со снятием тегов; изучается для сопровождения старого кода, не для вызова в PHP8.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. fopen возвращает открытый поток (resource), а не содержимое файла. rb читает байты, w+b создаёт/очищает файл и разрешает чтение с записью. fclose освобождает поток. | объединяет поддерживаемые флаги; это допустимо только для параметра-маски. Переменные; Вызов и return; Поток и позиция чтения.

<?php
$html = file_get_contents(__DIR__ . '/note.html');
echo strip_tags($html), "
";

Tea & coffee

<?php
$html = file_get_contents(__DIR__ . '/note.html');
echo htmlspecialchars($html, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8'), "
";

<b>Tea</b>

Применение и границы. fgetss сохраняла состояние парсера между вызовами: механическая замена каждой строки на strip_tags(fgets(...)) может изменить смысл разорванных тегов. Для полноценного HTML используйте подходящий парсер/санитайзер с явной политикой. Сохранение allowable_tags не делало атрибуты безопасными.

Сравните: fgets, file_get_contents. Полный выбор файловых операций.

• PHP: fgetss

PHP4+ · standard

chgrp(string $filename, string|int $group): bool

Изменить группу локального файла.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". [...] создаёт массив; $row["size"] читает поле по ключу; [$a, $b] = ... раскладывает список. Переменные; Вызов и return; Поток и позиция чтения.

На POSIX права разделены на owner/group/other. В каждой восьмеричной цифре чтение =4, запись =2, исполнение =1: 0600 оставляет чтение+запись владельцу; 0640 ещё разрешает группе чтение; 0750 подходит для каталога владельца/группы. У каталога x означает проход, r — чтение имён, w — изменение записей (обычно вместе с x). Ноль в начале задаёт восьмеричное число: 755 — другое десятичное значение. С8.1 есть явная запись 0o750. Это не модель Windows ACL и не право пользователя внутри вашего приложения.

<?php
$path = __DIR__ . '/data.txt';
$id = filegroup($path);
var_dump(chgrp($path, $id));

<?php
$path = __DIR__ . '/data.txt';
$id = filegroup($path);
$record = posix_getgrgid($id);
if ($record === false) { throw new RuntimeException('identity lookup'); }
$name = $record['name'];
if (!chgrp($path, $name)) { throw new RuntimeException('ownership'); }
clearstatcache();
$actual = filegroup($path);
var_dump($actual === $id);

Применение и границы. Не работает на произвольном удалённом URL. Обычно права/владельца готовят при развёртывании, а веб-процесс не запускают с root ради загрузки файла. UID/GID ОС не равны ID пользователя в таблице сайта. Результат относится к моменту проверки и может кэшироваться; clearstatcache() обновляет stat-кэш, но не устраняет гонку между проверкой и действием.

Сравните: chown, lchown, lchgrp, chmod, fileowner, filegroup. Полный выбор файловых операций.

• PHP: chgrp

PHP4+ · standard

chown(string $filename, string|int $user): bool

Изменить владельца локального файла.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". [...] создаёт массив; $row["size"] читает поле по ключу; [$a, $b] = ... раскладывает список. Переменные; Вызов и return; Поток и позиция чтения.

На POSIX права разделены на owner/group/other. В каждой восьмеричной цифре чтение =4, запись =2, исполнение =1: 0600 оставляет чтение+запись владельцу; 0640 ещё разрешает группе чтение; 0750 подходит для каталога владельца/группы. У каталога x означает проход, r — чтение имён, w — изменение записей (обычно вместе с x). Ноль в начале задаёт восьмеричное число: 755 — другое десятичное значение. С8.1 есть явная запись 0o750. Это не модель Windows ACL и не право пользователя внутри вашего приложения.

<?php
$path = __DIR__ . '/data.txt';
$id = fileowner($path);
var_dump(chown($path, $id));

<?php
$path = __DIR__ . '/data.txt';
$id = fileowner($path);
$record = posix_getpwuid($id);
if ($record === false) { throw new RuntimeException('identity lookup'); }
$name = $record['name'];
if (!chown($path, $name)) { throw new RuntimeException('ownership'); }
clearstatcache();
$actual = fileowner($path);
var_dump($actual === $id);

Применение и границы. Не работает на произвольном удалённом URL. Обычно права/владельца готовят при развёртывании, а веб-процесс не запускают с root ради загрузки файла. UID/GID ОС не равны ID пользователя в таблице сайта. Результат относится к моменту проверки и может кэшироваться; clearstatcache() обновляет stat-кэш, но не устраняет гонку между проверкой и действием.

Сравните: chgrp, lchown, lchgrp, chmod, fileowner, filegroup. Полный выбор файловых операций.

• PHP: chown

PHP5.1.3+ · standard

lchgrp(string $filename, string|int $group): bool

Изменить группу самой символической ссылки, не её цели.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". [...] создаёт массив; $row["size"] читает поле по ключу; [$a, $b] = ... раскладывает список. Переменные; Вызов и return; Поток и позиция чтения.

Символическая ссылка хранит путь к другой записи; относительная цель разрешается от папки ссылки. Hard link — ещё одно имя того же файла в одной файловой системе: отдельного «содержимого ссылки» у него нет. Удаление имени и удаление всех данных — разные события. Создание symlink на Windows зависит от прав/режима ОС, поэтому здесь такие примеры помечены условными.

<?php
symlink('data.txt', __DIR__ . '/shortcut');
$path = __DIR__ . '/shortcut';
$id = lstat($path)['gid'];
var_dump(lchgrp($path, $id));
unlink($path);

<?php
symlink('data.txt', __DIR__ . '/shortcut');
$path = __DIR__ . '/shortcut';
$id = lstat($path)['gid'];
$record = posix_getgrgid($id);
if ($record === false) { throw new RuntimeException('identity lookup'); }
$name = $record['name'];
if (!lchgrp($path, $name)) { throw new RuntimeException('ownership'); }
clearstatcache();
$actual = lstat($path)['gid'];
var_dump($actual === $id);
unlink($path);

Применение и границы. Не работает на произвольном удалённом URL. Обычно права/владельца готовят при развёртывании, а веб-процесс не запускают с root ради загрузки файла. UID/GID ОС не равны ID пользователя в таблице сайта. Результат относится к моменту проверки и может кэшироваться; clearstatcache() обновляет stat-кэш, но не устраняет гонку между проверкой и действием.

Сравните: chown, chgrp, lchown, chmod, fileowner, filegroup. Полный выбор файловых операций.

• PHP: lchgrp

PHP5.1.3+ · standard

lchown(string $filename, string|int $user): bool

Изменить владельца самой символической ссылки, не её цели.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". [...] создаёт массив; $row["size"] читает поле по ключу; [$a, $b] = ... раскладывает список. Переменные; Вызов и return; Поток и позиция чтения.

Символическая ссылка хранит путь к другой записи; относительная цель разрешается от папки ссылки. Hard link — ещё одно имя того же файла в одной файловой системе: отдельного «содержимого ссылки» у него нет. Удаление имени и удаление всех данных — разные события. Создание symlink на Windows зависит от прав/режима ОС, поэтому здесь такие примеры помечены условными.

<?php
symlink('data.txt', __DIR__ . '/shortcut');
$path = __DIR__ . '/shortcut';
$id = lstat($path)['uid'];
var_dump(lchown($path, $id));
unlink($path);

<?php
symlink('data.txt', __DIR__ . '/shortcut');
$path = __DIR__ . '/shortcut';
$id = lstat($path)['uid'];
$record = posix_getpwuid($id);
if ($record === false) { throw new RuntimeException('identity lookup'); }
$name = $record['name'];
if (!lchown($path, $name)) { throw new RuntimeException('ownership'); }
clearstatcache();
$actual = lstat($path)['uid'];
var_dump($actual === $id);
unlink($path);

Применение и границы. Не работает на произвольном удалённом URL. Обычно права/владельца готовят при развёртывании, а веб-процесс не запускают с root ради загрузки файла. UID/GID ОС не равны ID пользователя в таблице сайта. Результат относится к моменту проверки и может кэшироваться; clearstatcache() обновляет stat-кэш, но не устраняет гонку между проверкой и действием.

Сравните: chown, chgrp, lchgrp, chmod, fileowner, filegroup. Полный выбор файловых операций.

• PHP: lchown

PHP 4+ · standard

chmod(string $filename, int $permissions): bool

Изменить режим доступа POSIX-файла; числовая маска отличается от текста команды shell.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". & оставляет биты маски, ~ инвертирует биты; число с ведущим 0 восьмеричное. Переменные; Вызов и return; Поток и позиция чтения.

На POSIX права разделены на owner/group/other. В каждой восьмеричной цифре чтение =4, запись =2, исполнение =1: 0600 оставляет чтение+запись владельцу; 0640 ещё разрешает группе чтение; 0750 подходит для каталога владельца/группы. У каталога x означает проход, r — чтение имён, w — изменение записей (обычно вместе с x). Ноль в начале задаёт восьмеричное число: 755 — другое десятичное значение. С8.1 есть явная запись 0o750. Это не модель Windows ACL и не право пользователя внутри вашего приложения.

<?php
$path = __DIR__ . '/private.txt';
if (!chmod($path, 0600)) { throw new RuntimeException('chmod'); }
clearstatcache();
echo decoct(fileperms($path) & 0777), "
";

<?php
$path = __DIR__ . '/report.txt';
if (!chmod($path, 0640)) { throw new RuntimeException('chmod'); }
clearstatcache();
echo decoct(fileperms($path) & 0777), "
";

Применение и границы. Не лечите каждый отказ режимом 0777: сначала определите пользователя процесса и нужные права. Windows chmod в основном управляет read-only атрибутом и не заменяет ACL. chmod после создания не устраняет окно доступа, если изначально файл создан слишком открыто; начальные режимы/umask готовят на уровне окружения.

Сравните: fileperms, umask, mkdir, chown, chgrp. Полный выбор файловых операций.

• PHP: chmod

PHP4+; nullable mask8.0 · standard

umask(?int $mask = null): int

Узнать или временно изменить маску прав, убираемых при создании новых файлов.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. try выполняет попытку, catch обрабатывает указанный отказ, finally освобождает ресурс и не подавляет ошибку. throw new RuntimeException сообщает о сбое. & оставляет биты маски, ~ инвертирует биты; число с ведущим 0 восьмеричное. Переменные; Вызов и return; Поток и позиция чтения.

На POSIX права разделены на owner/group/other. В каждой восьмеричной цифре чтение =4, запись =2, исполнение =1: 0600 оставляет чтение+запись владельцу; 0640 ещё разрешает группе чтение; 0750 подходит для каталога владельца/группы. У каталога x означает проход, r — чтение имён, w — изменение записей (обычно вместе с x). Ноль в начале задаёт восьмеричное число: 755 — другое десятичное значение. С8.1 есть явная запись 0o750. Это не модель Windows ACL и не право пользователя внутри вашего приложения.

<?php
$requested = 0777;
$mask = 0027;
echo decoct($requested & ~$mask), "
";
var_dump(is_int(umask()));

750
bool(true)

<?php
$old = umask(0027);
try {
    mkdir(__DIR__ . '/private-dir', 0777);
    clearstatcache();
    echo decoct(fileperms(__DIR__ . '/private-dir') & 0777), "
";
} finally { umask($old); }

Применение и границы. PHP server-module восстанавливает маску после запроса, но это не предотвращает гонки во время запроса. Для процесса с потоками не меняйте umask на ходу; задайте безопасное окружение при запуске. Маска влияет на создание, а не переписывает режим уже существующего файла.

Сравните: chmod, mkdir, fopen. Полный выбор файловых операций.

• PHP: umask

PHP 4+ · standard

mkdir(string $directory, int $permissions = 0777, bool $recursive = false, ?resource $context = null): bool

Создать каталог, при необходимости вместе с отсутствующими родителями.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". Переменные; Вызов и return; Поток и позиция чтения.

На POSIX права разделены на owner/group/other. В каждой восьмеричной цифре чтение =4, запись =2, исполнение =1: 0600 оставляет чтение+запись владельцу; 0640 ещё разрешает группе чтение; 0750 подходит для каталога владельца/группы. У каталога x означает проход, r — чтение имён, w — изменение записей (обычно вместе с x). Ноль в начале задаёт восьмеричное число: 755 — другое десятичное значение. С8.1 есть явная запись 0o750. Это не модель Windows ACL и не право пользователя внутри вашего приложения.

<?php
declare(strict_types=1);

$folder = __DIR__ . '/pickup';
if (!mkdir($folder, 0700)) { throw new RuntimeException('Не создать папку'); }
$text = "104: ready\n";
if (file_put_contents($folder . '/104.txt', $text) !== strlen($text)) {
    throw new RuntimeException('Не сохранить документ');
}
echo 'pickup/104.txt: ', file_get_contents($folder . '/104.txt');

pickup/104.txt: 104: ready

<?php
declare(strict_types=1);

$folder = __DIR__ . '/reports/2026/10';
if (!mkdir($folder, 0700, true)) { throw new RuntimeException('Не создать цепочку папок'); }
$text = "Октябрь: выдано 3 заказа\n";
if (file_put_contents($folder . '/summary.txt', $text) !== strlen($text)) { throw new RuntimeException('Не записать итог'); }
echo 'reports/2026/10/summary.txt: ', file_get_contents($folder . '/summary.txt');

reports/2026/10/summary.txt: Октябрь: выдано 3 заказа

Применение и границы. is_dir перед mkdir помогает выбрать ветку, но другой процесс может создать каталог между проверкой и вызовом. Обрабатывайте фактический результат и диагностику. Не превращайте пользовательскую строку в произвольный путь дерева.

Сравните: is_dir, rmdir, umask, chmod. Полный выбор файловых операций.

• PHP: mkdir

PHP 4+ · standard

rmdir(string $directory, ?resource $context = null): bool

Удалить пустой каталог; функция не обходит и не стирает всё дерево.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

$folder = __DIR__ . '/job-104';
if (!mkdir($folder)) { throw new RuntimeException('Не создать рабочую папку'); }
if (!rmdir($folder)) { throw new RuntimeException('Не удалить пустую папку'); }
echo is_dir($folder) ? "Рабочая папка ещё существует.\n" : "job-104 удалена после завершения задания.\n";

job-104 удалена после завершения задания.

<?php
declare(strict_types=1);

$folder = __DIR__ . '/job-104';
if (!mkdir($folder)) { throw new RuntimeException('Не создать рабочую папку'); }
$path = $folder . '/part.txt';
file_put_contents($path, "104: ready\n");
echo 'Готовый текст: ', file_get_contents($path);
if (!unlink($path) || !rmdir($folder)) { throw new RuntimeException('Не убрать рабочие файлы'); }
echo "Промежуточный файл и пустая папка удалены.\n";

Готовый текст: 104: ready
Промежуточный файл и пустая папка удалены.

Применение и границы. Для Windows symlink на каталог применяется rmdir к самой ссылке. Не переходите по символическим ссылкам при очистке дерева; чужие файлы и concurrent writers способны сделать каталог непустым снова.

Сравните: mkdir, unlink, is_dir. Полный выбор файловых операций.

• PHP: rmdir

PHP4+; nullable mtime/atime8.0 · standard

touch(string $filename, ?int $mtime = null, ?int $atime = null): bool

Поставить время изменения/доступа; отсутствующий файл будет создан пустым.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

$path = __DIR__ . '/report.ready';
if (!touch($path, 1600000000)) { throw new RuntimeException('Не создать метку'); }
clearstatcache();
echo 'Метка готовности: ', basename($path), "\n";
echo 'Время UTC: ', gmdate('Y-m-d H:i:s', filemtime($path)), "\n";
echo 'Содержимое: ', filesize($path), " байт\n";

Метка готовности: report.ready
Время UTC: 2020-09-13 12:26:40
Содержимое: 0 байт

<?php
$path = __DIR__ . '/report.txt';
touch($path, 1600000000, 1600000060);
clearstatcache();
echo filemtime($path), ':', fileatime($path), "
";
echo file_get_contents($path), "
";

1600000000:1600000060
REPORT

Применение и границы. Разрешение timestamp зависит от файловой системы. Маркер существования не является межпроцессной блокировкой и не заменяет транзакцию. Для честной бизнес-даты храните отдельное поле, а не полагайтесь на файловый mtime.

Сравните: filemtime, fileatime, flock. Полный выбор файловых операций.

• PHP: touch

PHP 4+ · standard

link(string $target, string $link): bool

Создать второе имя того же локального файла — жёсткую ссылку.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". try выполняет попытку, catch обрабатывает указанный отказ, finally освобождает ресурс и не подавляет ошибку. throw new RuntimeException сообщает о сбое. Переменные; Вызов и return; Поток и позиция чтения.

Символическая ссылка хранит путь к другой записи; относительная цель разрешается от папки ссылки. Hard link — ещё одно имя того же файла в одной файловой системе: отдельного «содержимого ссылки» у него нет. Удаление имени и удаление всех данных — разные события. Создание symlink на Windows зависит от прав/режима ОС, поэтому здесь такие примеры помечены условными.

<?php
$a = __DIR__ . '/a.txt'; $b = __DIR__ . '/b.txt';
if (!link($a, $b)) { throw new RuntimeException('hardlink'); }
try {
    file_put_contents($b, 'NEW');
    echo file_get_contents($a), "
";
} finally { unlink($b); }

NEW

<?php
$a = __DIR__ . '/a.txt'; $b = __DIR__ . '/b.txt';
if (!link($a, $b)) { throw new RuntimeException('hardlink'); }
unlink($a);
try { echo file_get_contents($b), "
"; }
finally { unlink($b); }

DATA

Применение и границы. Не работает с произвольным удалённым URL, обычно нельзя между томами или для каталогов. Копирование и резервирование независимых данных требует copy, а не hard link. Поддержка зависит от FS и разрешений.

Сравните: symlink, copy, unlink, fileinode. Полный выбор файловых операций.

• PHP: link

PHP 4+ · standard

symlink(string $target, string $link): bool

Создать запись, содержащую путь к целевому файлу или каталогу.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". try выполняет попытку, catch обрабатывает указанный отказ, finally освобождает ресурс и не подавляет ошибку. throw new RuntimeException сообщает о сбое. Переменные; Вызов и return; Поток и позиция чтения.

Символическая ссылка хранит путь к другой записи; относительная цель разрешается от папки ссылки. Hard link — ещё одно имя того же файла в одной файловой системе: отдельного «содержимого ссылки» у него нет. Удаление имени и удаление всех данных — разные события. Создание symlink на Windows зависит от прав/режима ОС, поэтому здесь такие примеры помечены условными.

<?php
$link = __DIR__ . '/shortcut';
if (!symlink('data.txt', $link)) { throw new RuntimeException('symlink'); }
try { echo file_get_contents($link), "
"; }
finally { unlink($link); }

<?php
mkdir(__DIR__ . '/links');
$link = __DIR__ . '/links/shortcut';
if (!symlink('../data.txt', $link)) { throw new RuntimeException('symlink'); }
try { echo file_get_contents($link), "
"; }
finally { unlink($link); rmdir(__DIR__ . '/links'); }

Применение и границы. Ссылки полезны для указателя на версию ресурса, но открывают путь за пределы дерева при неосторожном обходе. realpath помогает анализу существующего пути, но не исключает подмену между проверкой и действием.

Сравните: link, readlink, is_link, lstat, realpath. Полный выбор файловых операций.

• PHP: symlink

PHP 4+ · standard

readlink(string $path): string|false

Прочитать цель символической ссылки, а не содержимое целевого файла.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". try выполняет попытку, catch обрабатывает указанный отказ, finally освобождает ресурс и не подавляет ошибку. throw new RuntimeException сообщает о сбое. Переменные; Вызов и return; Поток и позиция чтения.

Символическая ссылка хранит путь к другой записи; относительная цель разрешается от папки ссылки. Hard link — ещё одно имя того же файла в одной файловой системе: отдельного «содержимого ссылки» у него нет. Удаление имени и удаление всех данных — разные события. Создание symlink на Windows зависит от прав/режима ОС, поэтому здесь такие примеры помечены условными.

<?php
$link = __DIR__ . '/shortcut';
if (!symlink('data.txt', $link)) { throw new RuntimeException('symlink'); }
try { echo readlink($link), "
"; }
finally { unlink($link); }

<?php
$link = __DIR__ . '/shortcut';
if (!symlink('data.txt', $link)) { throw new RuntimeException('symlink'); }
try {
    var_dump(is_link($link));
    echo readlink($link), "
";
    echo basename(realpath($link)), "
";
} finally { unlink($link); }

Применение и границы. Относительную цель нельзя бездумно передать как путь от другого CWD. Для проверки типа самой записи нужен is_link/lstat; для получения существующего конечного пути realpath.

Сравните: symlink, is_link, realpath, linkinfo. Полный выбор файловых операций.

• PHP: readlink

PHP 4+ · standard

linkinfo(string $path): int|false

Получить поле устройства st_dev через lstat; это не текст цели и не надёжный bool-тест symlink.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". Переменные; Вызов и return; Поток и позиция чтения.

Символическая ссылка хранит путь к другой записи; относительная цель разрешается от папки ссылки. Hard link — ещё одно имя того же файла в одной файловой системе: отдельного «содержимого ссылки» у него нет. Удаление имени и удаление всех данных — разные события. Создание symlink на Windows зависит от прав/режима ОС, поэтому здесь такие примеры помечены условными.

<?php
$path = __DIR__ . '/a.txt';
$device = linkinfo($path);
var_dump(is_int($device) && $device >= 0, is_link($path));

bool(true)
bool(false)

<?php
$a = linkinfo(__DIR__ . '/a.txt');
$b = linkinfo(__DIR__ . '/b.txt');
if ($a === false || $a < 0 || $b === false || $b < 0) { throw new RuntimeException('lstat'); }
var_dump($a === $b);

bool(true)

Применение и границы. Общую фразу Manual о проверке существования ссылки следует читать вместе с фактическим возвратом st_dev: используйте is_link для типа, readlink для цели. Значение устройства платформенно зависимо, не бизнес-ID.

Сравните: is_link, readlink, lstat, fileinode. Полный выбор файловых операций.

• PHP: linkinfo

PHP4.0.1+ · standard

fflush(resource $stream): bool

Передать накопленный буфер потока нижележащей системе.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. fopen возвращает открытый поток (resource), а не содержимое файла. rb читает байты, w+b создаёт/очищает файл и разрешает чтение с записью. fclose освобождает поток. foreach берёт элементы массива по одному, форма as $key => $value также читает ключ. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". try выполняет попытку, catch обрабатывает указанный отказ, finally освобождает ресурс и не подавляет ошибку. throw new RuntimeException сообщает о сбое. [...] создаёт массив; $row["size"] читает поле по ключу; [$a, $b] = ... раскладывает список. Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

$path = __DIR__ . '/journal.txt';
$stream = fopen($path, 'w+b');
if ($stream === false) { throw new RuntimeException('Не открыть журнал'); }
try {
    foreach (['104: ready'] as $event) {
        $line = $event . "\n";
        if (fwrite($stream, $line) !== strlen($line)) { throw new RuntimeException('Неполная запись'); }
    }
    if (!fflush($stream)) { throw new RuntimeException('Не выполнить fflush'); }
} finally { fclose($stream); }
echo file_get_contents($path);

104: ready

<?php
declare(strict_types=1);

$path = __DIR__ . '/journal.txt';
$stream = fopen($path, 'w+b');
if ($stream === false) { throw new RuntimeException('Не открыть журнал'); }
try {
    foreach (['104: ready', '105: ready'] as $event) {
        $line = $event . "\n";
        if (fwrite($stream, $line) !== strlen($line)) { throw new RuntimeException('Неполная запись'); }
    }
    if (!fflush($stream)) { throw new RuntimeException('Не выполнить fflush'); }
} finally { fclose($stream); }
echo file_get_contents($path);

104: ready
105: ready

Применение и границы. fflush очищает буфер потока; это не приказ устойчиво сохранить носитель. Он нужен, например, до снятия flock, но не заменяет fsync. Дорогая синхронизация способна увеличить задержку запросов. Успешный тест не доказывает поведение при аварии питания.

Сравните: fsync, fdatasync, flock. Полный выбор файловых операций.

• PHP: fflush

PHP8.1+ · standard

fsync(resource $stream): bool

Попросить ОС синхронизировать данные файла и метаданные с хранилищем.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. fopen возвращает открытый поток (resource), а не содержимое файла. rb читает байты, w+b создаёт/очищает файл и разрешает чтение с записью. fclose освобождает поток. foreach берёт элементы массива по одному, форма as $key => $value также читает ключ. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". try выполняет попытку, catch обрабатывает указанный отказ, finally освобождает ресурс и не подавляет ошибку. throw new RuntimeException сообщает о сбое. [...] создаёт массив; $row["size"] читает поле по ключу; [$a, $b] = ... раскладывает список. Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

$path = __DIR__ . '/journal.txt';
$stream = fopen($path, 'w+b');
if ($stream === false) { throw new RuntimeException('Не открыть журнал'); }
try {
    foreach (['104: ready'] as $event) {
        $line = $event . "\n";
        if (fwrite($stream, $line) !== strlen($line)) { throw new RuntimeException('Неполная запись'); }
    }
    if (!fsync($stream)) { throw new RuntimeException('Не выполнить fsync'); }
} finally { fclose($stream); }
echo file_get_contents($path);

104: ready

<?php
declare(strict_types=1);

$path = __DIR__ . '/journal.txt';
$stream = fopen($path, 'w+b');
if ($stream === false) { throw new RuntimeException('Не открыть журнал'); }
try {
    foreach (['104: ready', '105: ready'] as $event) {
        $line = $event . "\n";
        if (fwrite($stream, $line) !== strlen($line)) { throw new RuntimeException('Неполная запись'); }
    }
    if (!fsync($stream)) { throw new RuntimeException('Не выполнить fsync'); }
} finally { fclose($stream); }
echo file_get_contents($path);

104: ready
105: ready

Применение и границы. fsync включает метаданные файла, но не делает несколько файлов/rename/запись БД единой транзакцией. Для устойчивого протокола важны также каталог, FS, контроллер и порядок операций. Дорогая синхронизация способна увеличить задержку запросов. Успешный тест не доказывает поведение при аварии питания.

Сравните: fflush, fdatasync, flock. Полный выбор файловых операций.

• PHP: fsync

PHP8.1+ · standard

fdatasync(resource $stream): bool

Синхронизировать данные файла без общего требования синхронизировать все метаданные.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. fopen возвращает открытый поток (resource), а не содержимое файла. rb читает байты, w+b создаёт/очищает файл и разрешает чтение с записью. fclose освобождает поток. foreach берёт элементы массива по одному, форма as $key => $value также читает ключ. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". try выполняет попытку, catch обрабатывает указанный отказ, finally освобождает ресурс и не подавляет ошибку. throw new RuntimeException сообщает о сбое. [...] создаёт массив; $row["size"] читает поле по ключу; [$a, $b] = ... раскладывает список. Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

$path = __DIR__ . '/journal.txt';
$stream = fopen($path, 'w+b');
if ($stream === false) { throw new RuntimeException('Не открыть журнал'); }
try {
    foreach (['104: ready'] as $event) {
        $line = $event . "\n";
        if (fwrite($stream, $line) !== strlen($line)) { throw new RuntimeException('Неполная запись'); }
    }
    if (!fdatasync($stream)) { throw new RuntimeException('Не выполнить fdatasync'); }
} finally { fclose($stream); }
echo file_get_contents($path);

104: ready

<?php
declare(strict_types=1);

$path = __DIR__ . '/journal.txt';
$stream = fopen($path, 'w+b');
if ($stream === false) { throw new RuntimeException('Не открыть журнал'); }
try {
    foreach (['104: ready', '105: ready'] as $event) {
        $line = $event . "\n";
        if (fwrite($stream, $line) !== strlen($line)) { throw new RuntimeException('Неполная запись'); }
    }
    if (!fdatasync($stream)) { throw new RuntimeException('Не выполнить fdatasync'); }
} finally { fclose($stream); }
echo file_get_contents($path);

104: ready
105: ready

Применение и границы. fdatasync отличается от fsync по метаданным на POSIX; на Windows является alias fsync. Метаданные, нужные для чтения данных (например размер), могут всё же требоваться ОС. Дорогая синхронизация способна увеличить задержку запросов. Успешный тест не доказывает поведение при аварии питания.

Сравните: fflush, fsync, flock. Полный выбор файловых операций.

• PHP: fdatasync

PHP 4+ · standard

set_file_buffer(resource $stream, int $size): int

Псевдоним stream_set_write_buffer: попросить поток изменить размер буфера записи.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. fopen возвращает открытый поток (resource), а не содержимое файла. rb читает байты, w+b создаёт/очищает файл и разрешает чтение с записью. fclose освобождает поток. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". Переменные; Вызов и return; Поток и позиция чтения.

Основной контракт: stream_set_write_buffer.

<?php
$h = fopen(__DIR__ . '/out.txt', 'wb');
if ($h === false) { throw new RuntimeException('open'); }
$result = set_file_buffer($h, 0);
var_dump(is_int($result));
fwrite($h, 'OK');
fclose($h);
echo file_get_contents(__DIR__ . '/out.txt'), "
";

bool(true)
OK

<?php
$h = fopen(__DIR__ . '/out.txt', 'wb');
if ($h === false) { throw new RuntimeException('open'); }
$alias = set_file_buffer($h, 4096);
$main = stream_set_write_buffer($h, 4096);
var_dump($alias === $main);
fclose($h);

bool(true)

Применение и границы. Отключение буфера не является flock и не гарантирует, что несколько вызовов fwrite другой процесс увидит как одно действие. Это также не fsync. Размер буфера выбирают измерением, а не правилом «чем больше, тем быстрее».

Сравните: fflush, fwrite, flock. Полный выбор файловых операций.

• PHP: set_file_buffer

PHP 4+ · standard

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

Создать пустой временный файл с уникальным именем и получить полный путь к уже созданному файлу.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". try выполняет попытку, catch обрабатывает указанный отказ, finally освобождает ресурс и не подавляет ошибку. throw new RuntimeException сообщает о сбое. Переменные; Вызов и return; Поток и позиция чтения.

<?php
declare(strict_types=1);

$path = tempnam(__DIR__, 'job');
if ($path === false) { throw new RuntimeException('Не создать временный файл'); }
try {
    if (realpath(dirname($path)) !== realpath(__DIR__)) { throw new RuntimeException('Файл создан в другой папке'); }
    echo 'Начальный размер: ', filesize($path), " байт\n";
    $text = "Заказ 104 готов\n";
    if (file_put_contents($path, $text) !== strlen($text)) { throw new RuntimeException('Не записать памятку'); }
    echo file_get_contents($path);
} finally { unlink($path); }

Начальный размер: 0 байт
Заказ 104 готов

<?php
declare(strict_types=1);

$folder = __DIR__;
$temporary = tempnam($folder, 'rep');
if ($temporary === false) { throw new RuntimeException('Не создать временный файл'); }
$moved = false;
try {
    if (realpath(dirname($temporary)) !== realpath($folder)) { throw new RuntimeException('Неверная временная папка'); }
    $text = "Сегодня выдать: 3 заказа\n";
    if (file_put_contents($temporary, $text) !== strlen($text)) { throw new RuntimeException('Не дописать отчёт'); }
    if (!rename($temporary, $folder . '/report.txt')) { throw new RuntimeException('Не переименовать готовый отчёт'); }
    $moved = true;
    echo 'report.txt: ', file_get_contents($folder . '/report.txt');
} finally { if (!$moved) { unlink($temporary); } }

report.txt: Сегодня выдать: 3 заказа

Применение и границы. Функция создаёт файл, не папку и не имя без файла. Резервирование имени не защищает от злоумышленника, который уже имеет право менять каталог. Manual описывает также NTFS fallback при очень большом количестве записей; контролируйте собственную temp-папку, очистку и фактический путь.

Сравните: tmpfile, unlink, rename, mkdir. Полный выбор файловых операций.

• PHP: tempnam

PHP 4+ · standard

tmpfile(): resource|false

Получить автоматически удаляемый временный файл как открытый поток w+b.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. fopen возвращает открытый поток (resource), а не содержимое файла. rb читает байты, w+b создаёт/очищает файл и разрешает чтение с записью. fclose освобождает поток. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". try выполняет попытку, catch обрабатывает указанный отказ, finally освобождает ресурс и не подавляет ошибку. throw new RuntimeException сообщает о сбое. [...] создаёт массив; $row["size"] читает поле по ключу; [$a, $b] = ... раскладывает список. Переменные; Вызов и return; Поток и позиция чтения.

<?php
$h = tmpfile();
if ($h === false) { throw new RuntimeException('tmpfile'); }
try {
    fwrite($h, 'READY');
    rewind($h);
    echo fread($h, 5), "
";
} finally { fclose($h); }

<?php
$h = tmpfile();
if ($h === false) { throw new RuntimeException('tmpfile'); }
$meta = stream_get_meta_data($h);
$path = $meta['uri'];
var_dump(is_file($path));
fclose($h);
clearstatcache();
var_dump(file_exists($path));

Применение и границы. Не используйте как постоянное хранилище или гарантированную уборку после kill/аварии. Если надо назначить конкретную папку и передавать путь другой программе, удобнее tempnam с явным finally. php://temp — другой механизм: память с переходом на временный файл при пороге.

Сравните: tempnam, fclose, fopen. Полный выбор файловых операций.

• PHP: tmpfile

PHP 4+ · standard

popen(string $command, string $mode): resource|false

Запустить команду и открыть одно направление общения: читать stdout либо писать stdin.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. fopen возвращает открытый поток (resource), а не содержимое файла. rb читает байты, w+b создаёт/очищает файл и разрешает чтение с записью. fclose освобождает поток. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". Переменные; Вызов и return; Поток и позиция чтения.

PHP_BINARY — путь текущего PHP CLI; escapeshellarg оформляет один доверенный аргумент для shell. Приложенный worker — отдельный процесс с отдельными переменными. Полный обмен JSON и proc_open.

<?php
$command = escapeshellarg(PHP_BINARY) . ' -n ' . escapeshellarg(__DIR__ . '/worker.php');
$h = popen($command, 'rb');
if ($h === false) { throw new RuntimeException('popen'); }
$body = stream_get_contents($h);
$status = pclose($h);
echo $body;
echo 'status=', $status, "
";

READY
status=0

<?php
$command = escapeshellarg(PHP_BINARY) . ' -n ' . escapeshellarg(__DIR__ . '/worker.php');
$h = popen($command, 'wb');
if ($h === false) { throw new RuntimeException('popen'); }
if (fwrite($h, 'tea') !== 3) { throw new RuntimeException('write'); }
$status = pclose($h);
echo 'status=', $status, "
";
echo file_get_contents(__DIR__ . '/result.txt'), "
";

status=0
TEA

Применение и границы. stderr не входит автоматически в stdout; shell-перенаправление 2>&1 смешивает каналы. Для отдельных stdin/stdout/stderr и обхода shell лучше proc_open с массивом аргументов. escapeshellarg имеет различия POSIX/Windows и не превращает произвольную пользовательскую команду в безопасную; не подставляйте запрос в command. popen и чтение могут блокировать: это не очередь, не timeout manager.

Сравните: pclose, fread, fwrite. Полный выбор файловых операций.

• PHP: popen

PHP 4+ · standard

pclose(resource $handle): int

Закрыть pipe из popen и дождаться завершения дочерней программы.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит; "\n" переносит строку, var_dump показывает также тип. __DIR__ — папка текущего PHP-файла; точка . соединяет строки. fopen возвращает открытый поток (resource), а не содержимое файла. rb читает байты, w+b создаёт/очищает файл и разрешает чтение с записью. fclose освобождает поток. if выбирает ветку; === false отличает отказ от 0 байтов и пустой строки, а !== false допускает строку "0". Переменные; Вызов и return; Поток и позиция чтения.

<?php
$h = popen(escapeshellarg(PHP_BINARY) . ' -n ' . escapeshellarg(__DIR__ . '/worker.php'), 'rb');
if ($h === false) { throw new RuntimeException('popen'); }
echo stream_get_contents($h);
echo 'status=', pclose($h), "
";

DONE
status=0

<?php
$h = popen(escapeshellarg(PHP_BINARY) . ' -n ' . escapeshellarg(__DIR__ . '/worker.php'), 'rb');
if ($h === false) { throw new RuntimeException('popen'); }
echo stream_get_contents($h);
$status = pclose($h);
echo $status === 0 ? 'accepted' : 'rejected';
echo "
";

PARTIAL
rejected

Применение и границы. Manual содержит Unix-замечание о waitpid и pcntl_wexitstatus. В исходнике PHP8.5.11 main/streams/plain_wrapper.c обычное Unix-завершение уже проходит WIFEXITED → WEXITSTATUS: не декодируйте такой код второй раз. Для сигнального завершения и другой сборки проверьте её договор. Windows-тесты подтвердили успешный и ненулевой выход; Unix здесь не запускался. pclose может ждать долго и не реализует тайм-аут. Для управления процессом используйте proc_open и договор процесса.

Сравните: popen, fclose. Полный выбор файловых операций.

• PHP: pclose