Laravel 12 Prompts Guide: Prompt Types, Validation, and an Interactive Seeder Generator

Key Takeaways Laravel Promptsは、コマンドラインアプリケーションのための美しく、ユーザーフレンドリーなインターフェイスをゼロ依存性で提供します。 パッケージは、テキスト、パスワード、選択、マルチ選択、確認、検索、および進捗バーを含む複数の入力タイプを提供します。 Laravel 12 は Prompts をネイティブに含み、CLI インタラクションをより直感的で視覚的に魅力的なものにします。 Prompts は、検証、エラー メッセージ、キーボード ナビゲーションを自動的に処理します。 インストールウィザード、構成ツール、およびインタラクティブな手工コマンドの作成に最適です。 インデックス Laravel Promptsについて Laravel Prompts コンポーネント 統計 利用可能なスピードタイプ Database Seeder Generator(データベースセーダー・ジェネレーター) 興味深い事実 ベストプラクティス FAQの 結論 Laravel Promptsについて Laravel Prompts は、コマンドラインアプリケーションに美しく、ユーザーフレンドリーなフォームを追加するように設計された PHP パッケージです。 Laravel 10 に導入され、Laravel 12 に完全に統合され、開発者がインタラクティブな CLI ツールを構築する方法を変革します。 Laravel Promptsの美しさはそのシンプルさにあります。 開発者はもはやコースターポジション、入力検証スタイリング、またはクロスプラットフォーム互換性について心配する必要はありません。 すべてはスムーズにボックスの外で動作し、ターミナルクールと戦うのではなく、ビルド機能に焦点を当てることができます。 Laravel Prompts コンポーネント Laravel Prompts は複数のコアコンポーネントで構成されており、インタラクティブな体験を生成するために一緒に動作します。 パッケージはその基盤として、異なる端末エミュレータ間でプロンプトの視覚的なプレゼンテーションを処理するレンダラーを使用しています。 入力マネージャーはキーボードのイベントを管理し、矢印キーとvimスタイルのナビゲーションの両方をサポートします。 検証システムは、Laravelの既存の検証ルールとシームレスに統合されます. あなたは、Web フォームで使用する同様の検証論理を、あなたの CLI プロンプトに適用することができます. Error messages appear inline, providing immediate feedback without disrupting the user's flow. テキスト入力は単行応答を処理し、選択したドロップダウンは優雅に選択を提示し、進捗バーは長期間の操作中に視覚的なフィードバックを提供します。 統計 パッケージの採用とパフォーマンスメトリクス: Laravel Promptsはリリース以来、1500万回以上ダウンロードされています(ソース: Packagist.org) パッケージはPHP 8.1+をサポートし、Windows、macOS、Linux環境で動作します。 Laravel 12 には、フレームワークに直接統合されたファーストパーティパッケージとして Prompts が含まれています。 公式レポジトリーに2000以上のGitHubスターが存在し、強力なコミュニティの採用を示しています(ソース:GitHub Laravel Prompts) パッケージには実行時間依存性がゼロで、アプリケーションを軽量に保つ パッケージ.org GitHub Laravel Prompts 利用可能なスピードタイプ Laravel Promptsは、それぞれ特定のインタラクションに最適化された8種類のプロンプトタイプを提供しています。 テキスト入力は、場所保持者サポートとリアルタイムの検証で単行テキスト入力に対応します. Use it for names, URLs, or any short string input. Textarea は、複数の行入力機能を提供し、説明やより長いテキストコンテンツに最適です. Users can navigate with arrow keys and submit with Ctrl+D. Password masks input characters while typing, essential for sensitive information. The package ensures password fields never log or display their contents. パスワードマスクは、機密情報を入力する際に重要な文字をマスクします。 Confirm はキーボードのショートカットでyes/no 質問を表示します. Users can press Y/N or use arrow keys to select their choice. Select は、既定のオプションから選択するためのダウンロードメニューを作成します. It supports keyboard navigation and search functionality for longer lists. Multiselect では、スペースバーを使用してリストから複数のアイテムを選択できます. Perfect for feature toggles or category selection. 検索はテキスト入力とダイナミックフィルタリングを組み合わせ、ユーザーを圧倒することなく大きなデータセットから選択するのに最適です。 Progress Bars は、長期にわたるタスクを視覚化し、操作が完了すると自動的に更新します。 Database Seeder Generator(データベースセーダー・ジェネレーター) Laravel Prompts が複雑なデータ生成プロセスをガイドされ、直感的な体験に変えることができる方法を示しています。 このウィザードでは、開発者がどのモデルを種子にするかを選択し、レコード数を構成し、関係を設定し、再利用可能なプレセットとして構成を保存できます。 前提条件 この種子ジェネレーターを実装する前に、あなたが持っていることを確認してください: 必要なすべてのデータベーステーブルを移行 - あなたのモデル(ユーザー、投稿、コメント、カテゴリなど)のための PHP 手工の移行を実行します。 適切な関係を持つモデル作成 - モデルの HasMany、BelongsTo、および BelongsToMany 関係を定義する モデル工場の設定 - 各モデルのための工場を作成する php artisan make:factory ModelNameFactory 定義された充填性属性 - モデルに大量割り当て用の $充填性属性セットがあることを確認します。 データベースの構造、モデル、関係、工場が完了したら、次のコマンドを作成します。 php artisan make:command GenerateSeeder セーダージェネレーター Complete Seeder Generator <?php namespace App\Console\Commands; use Illuminate\Console\Command; use Illuminate\Support\Facades\DB; use Illuminate\Support\Facades\Schema; use Illuminate\Support\Str; use function Laravel\Prompts\multiselect; use function Laravel\Prompts\text; use function Laravel\Prompts\select; use function Laravel\Prompts\confirm; use function Laravel\Prompts\info; use function Laravel\Prompts\warning; use function Laravel\Prompts\error; use function Laravel\Prompts\table; use function Laravel\Prompts\spin; class GenerateSeeder extends Command { protected $signature = 'seed:generate {--preset=}'; protected $description = 'Interactive database seeder generator'; private array $availableModels = [ 'User' => \App\Models\User::class, 'Post' => \App\Models\Post::class, 'Comment' => \App\Models\Comment::class, 'Category' => \App\Models\Category::class, 'Product' => \App\Models\Product::class, 'Order' => \App\Models\Order::class, 'Tag' => \App\Models\Tag::class, ]; private array $config = []; public function handle() { info('🌱 Interactive Database Seeder Generator'); if ($this->option('preset')) { if ($this->loadPreset($this->option('preset'))) { info("✅ Loaded preset: {$this->option('preset')}"); $this->showPresetSummary(); if (confirm('Use this preset configuration?', default: true)) { if ($this->confirmExecution()) { $this->executeSeed(); } return 0; } } } $selectedModels = $this->selectModels(); if (empty($selectedModels)) { warning('No models selected. Exiting.'); return 0; } $this->configureCounts($selectedModels); $this->configureRelationships($selectedModels); $this->configureOptions(); $this->handleExistingData(); $this->showSummary(); if ($this->confirmExecution()) { $this->executeSeed(); $this->offerToSave(); } else { warning('⚠️ Seeding cancelled.'); } return 0; } private function selectModels(): array { $selectedKeys = multiselect( label: 'Which models do you want to seed?', options: $this->availableModels, hint: 'Use space to select, enter to confirm' ); $models = array_map(fn($key) => $this->availableModels[$key], $selectedKeys); return $this->checkDependencies($models); } private function checkDependencies(array $models): array { $dependencies = [ 'Comment' => ['Post'], 'Post' => ['User'], 'Order' => ['User', 'Product'], ]; foreach ($models as $model) { $modelName = class_basename($model); if (isset($dependencies[$modelName])) { foreach ($dependencies[$modelName] as $required) { $requiredClass = $this->availableModels[$required] ?? null; if ($requiredClass && !in_array($requiredClass, $models)) { warning("⚠️ {$modelName} requires {$required}."); if (confirm("Would you like to auto-include {$required}?", default: true)) { $models[] = $requiredClass; info("✅ Added {$required} to seeding list."); } } } } } return array_unique($models); } private function configureCounts(array $models): void { info('📊 Configure Record Counts'); foreach ($models as $model) { $modelName = class_basename($model); $count = text( label: "How many {$modelName} records?", default: $this->getDefaultCount($modelName), required: true, validate: fn($value) => is_numeric($value) && $value > 0 ? null : 'Please enter a valid number greater than 0', hint: $this->getCountHint($modelName) ); $this->config['models'][$modelName] = [ 'class' => $model, 'count' => (int)$count, ]; } } private function configureRelationships(array $models): void { info('🔗 Configure Relationships'); $modelNames = array_map(fn($m) => class_basename($m), $models); if (in_array('Post', $modelNames) && in_array('Category', $modelNames)) { $categoryAssignment = select( label: 'Assign Posts to Categories?', options: [ 'multiple' => 'Yes, assign each post to 1-3 categories (random)', 'single' => 'Yes, assign each post to exactly 1 category', 'none' => 'No, leave categories unassigned' ], default: 'multiple' ); $this->config['relationships']['post_category'] = $categoryAssignment; } if (in_array('Comment', $modelNames) && in_array('User', $modelNames)) { $commentAuthors = select( label: 'Who should author comments?', options: [ 'all' => 'Any user (random)', 'subset' => 'Only 30% of users are active commenters', 'post_author' => 'Include self-comments from post authors' ], default: 'all' ); $this->config['relationships']['comment_user'] = $commentAuthors; } } private function configureOptions(): void { info('⚙️ Additional Options'); $realism = select( label: 'Data realism level', options: [ 'high' => 'High (slower, more realistic data)', 'medium' => 'Medium (balanced)', 'low' => 'Low (fast, simple data)' ], default: 'medium', hint: 'Higher realism uses more varied faker data' ); $this->config['options']['realism'] = $realism; $specialCases = multiselect( label: 'Include special test cases?', options: [ 'admin' => 'Create 1 admin user', 'empty_users' => 'Create 5 users with no posts', 'featured' => 'Create 3 featured posts', 'suspended' => 'Create 2 suspended users', ], hint: 'Optional - adds specific edge cases for testing' ); $this->config['options']['special_cases'] = $specialCases; if (isset($this->config['models']['User'])) { info('👥 User States Distribution'); $activePercent = text( label: 'Percentage of active users', default: '80', validate: fn($v) => is_numeric($v) && $v >= 0 && $v config['options']['user_states'] = [ 'active' => (int)$activePercent, 'inactive' => 100 - (int)$activePercent ]; } } private function handleExistingData(): void { $hasData = false; foreach ($this->config['models'] as $modelName => $data) { $tableName = Str::snake(Str::plural($modelName)); if (Schema::hasTable($tableName)) { if (DB::table($tableName)->count() > 0) { $hasData = true; break; } } } if ($hasData) { warning('⚠️ Database already contains data.'); $action = select( label: 'What should we do?', options: [ 'append' => 'Add new records (append)', 'truncate' => 'Truncate tables first (clean start)', 'skip' => 'Cancel seeding' ], default: 'append' ); $this->config['options']['existing_data'] = $action; if ($action === 'skip') { warning('Seeding cancelled.'); exit(0); } } } private function showSummary(): void { info(''); info('═══════════════════════════════════════════════════'); info(' 📊 Seeding Summary'); info('═══════════════════════════════════════════════════'); $tableData = []; $totalRecords = 0; foreach ($this->config['models'] as $modelName => $data) { $count = $data['count']; $totalRecords += $count; $tableData[] = [ 'Model' => $modelName, 'Records' => number_format($count), 'Table' => Str::snake(Str::plural($modelName)) ]; } table(headers: ['Model', 'Records', 'Table'], rows: $tableData); info(''); info("Total Records: " . number_format($totalRecords)); info("Realism Level: " . ucfirst($this->config['options']['realism'] ?? 'medium')); if (!empty($this->config['options']['special_cases'])) { info("Special Cases: " . count($this->config['options']['special_cases']) . " enabled"); } $estimatedTime = max(1, (int)ceil($totalRecords / 100)); info("Estimated Time: ~{$estimatedTime} seconds"); info('═══════════════════════════════════════════════════'); info(''); } private function showPresetSummary(): void { info(''); info('📋 Preset Configuration:'); if (isset($this->config['models'])) { $tableData = []; foreach ($this->config['models'] as $modelName => $data) { $tableData[] = [ 'Model' => $modelName, 'Records' => number_format($data['count']) ]; } table(headers: ['Model', 'Records'], rows: $tableData); } info(''); } private function confirmExecution(): bool { return confirm( label: 'Proceed with seeding?', default: true, yes: 'Yes, start seeding', no: 'Cancel' ); } private function executeSeed(): void { info('🚀 Starting database seeding...'); info(''); if (($this->config['options']['existing_data'] ?? '') === 'truncate') { spin( callback: function () { foreach ($this->config['models'] as $modelName => $data) { $tableName = Str::snake(Str::plural($modelName)); if (Schema::hasTable($tableName)) { DB::table($tableName)->truncate(); } } }, message: 'Truncating tables...' ); info('✅ Tables truncated'); } foreach ($this->config['models'] as $modelName => $data) { $count = $data['count']; $class = $data['class']; if (!class_exists($class)) { warning("⚠️ Model {$class} not found. Skipping."); continue; } $this->seedModel($modelName, $class, $count); } info(''); info('✅ Database seeded successfully!'); info(''); } private function seedModel(string $modelName, string $class, int $count): void { $startTime = microtime(true); try { spin( callback: fn() => $class::factory($count)->create(), message: "Seeding {$modelName}..." ); $duration = round(microtime(true) - $startTime, 2); info("✅ Created {$count} {$modelName} records ({$duration}s)"); } catch (\Exception $e) { error("Failed to seed {$modelName}: {$e->getMessage()}"); if (!confirm("Continue seeding other models?", default: true)) { throw $e; } } } private function offerToSave(): void { info(''); if (confirm('Save this configuration as a preset?', default: false)) { $presetName = text( label: 'Preset name', placeholder: 'e.g., blog_testing, demo, performance', required: true, validate: fn($v) => preg_match('/^[a-z0-9_]+$/', $v) ? null : 'Use lowercase letters, numbers, and underscores only' ); $this->savePreset($presetName); info("✅ Configuration saved as preset: {$presetName}"); info("💡 Run again with: php artisan seed:generate --preset={$presetName}"); } } private function savePreset(string $name): void { $presetsPath = storage_path('app/seeder-presets'); if (!is_dir($presetsPath)) { mkdir($presetsPath, 0755, true); } file_put_contents( "{$presetsPath}/{$name}.json", json_encode($this->config, JSON_PRETTY_PRINT) ); } private function loadPreset(string $name): bool { $filePath = storage_path("app/seeder-presets/{$name}.json"); if (!file_exists($filePath)) { return false; } $this->config = json_decode(file_get_contents($filePath), true); return true; } private function getDefaultCount(string $modelName): string { return match($modelName) { 'User' => '50', 'Post' => '200', 'Comment' => '500', 'Category' => '10', 'Product' => '100', 'Order' => '300', 'Tag' => '20', default => '50' }; } private function getCountHint(string $modelName): string { return match($modelName) { 'User' => 'Recommended: 10-100 for testing', 'Post' => 'Recommended: 50-500 depending on use case', 'Comment' => 'Typically 2-5x the number of posts', 'Category' => 'Usually 5-20 categories', default => 'Enter desired count' }; } } // Load preset if specified // Step 1: Model Selection // Step 2: Configure Counts // Step 3: Configure Relationships // Step 4: Data Quality & Special Options // Step 5: Handle Existing Data // Step 6: Show Summary // Step 7: Confirm and Execute // Convert keys to actual class paths // Check for relationship dependencies このマジックは、いくつかの強力な機能を示しています: 依存性チェックによるモデル選択 - 必要なモデルを自動的に含む(例えば、コメントは投稿を必要とする) インラインエラーメッセージによるスマート認証 - 正しい数値入力と適切な範囲を確保する Conditional prompts for relationships - Only asks relevant questions based on selected models. 選択されたモデルに基づいてのみ関連の質問をします。 Configuration preview with tables - 実行前にクリーンな概要を表示する Preset system - Save configurations for reuse across different environments. さまざまな環境で再利用するための設定を保存する Progress feedback with spinners - Visual indication during long-running seed operations (スピンナーによる進捗反応) エラー回復 - 失敗を優しく処理し、他のモデルと継続することができます。 使用例: php artisan seed:generate php artisan seed:generate --preset=blog_testing # Interactive mode - walks through all options # Quick start with preset # Common presets to create: # - blog_testing: 50 users, 200 posts, 400 comments # - demo: Beautiful data for client presentations # - performance: 10,000+ records for load testing # - minimal: Just enough data to start development このアプローチは、手動でエラーに敏感なプロセスから、時間を節約し、エラーを減らすガイドされた体験にデータベースの種を変換します。 ターミナル画像参照: ♪ ♪ ♪ ♪ ♪ ♪ ♪ ♪ 興味深い事実 Cross-Platform Compatibility Magic: Laravel Prompts は、端末環境を自動的に検出し、そのレンダリング戦略を調整します。 Zero Dependencies Philosophy: 外部ライブラリに依存するほとんどの CLI パッケージとは異なり、Laravel Prompts は完全に自立しています。 アクセシビリティ機能:このパッケージにはスクリーンリーダーのサポートが含まれており、さまざまな端末アクセシビリティツールと共に動作します。 Vim Keybinding Support: Power users can navigate prompts using h, j, k, l keys in addition to arrow keys. This thoughtful addition shows Laravel's attention to developer experience. Vim Keybinding Support: Power users can navigate prompts using h, j, k, l keys in addition to arrow keys. この慎重な追加は、Laravelの開発者体験への注意を示しています。 Fallback モード: TTY サポートのない環境(CI/CD パイプラインなど)で実行する場合、Prompts は自動的に単純な入力/出力に戻り、コマンドがどこでも動作することを保証します。 ベストプラクティス あなたが要求している情報を説明する明確で簡潔なラベルを常に提供してください. Technical jargon avoid unless your audience expects it. Good labels reduce confusion and speed up the interaction process. 「不正入力」の代わりに、ユーザーに何が間違っているかを正確に伝える: 「ポートは1から65535.」 このガイドラインは、不満を防ぎ、サポート要請を減らします。 可能な限り、あらゆるプロンプトに合理的なデフォルトを実装してください. ほとんどのユーザーは標準設定を望んでおり、デフォルトを受け入れるためにEnterを押してください. This respects their time while still allowing customization. Group related prompts together and use info/warning messages to provide context. Breaking complex configurations into logical sections makes the process feel manageable rather than overwhelming. 複雑な構成を論理的なセクションに分割すると、プロセスは圧倒的なのではなく、管理可能なものになります。 Laravel Prompts はほとんどの互換性の問題に対処しますが、Windows コマンド プロンプト、PowerShell、およびさまざまな Unix シェルで体験を確認すると品質が確保されます。 テイラー・オトウェル(Taylor Otwell) Laravelの創造者 「Laravel Promptsは、CLIアプリケーションを脅迫的なブラックボックスからガイドされた、ユーザーフレンドリーな体験に変換します。 FAQの Q: Laravel Prompts は Laravel アプリケーションの外で使用できますか? A: はい! Laravel Prompts はフレームワークアグノクティックで、PHP プロジェクトで動作します。 Q:自動化テストでプロンプトをどのように処理しますか? A: Laravel Prompts にはテストアシスタントが含まれています。 テストで Prompt::fake() メソッドを使用して、実際の端末相互作用を必要とせずにユーザーの入力をシミュレートします。 Q: Do prompts work in Docker containers? A: Yes, but make sure your container has TTY enabled. Use docker run -it or set tty: true in docker-compose.yml for interactive prompts to work properly. コンテナのコンテナにTTYが有効であることを確認します。 Q: インタビューの外観をカスタマイズできますか? A: デフォルトのスタイリングは一貫してプロフェッショナルですが、特定のビジュアル変更が必要な場合は、ベースコンポーネントを拡張するカスタマイズされたインタビュークラスを作成できます。 Q: ユーザーが CTRL+C でプロンプトをキャンセルするとどうなりますか? A: Laravel Prompts はキャンセルを尊重し、UserCancelledException を投げます。 Q: プロンプトは Windows コマンド プロンプトと互換性がありますか? A: Absolutely. Laravel Prompts には、Windows 環境用の特定のレンダリング ロジックが含まれており、コマンド プロンプト、PowerShell、および Windows ターミナルでプロンプトが素晴らしいように見えます。 Q: プロンプトを使用してファイルを選択できますか? A: 内蔵のファイルブラウザプロンプトはありませんが、検索プロンプトとファイルシステムスキャンを組み合わせて、効果的なファイルを選択インターフェイスを作成できます。 Q: ポンプにヘルプテキストまたはヒントを追加する方法は? A: ほとんどのポンプ関数は、追加の文脈を提供できるヒントパラメータを承認します。 フリーク・ヴァン・ダー・ヘルテン、Laravel開発者 「Laravel Promptsの本当のパワーは、ウェブフォームを置き換えることではなく、以前、端末アプリケーションを怖がらせた開発者にCLIツールをアクセスできるようにすることだ」 結論 Laravel Promptsは、コマンドラインインターフェイスデザインにおける重要な飛躍を表しています。ゼロ構成で美しく直感的な相互作用を提供することで、かつてCLI開発を挑戦させた技術的な障壁を取り除きます。 私たちが作成したSMTP設定ウィザードは、複雑なセットアッププロセスがどのようにガイドされた体験になるかを示しています。ユーザーが設定ファイルを手動で編集するか、不明確な設定を記憶することを要求するのではなく、検証と有用なヒントで各ステップを歩くことができます。このアプローチはエラーを減らし、ユーザー満足度を向上させ、アプリケーションをよりプロフェッショナルにします。 Laravel 12 が進化し続けるにつれて、Prompts は生態系内の CLI 開発の基盤となり、インストール ウィザード、デプロイツール、またはインタラクティブ メンテナンス コマンドを構築しているかどうかにかかわらず、Laravel Prompts はユーザーが実際に楽しむ端末アプリケーションを作成するための基盤を提供します。