Полная инструкция по установке Laravel: пошаговое руководство для начинающих и профессионалов

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

1. Системные требования Laravel

Прежде чем установить Laravel, убедитесь, что сервер соответствует минимальным требованиям:

• PHP версии 8.1 или выше
• Расширения PHP: BCMath, Ctype, Fileinfo, JSON, Mbstring, OpenSSL, PDO, Tokenizer, XML
• Composer — менеджер зависимостей PHP
• Сервер: Apache или Nginx
• База данных: MySQL, PostgreSQL, SQLite или SQL Server

Для локальной разработки можно использовать:

• XAMPP, Laragon, MAMP (Windows/Mac)
• Docker-контейнеры с PHP и базой данных
• Laravel Sail — встроенное решение на Docker

2. Установка Composer

Laravel управляет зависимостями через Composer. Чтобы проверить наличие Composer:

composer --version

Если Composer не установлен:

• Windows: скачайте установщик с официального сайта
• Linux/MacOS: выполните команду php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" и следуйте инструкциям

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

Существует несколько способов установки:

3.1 Через Composer

composer create-project --prefer-dist laravel/laravel myproject

Эта команда создаст папку myproject с готовым приложением Laravel и всеми зависимостями.

3.2 Через Laravel Installer

composer global require laravel/installer
laravel new myproject

Laravel Installer создаст новый проект с минимальными настройками.

3.3 Через Laravel Sail (Docker)

curl -s "https://laravel.build/myproject" | bash
cd myproject
./vendor/bin/sail up

Sail создаёт контейнеры с PHP, MySQL, Redis и другими сервисами для разработки.

4. Настройка проекта

4.1 Файл окружения

Файл .env содержит ключевые параметры проекта: база данных, почта, ключ приложения. После установки:

cp .env.example .env
php artisan key:generate

Эта команда сгенерирует уникальный APP_KEY, необходимый для шифрования данных.

4.2 Настройка базы данных

В файле .env указываем параметры подключения:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=mydatabase
DB_USERNAME=root
DB_PASSWORD=secret

Для PostgreSQL используйте:

DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=mydatabase
DB_USERNAME=postgres
DB_PASSWORD=secret

5. Локальный сервер разработки

Для проверки работы приложения запустите встроенный сервер Laravel:

php artisan serve

По умолчанию приложение доступно по адресу: http://127.0.0.1:8000.

6. Структура проекта Laravel

После установки структура проекта выглядит так:

• app/ — контроллеры, модели, сервисы
• bootstrap/ — загрузка фреймворка
• config/ — конфигурационные файлы
• database/ — миграции, фабрики, сидеры
• public/ — корневая папка сайта, фронтенд-ресурсы
• resources/ — шаблоны Blade, локализация, стили
• routes/ — файлы маршрутизации
• storage/ — лог-файлы, кэш, загрузки
• tests/ — юнит и функциональные тесты

7. Установка зависимостей и пакетов

Для работы с дополнительными библиотеками:

// Установка пакета через Composer
composer require package/name

// Пример: Laravel UI для фронтенда
composer require laravel/ui
php artisan ui bootstrap --auth

8. Миграции и база данных

Для создания таблиц используем миграции:

php artisan make:migration create_products_table --create=products
php artisan migrate

Создание модели с миграцией:

php artisan make:model Product -m

Теперь можно использовать Eloquent ORM для работы с таблицей products.

9. Популярные ошибки при установке Laravel

• Ошибка PHP версии — убедитесь, что установлен PHP 8.1+.
• Отсутствие расширений PHP — проверьте pdo, mbstring, xml и другие.
• Composer не найден — убедитесь, что Composer доступен в PATH.
• Проблемы с правами на папки storage/ и bootstrap/cache/.
• APP_KEY не сгенерирован — выполните php artisan key:generate.

10. Интеграция с Git и деплой

• Инициализация Git: git init
• Добавление удалённого репозитория: git remote add origin url
• Деплой на сервер: через SSH, Git, Forge, Envoyer или Docker
• Не забывайте обновлять .env и ключи приложения на сервере

11. Рекомендации по безопасности

• Не храните .env в публичном репозитории
• Используйте HTTPS для всех запросов
• Регулярно обновляйте Laravel и зависимости
• Используйте CSRF токены, валидаторы, политику доступа
• Шифруйте чувствительные данные через Crypt или Laravel Encrypted Casts