Пошаговая установка Laravel 11

Laravel — это современный PHP-фреймворк для создания веб-приложений. Он предоставляет удобную структуру, встроенные инструменты для работы с базами данных, очередями, аутентификацией и тестированием. Это руководство поможет вам установить Laravel на локальную машину и запустить первый проект.

Что понадобится

  • PHP версии 8.1 или выше (рекомендуется 8.4)
  • Composer — менеджер зависимостей для PHP
  • Laravel Installer (устанавливается через Composer)
  • Node.js и NPM (или Bun) — для сборки фронтенда (необязательно, но рекомендуется)
  • Терминал (командная строка)

Пошаговая инструкция

1. Установите PHP и Composer

Если PHP и Composer ещё не установлены, воспользуйтесь официальным скриптом для вашей операционной системы:

macOS / Linux

/bin/bash -c "$(curl -fsSL https://php.new/install/mac/8.4)"

Windows (запустите PowerShell от имени администратора)

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://php.new/install/windows/8.4'))

После завершения перезапустите терминал. С помощью команды php -v убедитесь, что PHP установлен.

2. Установите Laravel Installer

Если Composer уже есть, выполните глобальную установку:

composer global require laravel/installer

Добавьте директорию ~/.composer/vendor/bin в переменную PATH, если она ещё не добавлена (обычно это делается автоматически).

3. Создайте новый проект Laravel

Используйте команду laravel new. В процессе мастер предложит выбрать тестовый фреймворк, базу данных и стартовый комплект (starter kit). Можно соглашаться с предложенными по умолчанию.

laravel new example-app

4. Перейдите в папку проекта

cd example-app

5. Установите зависимости фронтенда и выполните сборку (опционально, но рекомендуется)

npm install && npm run build

6. Запустите встроенный сервер разработки

Laravel поставляется со скриптом dev, который одновременно запускает PHP-сервер, очередь и сборщик Vite.

composer run dev

7. Откройте приложение в браузере

Перейдите по адресу http://localhost:8000. Вы должны увидеть стартовую страницу Laravel.

Возможные ошибки и их решения

Ошибка: «laravel: command not found»
Убедитесь, что глобальная папка Composer (~/.composer/vendor/bin или ~/.config/composer/vendor/bin) добавлена в PATH. Перезагрузите терминал или выполните export PATH="$PATH:$HOME/.composer/vendor/bin".

Ошибка: «PHP Fatal error: Composer requires PHP 8.1+»
Проверьте версию PHP (php -v). Обновите PHP до версии 8.1 или выше. На Windows используйте официальный инсталлятор или Laragon.

Ошибка: «ext-xxx is missing»
Установите недостающие расширения PHP (например, pdo_mysql, mbstring, xml, curl). В Linux используйте менеджер пакетов (apt install php-mbstring php-xml php-curl). В macOS через Homebrew: brew install php.

Ошибка: «Permission denied» при создании файлов
Убедитесь, что права на папку storage и bootstrap/cache корректны. На Linux/macOS: chmod -R 775 storage bootstrap/cache.

Ошибка: «Target class [....] does not exist»
Выполните composer dump-autoload и проверьте неймспейсы в проекте.

Полезные советы

  • Для ещё более простой установки на macOS и Windows используйте Laravel Herd. Это графическая среда, которая включает PHP, Composer и Nginx. После установки Herd достаточно выполнить laravel new app в терминале.
  • Если вы предпочитаете контейнеризацию, Laravel Sail (на основе Docker) — хороший выбор. Установите Docker и запустите curl -s https://laravel.build/example-app | bash. Sail сам создаст окружение.
  • Файл .env создаётся автоматически, но настройки базы данных нужно указать вручную, если вы не используете SQLite (по умолчанию).
  • После создания проекта изучите каталог config/ — там находятся все настройки фреймворка. Для большинства проектов ничего менять не требуется.
  • Для регулярного обновления PHP, Composer и Laravel Installer повторно запускайте команду из шага 1 (/bin/bash -c "$(curl -fsSL https://php.new/install/mac/8.4)"). Она обновит все компоненты до актуальных версий.
  • На этапе разработки используйте composer run dev — он запускает и PHP-сервер, и Vite для горячей замены модулей. Для продакшена собирайте статику через npm run build.