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

<?php
echo "Перед проверкой\n";
try {
    echo "Проверяем товар\n";
    throw new RuntimeException('Товар недоступен');
    echo "Эта строка не выполнится\n";
} catch (RuntimeException $error) {
    echo 'Отказ: ', $error->getMessage(), "\n";
}
echo "После обработки\n";

Перед проверкой
Проверяем товар
Отказ: Товар недоступен
После обработки

Try ограничивает участок, catch называет принимаемый класс, а $error получает объект с информацией. New RuntimeException создаёт этот объект; throw передаёт его обработчику. Вызов ->getMessage() читает сообщение. Это небольшой первый объект из стандартной библиотеки: писать собственный класс для опыта не требуется.

<?php
$config = [];
try {
    $endpoint = $config['endpoint'] ?? throw new RuntimeException('Не задан адрес API');
    echo $endpoint;
} catch (RuntimeException $error) {
    echo $error->getMessage(), "\n";
}

Не задан адрес API

?? выбирает правую часть, когда поля нет или оно равно null. Справа throw прерывает присваивание: $endpoint не получает «значение ошибки». Прежде чем применять сокращение, разберите ?? и условные выражения. Это проверка обязательной настройки, а не валидация самого URL.

<?php
function lineTotal($quantity)
{
    if ($quantity < 1) {
        throw new InvalidArgumentException('Количество должно быть больше нуля');
    }
    return 150 * $quantity;
}
try {
    echo lineTotal(0), "\n";
    echo "Заказ рассчитан\n";
} catch (InvalidArgumentException $error) {
    echo $error->getMessage(), "\n";
}
echo "Можно исправить ввод\n";

Количество должно быть больше нуля
Можно исправить ввод

При 0 return не достигается, вызывающий echo не получает число, а следующая инструкция «Заказ рассчитан» пропускается. После обработчика выполняется код ниже. Мы не говорим, что расчёт успешно закончился.

<?php
try {
    echo "Начало\n";
    throw new RuntimeException('Поставщик недоступен');
} catch (RuntimeException $error) {
    echo 'Обработали: ', $error->getMessage(), "\n";
} finally {
    echo "Завершили попытку\n";
}

Начало
Обработали: Поставщик недоступен
Завершили попытку

Здесь catch и finally относятся к одному try: сначала обработка, затем finally. Вложенный пример ниже намеренно другой: внутренний finally закрывает поток до внешнего catch.

<?php
function readStock()
{
    echo "Запросили остаток\n";
    throw new RuntimeException('Сервис склада недоступен');
}
function productCard()
{
    $stock = readStock();
    return 'В наличии: ' . $stock;
}
try {
    echo productCard();
} catch (RuntimeException $error) {
    echo "Остаток пока неизвестен\n";
}
echo "Страница подготовлена\n";

Запросили остаток
Остаток пока неизвестен
Страница подготовлена

ReadStock не вернула число, productCard не собрала карточку. Подстановка 0 притворилась бы достоверным отсутствием товара; здесь показано отдельное состояние «неизвестно». В примере сеть не вызывается: сбой намеренно эмулирован, чтобы воспроизвести путь.

<?php
try {
    throw new InvalidArgumentException('Количество должно быть положительным');
} catch (InvalidArgumentException $error) {
    echo "Исправьте количество\n";
} catch (Exception $error) {
    echo "Операция не завершена\n";
}

Исправьте количество

InvalidArgumentException относится к семейству Exception. Если общий catch Exception поставить первым, до специальной обработки количества дело не дойдёт. Связь общего и частного класса объясняет наследование.

<?php
try {
    throw new OutOfBoundsException('Тариф не найден');
} catch (InvalidArgumentException | OutOfBoundsException) {
    echo "Проверьте параметры доставки\n";
}

Проверьте параметры доставки

Вертикальная черта перечисляет допустимые классы для одного обработчика. Такой multi-catch есть с PHP 7.1. Переменная объекта опущена, потому что здесь не читаются его детали; это разрешено с PHP 8. В реальном сервисе диагностические подробности обычно сохраняют отдельно.

<?php
try {
    try {
        throw new RuntimeException('Поставщик не ответил');
    } catch (RuntimeException $error) {
        echo "Сбой зарегистрирован\n";
        throw $error;
    }
} catch (RuntimeException $error) {
    echo "Заказ не отправлен\n";
}

Сбой зарегистрирован
Заказ не отправлен

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

<?php
try {
    try {
        throw new InvalidArgumentException('Неверный запрос');
    } catch (InvalidArgumentException $error) {
        throw new RuntimeException('Не удалось записать журнал');
    } catch (RuntimeException $error) {
        echo "Этот обработчик пропущен\n";
    }
} catch (RuntimeException $error) {
    echo 'Внешний обработчик: ', $error->getMessage(), "\n";
}

Внешний обработчик: Не удалось записать журнал

Список catch относится к своему try, а не друг к другу. Новая ошибка в обработчике уходит к внешней конструкции. Поэтому авария системы журналирования может затмить первоначальную проблему: диагностический путь тоже должен быть продуман.

<?php
try {
    strlen([]);
} catch (Exception $error) {
    echo "Ветка Exception\n";
} catch (Throwable $error) {
    echo get_class($error), "\n";
}

TypeError

Мы специально передали массив функции, принимающей строку. Это ошибка программы, которую следует исправить. Общая граница Throwable полезна для корректного завершения запроса или задания и сохранения диагностики; она не делает продолжение бизнес-операции безопасным.

<?php
function preparedTotal()
{
    $total = 1200;
    try {
        return $total;
    } finally {
        $total = 9999;
        echo "Завершающий шаг\n";
    }
}
echo preparedTotal(), "\n";

Завершающий шаг
1200

Return подготовил значение 1200. Затем выполнился finally. После него вызывающий код получил именно подготовленное число. Пример со скаляром не означает, что изменение общего объекта в finally не будет заметно: для объектов действуют правила общей идентичности.

<?php
function misleadingResult()
{
    try {
        throw new RuntimeException('Сохранение не удалось');
    } finally {
        return 'Успех';
    }
}
echo misleadingResult(), "\n";

Успех

Это намеренно неправильная конструкция для демонстрации. Return в finally подавил исходное исключение. Не возвращайте успешный результат из блока очистки: читатель и вызывающий код потеряют отказ сохранения.

<?php
try {
    try {
        throw new RuntimeException('Ошибка отправки');
    } finally {
        throw new LogicException('Ошибка завершения');
    }
} catch (Throwable $error) {
    echo $error->getMessage(), "\n";
    echo $error->getPrevious()->getMessage(), "\n";
}

Ошибка завершения
Ошибка отправки

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

<?php
try {
    echo "Завершаем процесс\n";
    exit(0);
} finally {
    echo "Этот finally не выполняется\n";
}

Завершаем процесс

Этот самостоятельный учебный процесс заканчивается кодом 0. Exit внутри try/catch, фатальная остановка и внешнее завершение процесса не дают универсальной гарантии очистки. Не используйте finally как единственную защиту от повторного платежа или потери задания.

<?php
function reportRows()
{
    try {
        yield 'Строка A';
        yield 'Строка B';
    } finally {
        echo "Генератор завершён\n";
    }
}
$rows = reportRows();
echo $rows->current(), "\n";
echo "Пауза вызывающего кода\n";
$rows->next();
echo $rows->current(), "\n";
$rows->next();

Строка A
Пауза вызывающего кода
Строка B
Генератор завершён

Этот поздний опыт требует понимания yield и генераторов. Finally ещё не выполнен после первого yield: генератор приостановлен. При нормальном завершении он выполняется. При принудительном закрытии нельзя выдавать новые значения из finally; PHP сообщает Error.

<?php
set_error_handler(function ($severity, $message, $file, $line) {
    if (!(error_reporting() & $severity)) {
        return false;
    }
    throw new ErrorException($message, 0, $severity, $file, $line);
}, E_USER_WARNING);
try {
    trigger_error('Формат старого экспорта больше не поддерживается', E_USER_WARNING);
} catch (ErrorException $error) {
    echo $error->getMessage(), "\n";
    echo $error->getSeverity(), "\n";
} finally {
    restore_error_handler();
}

Формат старого экспорта больше не поддерживается
512

Set_error_handler получает callback и выбранные уровни. False делегирует стандартному механизму. Здесь E_USER_WARNING имеет значение 512. Передача severity/file/line сохраняет происхождение диагностики. Не устанавливайте глобальный перехват всех предупреждений в чужом приложении без согласованной политики.

<?php
class CatalogUnavailable extends RuntimeException
{
    public function __construct(string $message, ?Throwable $previous = null)
    {
        parent::__construct($message, 0, $previous);
    }
}
try {
    try {
        throw new RuntimeException('Тайм-аут тестового источника');
    } catch (RuntimeException $cause) {
        throw new CatalogUnavailable('Каталог пока недоступен', $cause);
    }
} catch (CatalogUnavailable $error) {
    echo $error->getMessage(), "\n";
    echo 'Причина для разработчика: ', $error->getPrevious()->getMessage(), "\n";
}

Каталог пока недоступен
Причина для разработчика: Тайм-аут тестового источника

Родительский конструктор заполнил message, code и previous. В новом классе нет настоящего HTTP-запроса; показана граница между техническим и прикладным смыслом. В браузере строку с технической причиной не выводят пользователю.

<?php
declare(strict_types=1);

class InsufficientStock extends RuntimeException {}
function reserve(int $available, int $requested): int
{
    if ($requested < 1) {
        throw new InvalidArgumentException('Количество должно быть положительным');
    }
    if ($requested > $available) {
        throw new InsufficientStock('Недостаточно остатка');
    }

    return $available - $requested;
}
try {
    echo reserve(2, 3), "\n";
} catch (InsufficientStock $exception) {
    echo "Уменьшите количество: в наличии2\n";
}

Уменьшите количество: в наличии2

Контроллер может превратить ошибку в HTTP 409 или 422 по принятому контракту. Такой расчет сам по себе не резервирует склад конкурентно безопасно; реальная операция требует транзакции/условного обновления. Тип исключения позволяет не перепутать нехватку остатка с недоступностью базы.

<?php
declare(strict_types=1);

$handle = fopen('php://temp', 'w+');
if ($handle === false) {
    throw new RuntimeException('Не открыть временный поток');
}
try {
    try {
        fwrite($handle, '{broken');
        rewind($handle);
        $body = stream_get_contents($handle);
        if ($body === false) {
            throw new RuntimeException('Не прочитать поток');
        }
        json_decode($body, true, 16, JSON_THROW_ON_ERROR);
    } finally {
        fclose($handle);
        echo "Поток закрыт\n";
    }
} catch (JsonException $exception) {
    echo "Разбор не удался\n";
}

Поток закрыт
Разбор не удался

finally работает при обычном раскручивании стека, в том числе return/throw. Не полагайтесь на него при аварийном завершении процесса. Не возвращайте значение из finally: оно может перекрыть исходный return или исключение и скрыть проблему.