В чём отличие между include и require?

Question

Accepted Answer

Оба конструкта `include` и `require` импортируют (и выполняют) содержимое другого PHP-файла в текущий файл. **Единственное отличие — как они обрабатывают ошибки**: `require` вызывает фатальную ошибку, если файл отсутствует, а `include` только выдаёт предупреждение и продолжает работу.

## Ключевое отличие: поведение при ошибке

```php
<?php
include "config.php";    // if missing → WARNING, script CONTINUES
require "database.php";  // if missing → FATAL ERROR, script STOPS
```

```text
include → file missing → emits a Warning, execution continues (file's code skipped)
require → file missing → throws a Fatal Error, execution HALTS
```

Используйте **`require`** для файлов, без которых приложение **не может работать** (основные классы, критичная конфигурация, инициализация БД) — вы хотите, чтобы оно аварийно остановилось, если их нет. Используйте **`include`** для необязательных файлов (например, шаблон боковой панели), где отсутствие файла не должно привести к краху страницы.

## Варианты с _once (предотвращение повторного включения)

```php
require_once "functions.php";   // include the file ONLY if not already included
include_once "helper.php";
```

`require_once`/`include_once` импортируют файл только в том случае, если он ещё не был включён — это **критично** для избежания ошибок вида "cannot redeclare function/class", когда файл может быть подключён несколько раз (например, определение класса, используемое несколькими файлами).

## Что на самом деле делает включение файла

```php
// included files share the SAME scope and can define functions, classes, variables
// config.php:
$dbHost = "localhost";
// main.php:
require "config.php";
echo $dbHost;   // "localhost" — the variable is available
```

## Современный PHP: автозагрузка заменяет ручное включение

```php
// ❌ old style — manually requiring every class file
require_once "User.php";
require_once "Order.php";

// ✅ modern — Composer AUTOLOADING loads classes on demand automatically
require "vendor/autoload.php";   // one line; classes load when used (PSR-4)
$user = new User();               // User.php loaded automatically
```

В современном PHP вы редко используете ручной `require` для классов — **автозагрузчик Composer** загружает их по требованию. Вы всё ещё используете `require "vendor/autoload.php"` один раз для инициализации.

## Почему это важно

Понимание различия между `include` и `require` — это базовое, но важное знание PHP — это способ, которым PHP-файлы обмениваются кодом, и различие важно для корректности.

Ключевой момент — поведение при ошибке: **`require` для необходимых файлов** (чтобы приложение быстро и ясно упало, если критичный файл отсутствует) и **`include` для необязательных** (чтобы отсутствие некритичного файла не упало страницу).

Знание **вариантов с `_once`** практически незаменимо для предотвращения распространённых ошибок "cannot redeclare" при случайном двойном включении определения класса или функции.

Это также важно понимать современный контекст: хотя эти конструкты — основополагающие, **современный PHP опирается на автозагрузку Composer** (загрузка классов по требованию) вместо ручного подключения каждого файла, поэтому в текущем коде вы в основном просто выполняете `require "vendor/autoload.php"` один раз и позволяете автозагрузке справляться с остальным.

Знание как механики include/require (и когда каждый режим ошибки уместен), так и того, как современная автозагрузка вытесняет ручное включение — это повседневное знание при работе с PHP-кодовыми базами как старыми, так и новыми.