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

<?php
declare(strict_types=1);

$stock = file_get_contents(__DIR__ . '/stock.txt');
if ($stock === false) { throw new RuntimeException('Не прочитать остаток'); }
echo 'Чай: ', $stock, " шт.\n";

Чай: 0 шт.

Строка "0" означает отсутствие товара на складе. if (!$stock) перепутал бы этот результат с ошибкой чтения.

<?php
declare(strict_types=1);

$path = __DIR__ . '/item.txt';
$sku = file_get_contents($path, false, null, 0, 3);
$quantity = file_get_contents($path, false, null, -2);
echo 'Товар: ', $sku, '; количество: ', $quantity, "\n";

Товар: TEA; количество: 12

Учебный формат ровно TEA:12: три ASCII-байта SKU, двоеточие, две цифры. offset 0 начинает с первого байта, length 3 берёт SKU, offset -2 берёт последние два байта. Для переменных полей нужен CSV-парсер, а для недоверенной записи — проверка длины и формата.

<?php
declare(strict_types=1);

$body = file_get_contents(__DIR__ . '/cache.json');
if ($body === false) { throw new RuntimeException('Не прочитать кеш'); }
$data = json_decode($body, true, 16, JSON_THROW_ON_ERROR);
if (!is_array($data) || !isset($data['hours']) || !is_string($data['hours'])) {
    throw new UnexpectedValueException('Нет текстового расписания');
}
echo 'Мастерская: ', $data['hours'], "\n";

Мастерская: 10:00–18:00

Чтение возвращает JSON-текст. json_decode превращает его в массив; true выбирает массивы, 16 ограничивает вложенность, JSON_THROW_ON_ERROR сообщает о неверном JSON исключением. Проверка hours задаёт отдельный договор данных.

<?php
declare(strict_types=1);

$queue = file_get_contents(__DIR__ . '/queue.txt');
if ($queue === false) { throw new RuntimeException('Не прочитать очередь'); }
echo $queue === '' ? "Новых заявок нет.\n" : $queue;

Новых заявок нет.

Существующий пустой файл — допустимое состояние очереди. Исчезнувший или недоступный файл означал бы отказ и false; это другое решение для сотрудника.

<?php
declare(strict_types=1);

$path = __DIR__ . '/queue.txt';
$written = file_put_contents($path, '');
if ($written === false) { throw new RuntimeException('Не очистить очередь'); }
echo 'Записано байтов: ', $written, "\n";
echo file_get_contents($path) === '' ? "Очередь пуста.\n" : "Остались заявки.\n";

Записано байтов: 0
Очередь пуста.

Учебная копия queue.txt содержала заявку 104. Запись пустой строки заменяет содержимое, а файл остаётся. Реальная общая очередь требует согласованной блокировки всей обработки или специализированного хранилища.

<?php
declare(strict_types=1);

$path = __DIR__ . '/events.log';
$parts = ['104: ', 'готов', "\n"];
$written = file_put_contents($path, $parts, FILE_APPEND | LOCK_EX);
if ($written !== strlen(implode('', $parts))) { throw new RuntimeException('Неполная запись'); }
echo file_get_contents($path);

104: создан
104: готов

Массив фрагментов соединяется без разделителя. Функция не создаёт JSON или CSV. FILE_APPEND сохраняет строку создания заказа; LOCK_EX относится только к этой записи.

<?php
declare(strict_types=1);

$path = __DIR__ . '/pickup.txt';
$text = "Заказ 104: можно забирать\n";
if (file_put_contents($path, $text, LOCK_EX) !== strlen($text)) {
    throw new RuntimeException('Неполная запись памятки');
}
echo file_get_contents($path);

Заказ 104: можно забирать

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

<?php
declare(strict_types=1);

$bytes = file_put_contents('events.log', "created\n", FILE_APPEND | LOCK_EX);
if ($bytes === false) {
    throw new RuntimeException('Не записать событие');
}
echo file_get_contents('events.log');

created

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

<?php
$stream = fopen(__DIR__ . '/notes.txt', 'rb');
if ($stream === false) { throw new RuntimeException('open'); }
echo fread($stream, 3), "
";
fclose($stream);

TEA

rb читает существующий файл без изменения. Число 3 — байты, не количество букв Unicode.

<?php
declare(strict_types=1);

$stream = fopen(__DIR__ . '/pickup-104.txt', 'x+b');
if ($stream === false) { throw new RuntimeException('Не создать новый файл'); }
try {
    $text = "104: дрель — 2\n";
    if (fwrite($stream, $text) !== strlen($text)) { throw new RuntimeException('Неполная запись'); }
    rewind($stream);
    echo stream_get_contents($stream);
} finally { fclose($stream); }

104: дрель — 2

x создаёт только отсутствующий файл; + позволяет затем прочитать его через тот же поток, b задаёт байтовый режим. При повторном запуске в той же папке открытие откажет: это и защищает от случайной перезаписи.

<?php
declare(strict_types=1);

$handle = fopen('status.txt', 'rb');
if ($handle === false) {
    throw new RuntimeException('Нет доступа');
}
try {
    $line = fgets($handle);
    if ($line === false) {
        throw new UnexpectedValueException('Ожидалась строка');
    }
    echo $line;
} finally {
    fclose($handle);
}

ready

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

<?php
declare(strict_types=1);

$stream = fopen('php://temp', 'w+b');
if ($stream === false) { throw new RuntimeException('Не создать поток'); }
try {
    $text = "Выдать: чай — 2, кофе — 1\n";
    if (fwrite($stream, $text) !== strlen($text) || !rewind($stream)) {
        throw new RuntimeException('Не подготовить отчёт');
    }
    echo stream_get_contents($stream);
} finally { fclose($stream); }

Выдать: чай — 2, кофе — 1

Временный поток нужен, когда следующая функция принимает поток, например fputcsv. После закрытия этот временный отчёт исчезнет; постоянный файл создаётся по обычному пути.

<?php
$h = fopen(__DIR__ . '/lines.txt', 'rb');
echo json_encode(fgets($h)), "
";
fclose($h);

"Tea\n"

JSON делает невидимый LF заметным.

<?php
$h = fopen(__DIR__ . '/lines.txt', 'rb');
try {
    while (($part = fgets($h, 4)) !== false) { echo json_encode($part), "
"; }
    if (!feof($h)) { throw new RuntimeException('read'); }
} finally { fclose($h); }

"ABC"
"DE\n"

4 означает максимум 3 байта. Это уже фрагменты, а не гарантированно целые строки.

<?php
declare(strict_types=1);

$stream = fopen(__DIR__ . '/waiting.txt', 'rb');
if ($stream === false) { throw new RuntimeException('Не открыть список'); }
try {
    while (($line = fgets($stream)) !== false) {
        $name = trim($line);
        if ($name === '') { continue; }
        echo 'Пригласить: ', $name, "\n";
    }
    if (!feof($stream)) { throw new RuntimeException('Ошибка чтения'); }
} finally { fclose($stream); }

Пригласить: Анна
Пригласить: Борис

while получает по строке; continue пропускает только пустое имя и переходит к следующей строке. В этом формате пробелы вокруг имени незначимы. Для текста, где они важны, используйте rtrim($line, "\r\n"), как в следующем опыте.

<?php
declare(strict_types=1);

$handle = fopen('line.txt', 'rb');
if ($handle === false) { throw new RuntimeException('Не открыть'); }
try {
    $line = fgets($handle);
    if ($line === false) { throw new RuntimeException('Нет строки'); }
    echo '[', rtrim($line, "\r\n"), "]\n";
} finally { fclose($handle); }

[ value ]

Rtrim удаляет перевод строки, но сохраняет значимые пробелы значения. Обычный trim изменил бы данные.

<?php
$h = fopen(__DIR__ . '/items.csv', 'rb');
$row = fgetcsv($h, null, ',', '"', '');
echo json_encode($row), "
";
fclose($h);

["tea","black, large"]

Разделение explode дало бы три части, CSV — два поля.

<?php
declare(strict_types=1);

$stream = fopen(__DIR__ . '/pickup.csv', 'rb');
if ($stream === false) { throw new RuntimeException('Не открыть CSV'); }
try {
    while (($row = fgetcsv($stream, null, ',', '"', '')) !== false) {
        if ($row === [null]) { continue; }
        if (count($row) !== 2) { throw new UnexpectedValueException('Нужны номер и комментарий'); }
        echo 'Заказ ', $row[0], ":\n", $row[1], "\n";
    }
    if (!feof($stream)) { throw new RuntimeException('Ошибка чтения'); }
} finally { fclose($stream); }

Заказ 104:
Забрать после 18:00
Позвонить у входа

Один комментарий содержит LF внутри кавычек. fgetcsv возвращает его одним полем, хотя запись занимает две физические строки. Пустая запись даёт [null]; политика примера её пропускает.

<?php
declare(strict_types=1);

$h = fopen('products.csv', 'rb');
if ($h === false) { throw new RuntimeException('Не открыть'); }
try {
    $row = fgetcsv($h, 0, ',', '"', '');
    if ($row === false || count($row) !== 2) { throw new RuntimeException('Формат'); }
    echo $row[0], ':', $row[1], "\n";
} finally { fclose($h); }

A:Tea, green

CSV-парсер сохраняет запятую внутри кавычек одним полем. Простое explode дало бы три элемента.

<?php
declare(strict_types=1);

$h = fopen('supplier.csv', 'rb');
if ($h === false) { throw new RuntimeException('Не открыть'); }
try {
    $row = fgetcsv($h, 0, ';', '"', '');
    if ($row === false) { throw new RuntimeException('Нет записи'); }
    echo implode('|', $row), "\n";
} finally { fclose($h); }

A|2|149.90

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

<?php
$h = fopen(__DIR__ . '/items.csv', 'w+b');
fputcsv($h, ['tea', 'black, large'], ',', '"', '', "
");
rewind($h);
echo stream_get_contents($h);
fclose($h);

tea,"black, large"

Кавычки расставляет сериализатор, не вручную склеенный шаблон.

<?php
declare(strict_types=1);

$stream = fopen(__DIR__ . '/sizes.csv', 'w+b');
if ($stream === false) { throw new RuntimeException('Не открыть CSV'); }
try {
    if (fputcsv($stream, ['T-1', 'size "L"'], ';', '"', '', "\r\n") === false) {
        throw new RuntimeException('Не записать CSV');
    }
    rewind($stream);
    echo 'Файл: ', stream_get_contents($stream);
    rewind($stream);
    $row = fgetcsv($stream, null, ';', '"', '');
    if ($row === false || count($row) !== 2) { throw new RuntimeException('Не прочитать товар'); }
    echo 'Товар ', $row[0], ': ', $row[1], "\n";
} finally { fclose($stream); }

Файл: T-1;"size ""L"""

Товар T-1: size "L"

В файле внутренняя кавычка удвоена, в восстановленном названии снова одна кавычка. Параметры читателя и писателя одинаковы; CRLF задан явно, поток открыт с b. Проверка сравнивает фактические байты после нормализации переводов строк тестовым запуском.

<?php
declare(strict_types=1);

$h = fopen('php://temp', 'w+');
if ($h === false) { throw new RuntimeException('Поток'); }
try {
    if (fputcsv($h, ['A', 'Tea, green'], ',', '"', '') === false) { throw new RuntimeException('Запись'); }
    rewind($h);
    echo stream_get_contents($h);
} finally { fclose($h); }

A,"Tea, green"

Функция ставит кавычки там, где они нужны для формата. Сами поля уже должны быть выбраны в нужном порядке.

<?php
declare(strict_types=1);

$h = fopen('php://temp', 'w+');
if ($h === false) { throw new RuntimeException('Поток'); }
try {
    fputcsv($h, ['Cable "Pro"', 2], ';', '"', '');
    rewind($h);
    echo stream_get_contents($h);
} finally { fclose($h); }

"Cable ""Pro""";2

Внутренние кавычки удваиваются. Это CSV-синтаксис, а не HTML-сущности; htmlspecialchars здесь исказил бы переносимый текст.

<?php
$h = fopen(__DIR__ . '/counter.txt', 'rb');
if ($h === false) { throw new RuntimeException('open'); }
try {
    if (!flock($h, LOCK_SH)) { throw new RuntimeException('lock'); }
    echo stream_get_contents($h), "
";
    flock($h, LOCK_UN);
} finally { fclose($h); }

8

Файл читается через тот же handle. Особенно важно на Windows, где второй handle может не получить доступ.

<?php
$h = fopen(__DIR__ . '/counter.txt', 'c+b');
if ($h === false) { throw new RuntimeException('open'); }
try {
    $wouldBlock = 0;
    if (!flock($h, LOCK_EX | LOCK_NB, $wouldBlock)) {
        throw new RuntimeException($wouldBlock ? 'busy: retry later' : 'lock failed');
    }
    $old = stream_get_contents($h);
    if ($old === false || !ctype_digit($old)) { throw new RuntimeException('bad counter'); }
    $new = (string) ((int) $old + 1);
    rewind($h);
    if (!ftruncate($h, 0) || fwrite($h, $new) !== strlen($new) || !fflush($h)) {
        throw new RuntimeException('write failed');
    }
    flock($h, LOCK_UN);
    echo $new, "
";
} finally { fclose($h); }

9

ctype_digit разрешает только цифры строки; пример маленького счётчика не решает переполнение int и crash recovery. c+ не обнуляет до lock.

<?php
declare(strict_types=1);

$stream = fopen(__DIR__ . '/stock.txt', 'c+b');
if ($stream === false) { throw new RuntimeException('Не открыть остаток'); }
try {
    if (!flock($stream, LOCK_EX)) { throw new RuntimeException('Не получить блокировку'); }
    $raw = stream_get_contents($stream);
    if ($raw === false || preg_match('/\A[0-9]{1,6}\z/', $raw) !== 1) {
        throw new UnexpectedValueException('Некорректный остаток');
    }
    $quantity = (int) $raw;
    if ($quantity < 2) { throw new RuntimeException('Недостаточно товара'); }
    $next = (string) ($quantity - 2);
    if (!rewind($stream) || !ftruncate($stream, 0) || fwrite($stream, $next) !== strlen($next) || !fflush($stream)) {
        throw new RuntimeException('Не сохранить остаток');
    }
    echo 'Выдано: 2. Осталось: ', $next, ".\n";
    flock($stream, LOCK_UN);
} finally { fclose($stream); }

Выдано: 2. Осталось: 5.

c+b не обрезает файл до блокировки. Чтение, проверка достаточного остатка и запись находятся под одним LOCK_EX. Это учебное согласование процессов, а не устойчивая транзакция магазина: авария между обрезанием и записью может потерять состояние; для реальных остатков обычно нужна БД.

<?php
declare(strict_types=1);

$lock = fopen(__DIR__ . '/report.lock', 'c');
if ($lock === false) { throw new RuntimeException('Не открыть блокировку'); }
try {
    if (!flock($lock, LOCK_EX | LOCK_NB, $blocked)) {
        echo $blocked ? "Отчёт уже собирается.\n" : "Не удалось взять блокировку.\n";
    } else {
        $report = "Сегодня выдать: 3 заказа\n";
        if (file_put_contents(__DIR__ . '/report.txt', $report) !== strlen($report)) {
            throw new RuntimeException('Не сохранить отчёт');
        }
        echo $report;
        flock($lock, LOCK_UN);
    }
} finally { fclose($lock); }

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

Файл report.lock отдельный, а блокировка удерживается до конца записи report.txt. Здесь исполняется одиночный успешный запуск; это не нагрузочное доказательство гонок. Все другие исполнители должны брать тот же lock на той же файловой системе.

<?php
$resolved = realpath(__DIR__ . '/./stock.txt');
if ($resolved === false) { throw new RuntimeException('Нет файла'); }
echo basename($resolved), "\n";
var_dump(realpath(__DIR__ . '/future.txt'));

stock.txt
bool(false)

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

<?php
declare(strict_types=1);

$allowed = ['stock' => __DIR__ . '/stock.txt'];
foreach (['stock', '../secret'] as $requested) {
    $path = isset($allowed[$requested]) ? realpath($allowed[$requested]) : false;
    if ($path === false) {
        echo 'Отчёт ', $requested, ": недоступен\n";
        continue;
    }
    $text = file_get_contents($path);
    if ($text === false) { throw new RuntimeException('Ошибка чтения отчёта'); }
    echo 'Отчёт ', $requested, ': ', $text;
}

Отчёт stock: TEA: 8 шт.
Отчёт ../secret: недоступен

Посетитель выбирает ключ stock, сервер определяет путь. realpath разрешает существующий путь; неизвестный ключ отбрасывается до файлового доступа. Разрешение по пользователю и защита каталога от чужой записи остаются отдельными требованиями.

<?php
declare(strict_types=1);

$resolved = realpath('sample.txt');
echo $resolved === false ? "Нет файла\n" : basename($resolved) . "\n";

sample.txt

Вывод не показывает абсолютный серверный путь. После этого операция чтения может все равно завершиться ошибкой — ее результат проверяется.

<?php
declare(strict_types=1);

$allowed = ['guide' => 'guide.txt'];
$requested = 'guide';
$path = isset($allowed[$requested]) ? realpath($allowed[$requested]) : false;
echo $path === false ? "Не найдено\n" : basename($path) . "\n";

guide.txt

Разрешенная карта ID исключает произвольный путь в параметре. Для динамического хранилища аналогом будет проверенная запись метаданных и право доступа.