Установка Laravel

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

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

  • PHP версии 8.1 или выше (с расширениями BCMath, Ctype, Fileinfo, JSON, Mbstring, OpenSSL, PDO, Tokenizer, XML)
  • Composer (менеджер зависимостей PHP)
  • Node.js и npm (или Bun) — для сборки фронтенд-ассетов (необязательно, но рекомендуется)
  • Терминал (командная строка) с правами администратора (на некоторых этапах)

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

Шаг 1. Установка PHP и Composer

Рекомендуемый способ (для новичков): воспользуйтесь единым скриптом установки от Laravel. Скрипт установит PHP, Composer и Laravel Installer одной командой.

  • macOS / Linux (в терминале):

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

    Для Linux замените mac/8.4 на linux/8.4. При необходимости укажите версию PHP (например, 8.3).

  • 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 (например, через официальный сайт или пакетный менеджер) и Composer по

Composer
A Dependency Manager for PHP
https://getcomposer.org/download/
. Убедитесь, что обе программы доступны в командной строке.

Шаг 2. Установка Laravel Installer (если не был установлен ранее)

Если вы использовали скрипт php.new — Laravel Installer уже установлен. В противном случае установите его глобально через Composer:

composer global require laravel/installer

Проверьте, что каталог ~/.composer/vendor/bin (или %USERPROFILE%\AppData\Roaming\Composer\vendor\bin в Windows) добавлен в переменную PATH. После этого перезапустите терминал.

Шаг 3. Создание нового проекта Laravel

В терминале перейдите в папку, где будет располагаться проект, и выполните:

laravel new example-app

При запуске вам будет предложено выбрать:

  • тестовый фреймворк (Pest или PHPUnit)
  • базу данных (SQLite, MySQL, PostgreSQL и др.)
  • стартовый комплект (starter kit) для аутентификации (можно пропустить)

После ответов на вопросы будет создана папка example-app со всеми необходимыми файлами.

Шаг 4. Установка Node.js-зависимостей (опционально)

Для компиляции фронтенд-ресурсов (CSS, JavaScript) с помощью Vite перейдите в папку проекта и выполните:

cd example-app
npm install
npm run build

Если вы не планируете использовать Vite, этот шаг можно пропустить.

Шаг 5. Запуск сервера разработки

В папке проекта выполните команду:

composer run dev

Эта команда запускает встроенный PHP-сервер (php artisan serve) и, если установлены npm-зависимости, также запускает Vite. После запуска откройте в браузере адрес http://localhost:8000. Вы должны увидеть стартовую страницу Laravel.

Также можно запустить только PHP-сервер отдельно:

php artisan serve

А для компиляции фронтенда в режиме разработки:

npm run dev

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

Ошибка: laravel: command not found

Причина: Laravel Installer не установлен или не добавлен в PATH.
Решение: Установите пакет глобально (composer global require laravel/installer) и убедитесь, что папка vendor/bin Composer доступна в PATH. Перезапустите терминал.

Ошибка при composer install: missing PHP extensions

Причина: Не хватает одного из требуемых расширений (например, mbstring, pdo, bcmath).
Решение: Установите недостающие расширения через менеджер пакетов вашей ОС или включите их в php.ini. В Windows обычно достаточно раскомментировать строки extension=... в php.ini. В macOS/Linux используйте apt, brew или yum.

Ошибка: The process tried to write to a nonexistent pipe (Windows)

Причина: Проблемы с правами доступа или несовместимостью версий.
Решение: Запустите терминал от имени администратора. Убедитесь, что установлены все компоненты (PHP, Composer, Node.js) корректно.

Ошибка: file_put_contents(...): failed to open stream: Permission denied

Причина: У веб-сервера или пользователя нет прав на запись в папки storage и bootstrap/cache.
Решение: Установите правильные разрешения:

chmod -R 775 storage bootstrap/cache

В Windows права обычно настроены автоматически, но может потребоваться проверить владельца папки.

Ошибка: Your PHP version does not satisfy requirements

Причина: Установлена версия PHP ниже 8.1.
Решение: Обновите PHP до версии 8.1 или выше. Проверьте версию командой php -v.

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

  • Для упрощения работы можно использовать Laravel Herd (macOS/Windows) — графический инструмент, который устанавливает PHP, Composer, Laravel Installer и управляет несколькими версиями PHP. Он автоматически настраивает окружение.
  • На Windows хорошей альтернативой является Laragon — полноценная среда разработки с PHP, MySQL, сервером и простым управлением проектами.
  • Если вы планируете работать в команде или разворачивать приложение в продакшене, используйте Laravel Sail (Docker). Он изолирует окружение и гарантирует одинаковые настройки на всех машинах. Подробнее — в официальной документации.
  • Перед началом разработки обязательно настройте файл .env в корне проекта. Укажите параметры базы данных (если не выбрали SQLite), почтового сервера и другие ключи.
  • Если вам не нужен Vite, вы можете использовать php artisan serve вместо composer run dev. Это запустит только PHP-сервер без компиляции фронтенда.
  • Регулярно обновляйте Laravel Installer и сам фреймворк через composer update, чтобы получать исправления и новые возможности.