Требования окружения

• PHP 8.1+ (или версия, указанная в composer.json) с расширениями: mbstring, openssl, pdo_mysql, tokenizer, xml, ctype, fileinfo, json, bcmath, gd (если требуется).
• Composer (последняя стабильная).
• MySQL 5.7+ / MariaDB совместимая версия.
• Node.js 16+ и npm/yarn.
• Git.

Клонирование репозитория и первоначальная настройка

Клонируйте репозиторий:

• git clone project-name
• cd project-name Создайте файл окружения:
• cp .env.example .env Сгенерируйте APP_KEY:
• composer install --no-interaction --prefer-dist
• php artisan key:generate

Настройте .env: DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=your_database DB_USERNAME=your_user DB_PASSWORD=

2. Установка зависимостей и сборка фронтенда

PHP-пакеты:

• composer install Node-пакеты и сборка:
• npm install
• npm run dev (или vite)
• npm run prod (сборка для продакшена vite build)

3. Настройка базы данных и миграции

• оздайте пустую базу данных и пользователя в MySQL.

Запустите миграции :

• php artisan migrate

Создайте симлинк для хранения:

• php artisan storage:link

Опциональный пункт: создать .htaccess для перенаправления в папку public

RewriteEngine On

# Если запрос уже внутри /public — ничего не делаем
RewriteCond %{REQUEST_URI} !^/public/

# Если запрошенный путь существует как файл или директория в корне — ничего не делаем
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d

# Внутренне перенаправляем все запросы в папку public
RewriteRule ^(.*)$ /public/$1 [L]

# Корневой запрос на public/index.php
RewriteRule ^$ /public/index.php [L]

# Защита .env и служебных файлов Require all denied Require all denied

• Разместите .htaccess в корне репозитория (рядом с app, vendor, composer.json).