Файл NotFoundHttpException.php в Cotonti

класс NotFoundHttpException, который используется для обработки HTTP-ошибок с кодом 404 (ресурс не найден). Этот класс наследует стандартный класс HttpException, который был описан ранее, и предназначен для представления ошибки, когда запрашиваемая страница или ресурс не могут быть найдены на сервере.

<?php

declare(strict_types=1);  // Включение строгой типизации, что означает обязательное соблюдение типов данных

namespace cot\exceptions;  // Пространство имён, в котором будет размещён класс. Этот класс относится к исключениям в движке Cotonti.

use Exception;  // Импорт стандартного класса Exception для работы с исключениями в PHP

/**
 * NotFoundHttpException представляет HTTP-исключение "Не найдено" с кодом состояния 404.
 */
class NotFoundHttpException extends HttpException  // Класс наследует HttpException, предоставляя логику обработки ошибок с кодом 404
{
    protected $code = 404;  // Устанавливается код состояния HTTP, равный 404 (Не найдено)
}

Основные моменты:

1. Наследование от HttpException: Класс NotFoundHttpException расширяет HttpException. Это означает, что он будет использовать логику обработки HTTP-ошибок, предоставляемую родительским классом, но с конкретизацией, что ошибка связана с отсутствием ресурса, что соответствует статус-коду 404.

2. Код ошибки 404: В отличие от общего класса HttpException, который может работать с любым HTTP-кодом ошибки, класс NotFoundHttpException фиксирует код 404 как статус ошибки. Этот код указывает, что запрашиваемый ресурс не был найден на сервере.

3. Документация: В комментарии указывается, что данный класс представляет собой исключение для ошибки "Не найдено" с кодом состояния 404, что соответствует стандартному статусу HTTP, используемому для ответа на запросы к несуществующим страницам.

Пример использования:

Когда в приложении возникает ситуация, в которой пользователь пытается получить доступ к несуществующему ресурсу, можно выбросить это исключение, например:

if ($item === null) {  // Если элемент не найден
    throw new \cot\exceptions\NotFoundHttpException('Запрашиваемый элемент не найден.');  // Выбрасывается исключение с кодом 404
}

Этот код генерирует HTTP-ответ с кодом состояния 404, который обычно приводит к отображению стандартной страницы ошибки "Страница не найдена" в браузере пользователя.

Задачи и условия:

• Представление ошибки 404 (ресурс не найден): Этот класс используется для выражения ошибки, которая возникает, когда запрашиваемая страница или ресурс не могут быть найдены на сервере.

• Упрощение обработки ошибок HTTP: Класс позволяет централизованно обработать ошибку "Не найдено", без необходимости вручную указывать код ошибки в каждом случае. Он наследует логику из HttpException, что упрощает работу с ошибками в системе.

• Интеграция с обработчиками ошибок: Этот класс можно использовать в механизмах обработки ошибок Cotonti CMF, обеспечивая корректный ответ на запросы к несуществующим страницам.

Заключение:

NotFoundHttpException — это специализированное исключение для обработки ошибок с кодом состояния 404, которое сигнализирует о том, что запрашиваемый ресурс не найден на сервере. Использование этого класса позволяет централизовать обработку ошибок, связанных с отсутствием ресурса, в движке Cotonti CMF.