Laravel: Target class does not exist — Laravel не находит класс
Laravel сам создаёт контроллеры и middleware, когда к сайту приходит запрос. Ошибка Target class does not exist значит, что класса с таким именем Laravel не нашёл. В квадратных скобках — имя, которое он искал: по нему видно, где ошибка.
Содержание 8
Что сделать прямо сейчас
- Посмотрите, что стоит в квадратных скобках в тексте ошибки.
- Если там полное имя вроде
App\Http\Controllers\UserController— проверьте, что файлapp/Http/Controllers/UserController.phpесть и имя написано с теми же большими и маленькими буквами — как проверить. - Если там одно слово без
App\— например,UserControllerилиadmin, — смотрите раздел про короткое имя. - Сбросьте кеш маршрутов:
php artisan route:clear.
Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Команды выполняются в папке проекта, например cd /var/www/example.com.
Как выглядит ошибка
Target class [App\Http\Controllers\UserController] does not exist.С APP_DEBUG=true в файле .env текст виден на странице. С APP_DEBUG=false посетитель видит 500 и Server Error, а ошибка записана в storage/logs/laravel.log.
Laravel выдаёт эту ошибку, когда PHP не может найти класс по имени. Класс ищется по имени файла и папки: App\Http\Controllers\UserController — это файл app/Http/Controllers/UserController.php.
Если в скобках полное имя контроллера
Проверьте, что файл есть:
ls app/Http/Controllers/| Что видите | Что сделать |
|---|---|
| файла нет | загрузите его на сервер или поправьте имя в routes/web.php |
файл есть, но буквы в имени другие: Usercontroller.php | переименуйте файл, чтобы имя совпало с именем класса |
| файл лежит в другой папке | поправьте имя в строке use в файле маршрутов |
Почему на компьютере работало, а на сервере нет. В Windows и macOS UserController.php и Usercontroller.php — один и тот же файл. В Linux — два разных. Переименовать файл на сервере:
mv app/Http/Controllers/Usercontroller.php app/Http/Controllers/UserController.phpВнутри файла проверьте две строки — они должны совпадать с именем и папкой:
namespace App\Http\Controllers;
class UserController extends ControllerЕсли в скобках короткое имя
Контроллер без App\
Target class [UserController] does not exist.В файле маршрутов контроллер записан строкой без пути, например 'UserController@index'. Так писали в старых версиях Laravel. Начиная с Laravel 8 путь к контроллеру нужно указать. Подключите класс в начале routes/web.php и укажите его в маршруте:
use App\Http\Controllers\UserController;
Route::get('/users', [UserController::class, 'index']);Middleware без псевдонима
Target class [admin] does not exist.В маршруте стоит ->middleware('admin'), но Laravel не знает, какой класс скрывается за словом admin. Задайте псевдоним в файле bootstrap/app.php:
use App\Http\Middleware\EnsureUserIsAdmin;
->withMiddleware(function (Middleware $middleware): void {
$middleware->alias([
'admin' => EnsureUserIsAdmin::class,
]);
})Вместо EnsureUserIsAdmin — ваш класс из папки app/Http/Middleware. Псевдонимы auth, guest, verified, throttle, signed, can и ещё несколько в Laravel уже заданы — их добавлять не нужно.
В старых версиях Laravel псевдонимы задавались в файле app/Http/Kernel.php. В новых проектах Laravel 11 и новее этого файла нет — псевдонимы задают в bootstrap/app.php.
Если файл и имя верные
Маршруты закешированы. Команда php artisan route:cache или php artisan optimize сохраняет маршруты в файл. Если после этого поменяли routes/web.php, Laravel работает со старым списком. Сбросьте кеш:
php artisan route:clearЕсли кеш маршрутов нужен, после правки снова выполните php artisan route:cache.
Composer не знает о новом классе. Если зависимости ставили с ключом --classmap-authoritative, Composer ищет классы только по готовому списку, и нового файла в нём нет. Обновите список:
composer dump-autoloadComposer не запускайте через sudo — почему.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
Target class [App\Http\Controllers\…] does not exist. | нет файла или буквы в имени другие | проверьте файл |
Target class [UserController] does not exist. | контроллер записан без пути | добавьте use |
Target class [admin] does not exist. | не задан псевдоним middleware | задайте alias |
| ошибка осталась после правки маршрутов | маршруты закешированы | php artisan route:clear |
Class "…" not found | PHP не нашёл класс в коде, а не в маршруте | Разбор |
Target [...] is not instantiable. | Laravel не может создать интерфейс без привязки к классу | укажите класс для интерфейса в сервис-провайдере |
Тексты сообщений сверены по исходному коду Laravel 13.42.0.
Источники
- Документация Laravel: Controllers — на английском: как указывать контроллер в маршруте.
- Документация Laravel: Middleware — на английском: псевдонимы middleware и список заданных по умолчанию.
- Исходный код Container в Laravel 13.42.0 — на английском: текст Target class does not exist.
- Документация Composer: Autoloader optimization — на английском: ключ --classmap-authoritative.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Ошибки Laravelвсе ошибки Laravel на одной странице.
- PHP: Class not foundесли PHP не находит класс в коде.
- Ошибки Composerесли не ставятся зависимости.