laravel-deploy
Используйте этот навык для деплоя Laravel приложений и сборки Docker-образов. Включает лучшие практики по оптимизации, настройке окружения и безопасности. Охватывает многоэтапную сборку (multi-stage build), настройку Nginx, Supervisord и автоматизацию через entrypoint-скрипты.
- License 许可
- MIT
- 最近更新
- 2026-07-30
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- laravel-deploy
- license
- MIT
- metadata
- { "author": "Junie" }
- description
- Используйте этот навык для деплоя Laravel приложений и сборки Docker-образов. Включает лучшие практики по оптимизации, настройке окружения и безопасности. Охватывает многоэтапную сборку (multi-stage build), настройку Nginx, Supervisord и автоматизацию через entrypoint-скрипты.
02 资源文件 6
- 其他reference/.dockerignore354 B
- 脚本reference/docker/entrypoint.sh314 B
- 其他reference/docker/nginx.conf1.1 KB
- 其他reference/docker/php.ini292 B
- 其他reference/docker/supervisord.conf1.0 KB
- 其他reference/Dockerfile2.7 KB
03 SKILL.md 正文
Laravel Deployment & Dockerization
Этот навык описывает процесс подготовки Laravel приложения к продакшену, сборку оптимизированных Docker-образов и выполнение шагов деплоя.
Сборка Docker-образа
В этом проекте используется многоэтапная сборка (multi-stage build) для минимизации размера финального образа и разделения зависимостей.
Основные этапы (Stages):
- composer_stage: Установка PHP зависимостей через Composer без dev-пакетов.
- node_stage: Сборка фронтенд-активов (Vite, React, Tailwind CSS 4).
- Final Stage: Финальный образ на базе
php:8.5-fpm-alpine, включающий Nginx и Supervisord.
Пример сборки:
# Сборка образа с тегом 'prod-app'
docker build -t prod-app .
Структура Docker-конфигурации
Dockerfile: Основной файл сборки..dockerignore: Список игнорируемых файлов.docker/nginx.conf: Конфигурация Nginx для обслуживания Laravel.docker/php.ini: Настройки PHP для продакшена.docker/supervisord.conf: Управление процессами (php-fpm, nginx, worker).docker/entrypoint.sh: Скрипт, запускаемый при старте контейнера.
Примеры файлов (Reference)
Для наглядности, все конфигурационные файлы текущего проекта доступны в папке reference/:
Оптимизация для продакшена
При деплое необходимо выполнить кэширование конфигурации и маршрутов для повышения производительности. В данном проекте это автоматизировано в entrypoint.sh:
# Выполняется внутри контейнера при старте
php artisan migrate --force
php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan event:cache
php artisan storage:link
Деплой-чеклист
- Environment: Убедитесь, что
APP_ENV=productionиAPP_DEBUG=false. - Secrets: Используйте переменные окружения для хранения ключей API и паролей БД.
- Permissions: Права на
storageиbootstrap/cacheдолжны быть775, владелецwww-data. - Database: Всегда запускайте миграции с флагом
--force. - Assets: Убедитесь, что
npm run buildвыполнен (в Dockerfile это делается автоматически).
Команды для управления (через Docker/Sail)
Если вы работаете в окружении Sail, используйте:
./vendor/bin/sail artisan config:cache
./vendor/bin/sail artisan migrate --force
Для локальной проверки продакшн-образа:
docker run -p 8080:80 --env-file .env prod-app
Пример Dockerfile (Production)
Ниже приведен пример оптимизированного Dockerfile для этого проекта:
# Stage 1: PHP Dependencies
FROM php:8.5-fpm-alpine AS composer_stage
WORKDIR /var/www/html
RUN apk add --no-cache git unzip libzip-dev libpng-dev libpq-dev
COPY --from=composer:latest /usr/bin/composer /usr/bin/composer
COPY composer.json composer.lock ./
RUN composer install --no-dev --no-scripts --no-autoloader --prefer-dist --ignore-platform-reqs
# Stage 2: Frontend Assets
FROM node:22-alpine AS node_stage
WORKDIR /var/www/html
COPY package.json package-lock.json ./
RUN npm ci
COPY . .
COPY --from=composer_stage /var/www/html/vendor ./vendor
RUN npm run build
# Stage 3: Final Production Image
FROM php:8.5-fpm-alpine
WORKDIR /var/www/html
RUN apk add --no-cache nginx supervisor libzip libpng libpq icu-libs freetype libjpeg-turbo git unzip
# Install PHP extensions
RUN apk add --no-cache --virtual .build-deps $PHPIZE_DEPS libzip-dev libpng-dev postgresql-dev icu-dev zlib-dev freetype-dev libjpeg-turbo-dev \
&& docker-php-ext-configure gd --with-freetype --with-jpeg \
&& docker-php-ext-install bcmath gd intl pdo_pgsql zip pcntl \
&& pecl install redis && docker-php-ext-enable redis \
&& apk del .build-deps
COPY --from=composer:latest /usr/bin/composer /usr/bin/composer
COPY docker/nginx.conf /etc/nginx/http.d/default.conf
COPY docker/supervisord.conf /etc/supervisor/conf.d/supervisord.conf
COPY docker/entrypoint.sh /usr/local/bin/entrypoint
COPY --from=composer_stage /var/www/html/vendor ./vendor
COPY --from=node_stage /var/www/html/public/build ./public/build
COPY . .
RUN composer dump-autoload --optimize --no-dev \
&& chown -R www-data:www-data /var/www/html \
&& chmod -R 775 storage bootstrap/cache
EXPOSE 80
ENTRYPOINT ["entrypoint"]
CMD ["/usr/bin/supervisord", "-c", "/etc/supervisor/conf.d/supervisord.conf"]
Работа с очередями и Horizon
Если проект использует очереди (например, Laravel Horizon), убедитесь, что Supervisord настроен на запуск php artisan horizon или php artisan queue:work.
В текущем проекте за это отвечает docker/supervisord.conf.
04 同仓库更多 Skills
spatie-version-control
Apply Spatie's version control conventions when creating commits, branches, pull requests, or managing Git repositories; use for naming repos, writing commit messages, choosing branch strategies, and merging code.
spatie-security
Apply Spatie's security guidelines when configuring applications, databases, or servers, or when reviewing code for security concerns; use for SSL setup, CSRF protection, password hashing, database permissions, and server hardening.
spatie-laravel-php
Apply Spatie's Laravel and PHP coding standards for any task that creates, edits, reviews, refactors, or formats Laravel/PHP code or Blade templates; use for controllers, Eloquent models, routes, config, validation, migrations, tests, and related files to align with Laravel conventions and PSR-12.
spatie-javascript
Apply Spatie's JavaScript coding standards for any task that creates, edits, reviews, refactors, or formats JavaScript or TypeScript code; use for variable declarations, comparisons, functions, destructuring, and Prettier configuration to align with Spatie's JS conventions.
sluggable-development
Use when making a field on an Eloquent model sluggable, generating the migration for a slug column, switching to self-healing URLs, or resolving a model from its slug in a route. Trigger when the request mentions slugs, permalinks, the spatie/laravel-sluggable package, the HasSlug or HasTranslatableSlug trait, the #[Sluggable] attribute, SlugOptions, findBySlug, self-healing URLs, or stale slug redirects in a Laravel project. Covers choosing between the attribute and the trait, generating unique slugs, configuring separator/length/language/scope/uniqueness, preventing slug overwrites, translatable slugs via spatie/laravel-translatable, route model binding through the slug column, self-healing route keys, customizing the 308 redirect through the SelfHealing facade, and overriding the default actions via config/sluggable.php. Do not use for one-off URL-safe strings, signed URLs, or Laravel's built-in Str::slug helper when the result is not stored on a model.
olakunlevpn-filament-skills
Use when writing, reviewing, or refactoring Filament PHP v5 code -- resources, forms, tables, infolists, actions, widgets, panels, relation managers, multi-tenancy, testing, or plugin development. Always apply these standards to all Filament work.