Как я решил ошибку "A facade root has not been set" в Laravel

Профиль / Блог / Laravel / Как я решил ошибку "A facade root has not been set" в Laravel

laravellogo Недавно я столкнулся с ошибкой A facade root has not been set при попытке протестировать функционал в Laravel. Это было довольно неприятно, так как я не мог понять, почему фасады Laravel (например, DB, Cache, Config) не работают в моих тестах. После некоторого исследования и экспериментов я нашел решение, которым хочу поделиться.

Проблема

Я писал тест для своего Laravel-приложения и хотел использовать фасад DB для выполнения SQL-запроса. Мой тест выглядел так:

php

namespace Tests\Feature;

use Tests\TestCase;
use Illuminate\Support\Facades\DB;

class ExampleTest extends TestCase
{
    public function test_example(): void
    {
        $results = DB::select('SELECT * FROM users');
        $this->assertNotEmpty($results);
    }
}

Однако при запуске теста я получил ошибку:

Error: A facade root has not been set.

Почему это происходит?

Ошибка A facade root has not been set возникает, когда Laravel-приложение не инициализировано. Фасады Laravel (например, DB, Cache, Config) работают только тогда, когда Laravel-приложение запущено. Если приложение не инициализировано, фасады не знают, как разрешить свои зависимости, и выбрасывают эту ошибку.

Решение

Я начал исследовать, как инициализировать Laravel-приложение в тестах. Оказалось, что встроенный класс TestCase, от которого наследуются все тесты в Laravel, имеет метод createApplication(). Этот метод отвечает за инициализацию Laravel-приложения.

Шаг 1: Инициализация приложения

Чтобы фасады заработали, нужно вызвать метод createApplication(). Это можно сделать либо в методе setUp() класса TestCase, либо непосредственно в тесте.

Я решил добавить вызов createApplication() в метод setUp() своего тестового класса:

namespace Tests\Feature;

use Tests\TestCase;
use Illuminate\Support\Facades\DB;

class ExampleTest extends TestCase
{
    protected function setUp(): void
    {
        parent::setUp(); // Важно вызвать родительский метод
        $this->createApplication(); // Инициализируем Laravel-приложение
    }

    public function test_example(): void
    {
        $results = DB::select('SELECT * FROM users');
        $this->assertNotEmpty($results);
    }
}

Шаг 2: Проверка

После добавления вызова createApplication() в setUp() я запустил тест снова. На этот раз все сработало без ошибок! Фасад DB успешно выполнил SQL-запрос, и тест прошел.

Почему это работает?

Метод createApplication() инициализирует Laravel-приложение, включая сервис-контейнер и фасады. Когда приложение инициализировано, фасады могут разрешать свои зависимости через сервис-контейнер.

Если вы не вызываете createApplication(), Laravel-приложение не инициализируется, и фасады не могут работать.

Альтернативные подходы

1. Использование `parent::setUp()`

В большинстве случаев достаточно вызвать parent::setUp() в методе setUp() вашего теста. Родительский класс TestCase уже вызывает createApplication() за вас.

Пример:

protected function setUp(): void
{
    parent::setUp(); // Вызывает createApplication() автоматически
}

### 2. **Инициализация в тесте**

Если вы не хотите изменять `setUp()`, вы можете вызвать `createApplication()` непосредственно в тесте:

php

Copy

public function test_example(): void
{
    $this->createApplication(); // Инициализируем Laravel-приложение
    $results = DB::select('SELECT * FROM users');
    $this->assertNotEmpty($results);
}

Вывод

Ошибка A facade root has not been set возникает, когда Laravel-приложение не инициализировано. Чтобы исправить это, нужно вызвать метод createApplication(), который инициализирует приложение и делает фасады доступными.

В моем случае добавление вызова createApplication() в setUp() решило проблему. Теперь мои тесты работают корректно, и я могу использовать фасады Laravel без каких-либо проблем.

Если вы столкнулись с подобной ошибкой, надеюсь, мой опыт поможет вам быстро ее решить. Удачи в тестировании вашего Laravel-приложения! 🚀