Разберём установку Laravel на Windows 11 с нуля: установим PHP и Composer, создадим проект и подключим базу данных. Всё будет максимально понятно и без лишней теории.

34e9372c 186c 472a b166 a5c3f8fdb69e

Установка PHP

Сначала нужен сам PHP. Перейдите на официальный сайт:
https://windows.php.net/download/

Скачайте версию для Windows (x64). Обычно для разработки подходит сборка Thread Safe в формате ZIP-архива.

Создайте на диске папку, например:

C:\php\php-8.5.1

И распакуйте туда содержимое архива. Внутри должен находиться файл php.exe.

Теперь нужно добавить PHP в системную переменную Path, чтобы команда php работала в терминале.

Откройте поиск Windows и введите «Переменные среды». Выберите пункт изменения системных переменных, затем откройте «Переменные среды». В списке найдите переменную Path, нажмите «Изменить» и добавьте путь:

C:\php\php-8.5.1

После сохранения закройте терминал и откройте его заново. Проверьте установку командой:

php --version

Если версия отображается — всё работает.

Настройка php.ini и включение SQLite

В папке с PHP есть файл php.ini-development. Скопируйте его и переименуйте в php.ini.

Откройте этот файл и найдите строки:

;extension=pdo_sqlite
;extension=sqlite3
;extension=fileinfo

Удалите символ ; в начале строк, чтобы получилось:

extension=pdo_sqlite
extension=sqlite3
extension=fileinfo

Это необходимо, чтобы Laravel мог работать с SQLite и файлами.

Сохраните изменения. При необходимости проверьте список подключённых модулей командой:

php -m

Установка Composer

Composer — это менеджер зависимостей PHP. Он нужен для установки Laravel.

Скачайте установщик для Windows с сайта:
https://getcomposer.org/download/

Во время установки укажите путь к вашему php.exe:

C:\php\php-8.5.1\php.exe

После завершения проверьте:

composer --version

Если версия отображается, можно двигаться дальше.

Установка Laravel

Перейдите в папку, где будет находиться проект. Например:

cd api

Создайте Laravel-проект в текущей директории:

composer create-project laravel/laravel .

После установки сгенерируйте ключ приложения:

php artisan key:generate

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

SQLite — это самый простой вариант базы данных. Она хранится в виде одного файла и не требует установки сервера.

Создайте файл базы данных внутри папки database. В PowerShell можно выполнить:

New-Item -ItemType File -Path database\db.sqlite

Теперь откройте файл .env в корне проекта и пропишите:

DB_CONNECTION=sqlite
DB_DATABASE=database/db.sqlite

Проверьте, чтобы имя файла совпадало с реальным.

После этого выполните миграции:

php artisan migrate

Если ошибок нет — база подключена правильно.

Запуск проекта

Запустить встроенный сервер Laravel можно командой:

php artisan serve

Откройте в браузере адрес:

http://127.0.0.1:8000

Если видите стартовую страницу Laravel — установка прошла успешно.

Альтернатива SQLite — MariaDB

SQLite удобна для обучения и небольших проектов. Но если проект планируется серьёзный или предполагается работа в команде, лучше использовать серверную базу данных, например MariaDB.

В этом случае потребуется установить MariaDB Server, создать базу данных и включить в php.ini расширение:

extension=pdo_mysql

В файле .env настройки будут выглядеть так:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_db
DB_USERNAME=root
DB_PASSWORD=пароль

После этого также выполняется команда php artisan migrate.

MariaDB больше подходит для продакшена и проектов с ростом нагрузки. SQLite проще и быстрее в настройке, но используется в основном для разработки или небольших приложений.