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

<?php
declare(strict_types=1);

$names = scandir('catalog');
if ($names === false) { throw new RuntimeException('Cannot read catalog'); }
echo implode(', ', $names), "\n";

., .., a.txt, b.txt

implode соединяет элементы массива строкой-разделителем. Если каталог изменится, его список тоже изменится; здесь используются собственные неизменяемые учебные файлы.

<?php
declare(strict_types=1);

$names = scandir('catalog');
if ($names === false) { throw new RuntimeException('Cannot read catalog'); }
$files = [];
foreach ($names as $name) {
    if ($name === '.' || $name === '..') { continue; }
    if (is_file('catalog/' . $name)) { $files[] = $name; }
}
echo implode(', ', $files), "\n";

0, a.txt, b.txt

is_file получает полный путь относительно текущего каталога, а не голое имя из списка. archive пропущен как каталог; имя 0 остаётся файлом. Это отбор для отчёта, не гарантия безопасности будущего открытия при одновременном изменении файлов.

<?php
declare(strict_types=1);

$ascending = scandir('catalog', SCANDIR_SORT_ASCENDING);
$descending = scandir('catalog', SCANDIR_SORT_DESCENDING);
if ($ascending === false || $descending === false) { throw new RuntimeException('Cannot read catalog'); }
echo implode(', ', $ascending), "\n", implode(', ', $descending), "\n";

., .., a.txt, b.txt
b.txt, a.txt, .., .

SCANDIR_SORT_NONE экономит сортировку, но не обещает конкретный порядок. Если затем всё равно сортировать полный массив, выигрыша в памяти не будет.

<?php
declare(strict_types=1);

$handle = opendir(__DIR__ . '/documents');
if ($handle === false) { throw new RuntimeException('Не открыть документы'); }
$names = [];
try {
    while (($name = readdir($handle)) !== false) {
        if ($name === '.' || $name === '..') { continue; }
        if (is_file(__DIR__ . '/documents/' . $name)) { $names[] = $name; }
    }
} finally { closedir($handle); }
sort($names, SORT_STRING);
foreach ($names as $name) {
    echo $name, ': ', file_get_contents(__DIR__ . '/documents/' . $name);
}

0: Заказ без присвоенного номера
104.txt: Выдать две дрели
105.txt: Выдать одну пилу

opendir возвращает доступ к каталогу. readdir последовательно даёт имена; is_file получает путь с основанием documents. Для воспроизводимого вывода имена сортируются после чтения; ниже показана обработка без накопления списка.

<?php
declare(strict_types=1);

$folder = __DIR__ . '/documents';
$handle = opendir($folder);
if ($handle === false) { throw new RuntimeException('Не открыть документы'); }
$bytes = 0;
try {
    while (($name = readdir($handle)) !== false) {
        if ($name === '.' || $name === '..') { continue; }
        $path = $folder . '/' . $name;
        if (!is_file($path)) { continue; }
        $size = filesize($path);
        if ($size === false) { throw new RuntimeException('Не получить размер'); }
        $bytes += $size;
    }
} finally { closedir($handle); }
echo 'Документы текущей выдачи: ', $bytes, " байт\n";

Документы текущей выдачи: 22 байт

Это прикладной размер подборки: только обычные файлы первого уровня, без archive/103.txt. В памяти остаётся текущая запись и сумма; имена не накапливаются. Размеры относятся к моментам отдельных проверок, не к атомарному снимку.

<?php
declare(strict_types=1);

$warning = false;
set_error_handler(static function (int $level) use (&$warning): bool {
    if ($level !== E_WARNING) { return false; }
    $warning = true;
    return true;
});
try { $handle = opendir(__DIR__ . '/missing-documents'); }
finally { restore_error_handler(); }
if ($handle === false) { echo "Выдача недоступна: папка документов не подготовлена.\n"; }
if ($warning) { echo "PHP также сообщил файловое предупреждение.\n"; }

Выдача недоступна: папка документов не подготовлена.
PHP также сообщил файловое предупреждение.

Отсутствующая папка даёт два сигнала: false и E_WARNING. В опыте handler регистрирует только warning, затем восстанавливается. В приложении техническую причину направляют в журнал, а сотруднику дают действие; не скрывают все предупреждения глобально.

<?php
declare(strict_types=1);

$handle = opendir('catalog');
if ($handle === false) { throw new RuntimeException('Cannot open catalog'); }
$names = [];
try {
    while (($name = readdir($handle)) !== false) {
        if ($name !== '.' && $name !== '..') { $names[] = $name; }
    }
} finally { closedir($handle); }
sort($names, SORT_STRING);
echo implode(', ', $names), "\n";

0, a.txt, archive, b.txt

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

<?php
declare(strict_types=1);

$handle = opendir(__DIR__ . '/documents');
if ($handle === false) { throw new RuntimeException('Не открыть документы'); }
$names = [];
try {
    while (($name = readdir($handle)) !== false) {
        if ($name === '.' || $name === '..') { continue; }
        if (is_file(__DIR__ . '/documents/' . $name)) { $names[] = $name; }
    }
} finally { closedir($handle); }
sort($names, SORT_STRING);
foreach ($names as $name) {
    echo $name, ': ', file_get_contents(__DIR__ . '/documents/' . $name);
}

0: Заказ без присвоенного номера
104.txt: Выдать две дрели
105.txt: Выдать одну пилу

В папке действительно есть файл 0 с содержимым. Строгое !== false позволяет обработать его; нестрогое while ($name = ...) остановилось бы на этом имени. Сортировка здесь служит только стабильному показу.

<?php
declare(strict_types=1);

$directory = dir('catalog');
if ($directory === false) { throw new RuntimeException('Cannot open catalog'); }
$names = [];
try {
    while (($name = $directory->read()) !== false) {
        if ($name !== '.' && $name !== '..') { $names[] = $name; }
    }
} finally { $directory->close(); }
sort($names, SORT_STRING);
echo implode(', ', $names), "\n";

0, a.txt, archive, b.txt

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

<?php
declare(strict_types=1);

$directory = dir(__DIR__ . '/documents');
if ($directory === false) { throw new RuntimeException('Не открыть документы'); }
$names = [];
try {
    while (($name = $directory->read()) !== false) {
        if ($name === '.' || $name === '..') { continue; }
        if (is_file(__DIR__ . '/documents/' . $name)) { $names[] = $name; }
    }
} finally { $directory->close(); }
sort($names, SORT_STRING);
foreach ($names as $name) {
    echo $name, ': ', file_get_contents(__DIR__ . '/documents/' . $name);
}

0: Заказ без присвоенного номера
104.txt: Выдать две дрели
105.txt: Выдать одну пилу

В папке действительно есть файл 0 с содержимым. Строгое !== false позволяет обработать его; нестрогое while ($name = ...) остановилось бы на этом имени. Сортировка здесь служит только стабильному показу.

<?php
declare(strict_types=1);

$handle = opendir(__DIR__ . '/documents');
if ($handle === false) { throw new RuntimeException('Не открыть документы'); }
$names = [];
try {
    while (($name = readdir($handle)) !== false) {
        if ($name === '.' || $name === '..') { continue; }
        $names[] = $name;
    }
} finally { closedir($handle); }
sort($names, SORT_STRING);
echo 'Прочитанные имена: ', implode(', ', $names), "\n";
echo 'Документ после закрытия каталога: ', file_get_contents(__DIR__ . '/documents/104.txt');

Прочитанные имена: 104.txt, 105.txt
Документ после закрытия каталога: Выдать две дрели

Закрывается ресурс перечисления каталога; файлы сохраняются. У close нет полезного возвращаемого значения — void. Для нового перечисления открывают новый ресурс, не повторно используют закрытый.

<?php
declare(strict_types=1);

$handle = opendir(__DIR__ . '/documents');
if ($handle === false) { throw new RuntimeException('Не открыть документы'); }
try {
    try {
        while (($name = readdir($handle)) !== false) {
            if ($name === '.' || $name === '..') { continue; }
            $text = file_get_contents(__DIR__ . '/documents/' . $name);
            json_decode($text, true, 8, JSON_THROW_ON_ERROR);
        }
    } finally { closedir($handle); }
} catch (JsonException $error) { echo "Импорт остановлен: документ содержит неверный JSON.\n"; }
echo is_resource($handle) ? "Каталог ещё открыт.\n" : "Каталог закрыт после отказа.\n";

Импорт остановлен: документ содержит неверный JSON.
Каталог закрыт после отказа.

В файле 104.json отсутствует значение после двоеточия. finally закрывает каталог при реальном отказе парсера; внешний catch объясняет исправление. После закрытия ресурс не читают и не закрывают второй раз.

<?php
declare(strict_types=1);

$directory = dir(__DIR__ . '/documents');
if ($directory === false) { throw new RuntimeException('Не открыть документы'); }
$names = [];
try {
    while (($name = $directory->read()) !== false) {
        if ($name === '.' || $name === '..') { continue; }
        $names[] = $name;
    }
} finally { $directory->close(); }
sort($names, SORT_STRING);
echo 'Прочитанные имена: ', implode(', ', $names), "\n";
echo 'Документ после закрытия каталога: ', file_get_contents(__DIR__ . '/documents/104.txt');

Прочитанные имена: 104.txt, 105.txt
Документ после закрытия каталога: Выдать две дрели

Закрывается ресурс перечисления каталога; файлы сохраняются. У close нет полезного возвращаемого значения — void. Для нового перечисления открывают новый ресурс, не повторно используют закрытый.

<?php
declare(strict_types=1);

$directory = dir(__DIR__ . '/documents');
if ($directory === false) { throw new RuntimeException('Не открыть документы'); }
try {
    try {
        while (($name = $directory->read()) !== false) {
            if ($name === '.' || $name === '..') { continue; }
            $text = file_get_contents(__DIR__ . '/documents/' . $name);
            json_decode($text, true, 8, JSON_THROW_ON_ERROR);
        }
    } finally { $directory->close(); }
} catch (JsonException $error) { echo "Импорт остановлен: документ содержит неверный JSON.\n"; }
echo is_resource($directory->handle) ? "Каталог ещё открыт.\n" : "Каталог закрыт после отказа.\n";

Импорт остановлен: документ содержит неверный JSON.
Каталог закрыт после отказа.

В файле 104.json отсутствует значение после двоеточия. finally закрывает каталог при реальном отказе парсера; внешний catch объясняет исправление. После закрытия ресурс не читают и не закрывают второй раз.

<?php
declare(strict_types=1);

$handle = opendir(__DIR__ . '/documents');
if ($handle === false) { throw new RuntimeException('Не открыть документы'); }
try {
    foreach (['Предпросмотр', 'Подборка'] as $label) {
        $names = [];
        while (($name = readdir($handle)) !== false) {
            if ($name !== '.' && $name !== '..') { $names[] = $name; }
        }
        sort($names, SORT_STRING);
        echo $label, ': ', implode(', ', $names), "\n";
        rewinddir($handle);
    }
} finally { closedir($handle); }

Предпросмотр: 104.txt, 105.txt
Подборка: 104.txt, 105.txt

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

<?php
declare(strict_types=1);

$handle = opendir(__DIR__ . '/documents');
if ($handle === false) { throw new RuntimeException('Не открыть документы'); }
try {
    $names = [];
    while (($name = readdir($handle)) !== false) {
        if ($name !== '.' && $name !== '..') { $names[] = $name; }
    }
    sort($names, SORT_STRING);
    echo 'Предпросмотр: ', implode(', ', $names), "\n";
    rewinddir($handle);
    $documents = [];
    while (($name = readdir($handle)) !== false) {
        if ($name === '.' || $name === '..') { continue; }
        $text = file_get_contents(__DIR__ . '/documents/' . $name);
        if ($text === false) { throw new RuntimeException('Документ недоступен'); }
        $documents[$name] = $text;
    }
    ksort($documents, SORT_STRING);
    foreach ($documents as $name => $text) { echo $name, ': ', $text; }
} finally { closedir($handle); }

Предпросмотр: 104.txt, 105.txt
104.txt: Выдать две дрели
105.txt: Выдать одну пилу

Первый проход получает только имена, второй заново перечисляет каталог и читает содержимое. Без перемотки второй цикл уже находится в конце. Каталог может измениться; это не snapshot. Когда свежий обход не требуется, проще сохранить и использовать первый список.

<?php
declare(strict_types=1);

$directory = dir(__DIR__ . '/documents');
if ($directory === false) { throw new RuntimeException('Не открыть документы'); }
try {
    foreach (['Предпросмотр', 'Подборка'] as $label) {
        $names = [];
        while (($name = $directory->read()) !== false) {
            if ($name !== '.' && $name !== '..') { $names[] = $name; }
        }
        sort($names, SORT_STRING);
        echo $label, ': ', implode(', ', $names), "\n";
        $directory->rewind();
    }
} finally { $directory->close(); }

Предпросмотр: 104.txt, 105.txt
Подборка: 104.txt, 105.txt

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

<?php
declare(strict_types=1);

$directory = dir(__DIR__ . '/documents');
if ($directory === false) { throw new RuntimeException('Не открыть документы'); }
try {
    $names = [];
    while (($name = $directory->read()) !== false) {
        if ($name !== '.' && $name !== '..') { $names[] = $name; }
    }
    sort($names, SORT_STRING);
    echo 'Предпросмотр: ', implode(', ', $names), "\n";
    $directory->rewind();
    $documents = [];
    while (($name = $directory->read()) !== false) {
        if ($name === '.' || $name === '..') { continue; }
        $text = file_get_contents(__DIR__ . '/documents/' . $name);
        if ($text === false) { throw new RuntimeException('Документ недоступен'); }
        $documents[$name] = $text;
    }
    ksort($documents, SORT_STRING);
    foreach ($documents as $name => $text) { echo $name, ': ', $text; }
} finally { $directory->close(); }

Предпросмотр: 104.txt, 105.txt
104.txt: Выдать две дрели
105.txt: Выдать одну пилу

Первый проход получает только имена, второй заново перечисляет каталог и читает содержимое. Без перемотки второй цикл уже находится в конце. Каталог может измениться; это не snapshot. Когда свежий обход не требуется, проще сохранить и использовать первый список.

<?php
declare(strict_types=1);

$directory = dir(__DIR__ . '/documents');
if ($directory === false) { throw new RuntimeException('Не открыть документы'); }
$names = [];
try {
    while (($name = $directory->read()) !== false) {
        if ($name === '.' || $name === '..') { continue; }
        if (is_file(__DIR__ . '/documents/' . $name)) { $names[] = $name; }
    }
} finally { $directory->close(); }
sort($names, SORT_STRING);
foreach ($names as $name) {
    echo $name, ': ', file_get_contents(__DIR__ . '/documents/' . $name);
}

0: Заказ без присвоенного номера
104.txt: Выдать две дрели
105.txt: Выдать одну пилу

dir создаёт объект Directory. ->read() вызывает метод этого объекта; ->close() закрывает его ресурс. Объект хранит тот же поток имён, что использовали процедурные функции.

<?php
declare(strict_types=1);

$directory = dir(__DIR__ . '/documents');
if ($directory === false) { throw new RuntimeException('Не открыть документы'); }
try {
    $names = [];
    while (($name = readdir($directory->handle)) !== false) {
        if ($name !== '.' && $name !== '..') { $names[] = $name; }
    }
    echo $directory->read() === false ? "Метод тоже видит конец каталога.\n" : "Остались имена.\n";
    sort($names, SORT_STRING);
    echo 'Прочитаны: ', implode(', ', $names), "\n";
} finally { $directory->close(); }

Метод тоже видит конец каталога.
Прочитаны: 104.txt, 105.txt

readdir получает свойство handle; метод read использует его же. Поэтому после полного прохода функцией метод уже видит конец. Не закрывайте этот ресурс дважды разными интерфейсами.

<?php
declare(strict_types=1);

$directory = dir('catalog');
if ($directory === false) { throw new RuntimeException('Cannot open catalog'); }
try {
    echo $directory->path, "\n";
    try { $directory->path = 'other'; }
    catch (Error $error) { echo "readonly path\n"; }
} finally { $directory->close(); }

catalog
readonly path

Подмена path не должна переводить handle в другой каталог. Чтобы открыть другое место, создайте другой объект dir.

<?php
declare(strict_types=1);

$reflection = new ReflectionClass(Directory::class);
$methods = array_map(static fn(ReflectionMethod $m): string => $m->getName(), $reflection->getMethods());
sort($methods);
echo implode(', ', $methods), "\n";
var_dump($reflection->isFinal());

close, read, rewind
bool(true)

Метаданные проверены на PHP 8.5.11; до PHP 8.5 класс не был final. Для своего сервиса оборачивайте Directory отдельным объектом, если нужно добавить бизнес-правила.

<?php
declare(strict_types=1);

$current = getcwd();
if ($current === false) { throw new RuntimeException('Не определить рабочую папку'); }
echo file_get_contents($current . '/documents/104.txt');

Выдать две дрели

Архив запускается из собственной папки, где находится documents. getcwd возвращает фактический абсолютный путь этой папки. При запуске из другого места он может отличаться от __DIR__; для соседних файлов исходника обычно проще __DIR__.

<?php
declare(strict_types=1);

$previous = getcwd();
if ($previous === false) { throw new RuntimeException('Нет рабочей папки'); }
echo 'В основной папке: ', file_get_contents('status.txt');
if (!chdir(__DIR__ . '/archive')) { throw new RuntimeException('Не перейти в архив'); }
try { echo 'В архиве: ', file_get_contents('status.txt'); }
finally { if (!chdir($previous)) { throw new RuntimeException('Не восстановить папку'); } }
echo 'После возврата: ', file_get_contents('status.txt');

В основной папке: ready
В архиве: closed
После возврата: ready

Одинаковое имя status.txt обозначает разные файлы в разных cwd. finally восстанавливает прежнюю точку отсчёта. Смена cwd — состояние выполнения, а не локальная настройка одной функции.

<?php
declare(strict_types=1);

$previous = getcwd();
if ($previous === false || !chdir('catalog')) { throw new RuntimeException('Cannot enter catalog'); }
try { echo file_get_contents('a.txt'); }
finally { if (!chdir($previous)) { throw new RuntimeException('Cannot restore directory'); } }

A

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

<?php
declare(strict_types=1);

echo 'Текущий заказ: ', file_get_contents(__DIR__ . '/status.txt');
echo 'Архивный заказ: ', file_get_contents(__DIR__ . '/archive/status.txt');

Текущий заказ: ready
Архивный заказ: closed

__DIR__ привязывает пути к исходнику; явное основание обычно удобнее chdir для нового кода и не меняет поведение соседних относительных путей.

<?php
declare(strict_types=1);

$available = function_exists('chroot');
if (PHP_OS_FAMILY === 'Windows' || PHP_ZTS) {
    var_dump($available === false);
} else {
    var_dump(is_bool($available));
}

bool(true)

Сам chroot здесь не вызывается. Проверка выполнена в Windows; поддерживаемый Unix, root-права и реальная изоляция этим опытом не проверены.

<?php
declare(strict_types=1);

if (PHP_SAPI !== 'cli' || PHP_ZTS || !function_exists('chroot')) {
    throw new RuntimeException('Requires supported non-ZTS Unix CLI');
}
// Только фиксированное дерево, подготовленное администратором заранее.
if (!chroot('/srv/example-jail')) {
    throw new RuntimeException('Cannot change process root');
}
echo getcwd(), "\n";

После успешного вызова ожидаемый cwd — /. Фрагмент проверяется только синтаксически и не запускается: в текущем Windows нет этой функции. Подготовка jail, зависимостей и сброс привилегий относятся к отдельному системному решению; не переносите такой вызов в обработчик формы.