界面已本地化;技能介绍与说明文档按所选语言由 AI 自动翻译,代码、命令、路径和专业术语保留原文,以原作者文档为准。
探索技能
开发与工程 · SKILL.md

laravel-tooling

laravel-tooling

【开发与工程】Configure Laravel ecosystem with custom Artisan commands, Vite asset bundling, Pint code styling, and Horizon queue monitoring. Use when creating Artisan commands, migrating from Mix to Vite, or configuring Pint code standards.

独立 GitHub 快照 · 自动分类 · 以原作者文档为准

技能说明

GitHub

name: laravel-tooling description: Configure Laravel ecosystem with custom Artisan commands, Vite asset bundling, Pint code styling, and Horizon queue monitoring. Use when creating Artisan commands, migrating from Mix to Vite, or configuring Pint code standards. metadata: triggers: files: - 'package.json' - 'composer.json' - 'vite.config.js' keywords: - artisan - vite - horizon - pint - blade

Laravel Tooling

Priority: P2 (MEDIUM)

Workflow: Set Up Development Tooling

  1. Install Pint — composer require laravel/pint --dev; run ./vendor/bin/pint.
  2. Configure Vite — Set up vite.config.js with Laravel plugin; add @vite() in Blade layout.
  3. Create custom command — php artisan make:command SendNewsletters.
  4. Add Horizon — composer require laravel/horizon; configure supervisors.

Custom Artisan Command Example

See implementation examples for Artisan command pattern and project structure.

Implementation Guidelines

Artisan Commands

  • Customization: Use php artisan make:command SendNewsletters.
  • Definitions: Define protected $signature = 'newsletters:send {--queue}'.
  • Execution: Implement handle(): int. Commands auto-discovered in app/Console/Commands/.
  • Scheduling: Schedule in bootstrap/app.php (formerly Kernel).

Asset Management (Vite)

  • Scaffolding: Run npm install and configure vite.config.js with Laravel plugin.
  • Blade Integration: Add @vite directive (@vite(['resources/css/app.css', 'resources/js/app.js'])) to your layout.
  • Migration: Use Vite (not Mix) — replace mix() with vite() in Blade templates and remove laravel-mix.
  • Workflow: Run npm run dev for local HMR and npm run build for production. No manual versioning needed.

Code Quality & Monitoring

  • Pint Styling: Enforce standards with composer require laravel/pint --dev.
  • Usage: Run ./vendor/bin/pint to apply preset: 'laravel' configuration from pint.json.
  • Queue Observability: Use composer require laravel/horizon. Run php artisan horizon:install and configure supervisors in config/horizon.php.
  • Horizon Security: Set authentication gates in HorizonServiceProvider. Access via /horizon in browser.

Anti-Patterns

  • No Laravel Mix: Migrate to Vite for faster HMR.
  • No JS in Blade templates: Move scripts to resources/js.
  • No manual DB edits: Use Artisan commands or migrations.
  • No unstyled commits: Run ./vendor/bin/pint before merging.

References

Canonical response anchors

When this skill applies, preserve the following domain terminology or equivalent concrete examples in the answer when relevant:

  • @vite directive
  • Vite (not Mix)
  • npm run build for production
  • preset: 'laravel'
  • replace mix() with vite()
我的收藏