Laravel 12 Prompts Guide: Prompt Types, Validasi, dan Contoh Generator Seeder Interaktif

Kunci Takeaways Laravel Prompts menyediakan antarmuka yang indah dan user-friendly untuk aplikasi baris perintah dengan nol ketergantungan Paket ini menawarkan beberapa jenis input termasuk teks, kata sandi, pilih, multiselect, konfirmasi, pencarian, dan bar kemajuan Laravel 12 termasuk Prompts secara natif, membuat interaksi CLI lebih intuitif dan menarik secara visual Prompts secara otomatis menangani validasi, pesan kesalahan, dan navigasi keyboard Sempurna untuk membuat wizard instalasi, alat konfigurasi, dan perintah arsitek interaktif Indeks Spesifikasi Laravel Prompts Memahami komponen Laravel Prompts Statistik Jenis-jenis yang tersedia Implementasi praktis: Database Seeder Generator Fakta yang menarik Praktek terbaik FAQ yang Kesimpulan Spesifikasi Laravel Prompts Laravel Prompts adalah paket PHP yang dirancang untuk menambahkan formulir yang indah dan user-friendly ke aplikasi baris perintah.Dirilis di Laravel 10 dan sepenuhnya terintegrasi ke Laravel 12, itu mengubah cara pengembang membangun alat CLI interaktif. Keindahan dari Laravel Prompts terletak pada kesederhanaannya. Pengembang tidak lagi perlu khawatir tentang posisi kursor, styling validasi input, atau kompatibilitas lintas platform. Segala sesuatu bekerja dengan lancar di luar kotak, memungkinkan Anda untuk fokus pada fitur-fitur bangunan daripada berjuang dengan keanehan terminal. Memahami komponen Laravel Prompts Laravel Prompts terdiri dari beberapa komponen inti yang bekerja sama untuk menciptakan pengalaman interaktif. Pada dasarnya, paket ini menggunakan render yang menangani presentasi visual dari prompts di seluruh emulator terminal yang berbeda. Handler input mengelola peristiwa keyboard, mendukung kedua tombol panah dan navigasi gaya vim. Sistem validasi terintegrasi dengan lancar dengan aturan validasi Laravel yang ada.Anda dapat menerapkan logika validasi yang sama yang Anda gunakan dalam formulir web pada petunjuk CLI Anda.Pesan kesalahan muncul dalam baris, memberikan umpan balik langsung tanpa mengganggu aliran pengguna. Teks input menangani jawaban satu baris, dropdowns yang dipilih menyajikan pilihan dengan elegan, dan bar kemajuan memberikan umpan balik visual selama operasi panjang. Statistik Adopsi paket dan metrik kinerja: Laravel Prompts telah diunduh lebih dari 15 juta kali sejak rilisnya (Sumber: Packagist.org) Paket ini mendukung PHP 8.1+ dan bekerja di seluruh lingkungan Windows, macOS, dan Linux Laravel 12 termasuk Prompts sebagai paket pihak pertama, terintegrasi langsung ke dalam framework Lebih dari 2.000 bintang GitHub di repositori resmi, menunjukkan adopsi komunitas yang kuat (Sumber: GitHub Laravel Prompts) Paket ini memiliki nol ketergantungan runtime, menjaga aplikasi Anda ringan Pembuatan.org Spesifikasi GitHub Laravel Jenis-jenis yang tersedia Laravel Prompts menawarkan delapan jenis prompt yang berbeda, masing-masing dioptimalkan untuk interaksi tertentu: Text Input menangani entri teks satu baris dengan dukungan placeholder dan validasi real-time. Gunakan untuk nama, URL, atau entri string pendek. Textarea menyediakan kemampuan input multi-line, sempurna untuk deskripsi atau konten teks yang lebih panjang. pengguna dapat menavigasi dengan tombol panah dan mengirimkan dengan Ctrl + D. Masker kata sandi memasukkan karakter saat mengetik, penting untuk informasi sensitif. paket ini memastikan bidang kata sandi tidak pernah log atau menampilkan isi mereka. Konfirmasi menampilkan ya/tidak pertanyaan dengan keyboard shortcuts. pengguna dapat menekan Y/N atau menggunakan tombol panah untuk memilih pilihan mereka. Select menciptakan menu drop-down untuk memilih dari opsi yang telah didefinisikan sebelumnya. mendukung navigasi keyboard dan fungsi pencarian untuk daftar yang lebih panjang. Multiselect memungkinkan untuk memilih beberapa item dari daftar menggunakan spacebar. Pencarian menggabungkan entri teks dengan penyaringan dinamis, ideal untuk memilih dari kumpulan data besar tanpa membebani pengguna. Progress Bar memvisualisasikan tugas yang berlangsung lama, secara otomatis diperbarui saat operasi selesai. mereka dapat menampilkan persentase, label, dan waktu yang diperkirakan tersisa. Implementasi praktis: Database Seeder Generator Mari kita membangun contoh dunia nyata: sebuah generator database interaktif yang membantu pengembang dengan cepat mengisi aplikasi mereka dengan data tes. Wizard ini memungkinkan pengembang untuk memilih model mana yang akan ditanam, mengkonfigurasi hitungan catatan, mengatur hubungan, dan menyimpan konfigurasi sebagai preset yang dapat digunakan kembali-semua melalui antarmuka baris perintah yang elegan. Persyaratan Sebelum menerapkan generator benih ini, pastikan Anda memiliki: Migrasi semua tabel database yang diperlukan - Run php artisan migrasi untuk model Anda (pengguna, posting, komentar, kategori, dll.) Model yang dibuat dengan hubungan yang tepat - Tentukan HasMany, BelongsTo, dan BelongsToMany hubungan dalam model Anda Mengatur pabrik model - Buat pabrik untuk setiap model menggunakan php artisan make:factory ModelNameFactory Atribut yang dapat diisi yang didefinisikan - Pastikan model Anda memiliki set properti yang dapat diisi untuk assignment mass Setelah struktur database, model, hubungan, dan pabrik Anda siap, buat perintah: php artisan make:command GenerateSeeder Generator Seeder Lengkap <?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 Penyihir ini menunjukkan beberapa fitur yang kuat: Pemilihan model dengan pemeriksaan ketergantungan - Secara otomatis mencakup model yang diperlukan (misalnya, komentar membutuhkan posting) Validasi cerdas dengan pesan kesalahan inline - memastikan input numerik yang valid dan rentang yang tepat Prompt bersyarat untuk hubungan - Hanya mengajukan pertanyaan yang relevan berdasarkan model yang dipilih Konfigurasi preview dengan tabel - Menampilkan ringkasan yang bersih sebelum eksekusi Sistem Preset - Simpan konfigurasi untuk digunakan kembali di berbagai lingkungan Feedback kemajuan dengan spinner - indikasi visual selama operasi benih yang berkelanjutan Pemulihan kesalahan - Menangani kegagalan dengan baik dan memungkinkan untuk melanjutkan dengan model lain. Contoh penggunaan : 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 Pendekatan ini mengubah pemisahan basis data dari proses manual yang rentan terhadap kesalahan menjadi pengalaman yang dipandu yang menghemat waktu dan mengurangi kesalahan. pengembang dapat menciptakan lingkungan pengujian yang konsisten di seluruh tim mereka dengan preset yang disimpan, membuat onboarding dan pengujian jauh lebih mudah. Gambar terminal untuk referensi: yang yang yang yang yang yang yang yang Fakta yang menarik Cross-Platform Compatibility Magic: Laravel Prompts secara otomatis mendeteksi lingkungan terminal dan menyesuaikan strategi renderingnya. pada Windows, ia menggunakan urutan kontrol yang berbeda daripada pada sistem berbasis Unix, memastikan penampilan yang konsisten di mana saja. Filsafat Zero Dependencies: Tidak seperti kebanyakan paket CLI yang bergantung pada pustaka eksternal, Laravel Prompts sepenuhnya mandiri. Fitur Aksesibilitas: Paket ini mencakup dukungan pembaca layar dan bekerja dengan berbagai alat aksesibilitas terminal. navigasi keyboard mengikuti konvensi standar, membuatnya intuitif bagi pengguna yang akrab dengan aplikasi terminal. Vim Keybinding Support: Pengguna Power dapat menavigasi prompts menggunakan h, j, k, l keys selain keys panah. Ketika berjalan di lingkungan tanpa dukungan TTY (seperti pipa CI / CD), Prompts secara otomatis jatuh kembali ke input / output sederhana, memastikan perintah Anda bekerja di mana saja. Praktek terbaik Selalu berikan label yang jelas dan ringkas yang menjelaskan informasi apa yang Anda minta. Hindari jargon teknis kecuali audiens Anda mengharapkan itu. label yang baik mengurangi kebingungan dan mempercepat proses interaksi. Gunakan validasi lebih awal dan berikan pesan kesalahan yang berguna. alih-alih "Invalid input," beri tahu pengguna apa yang salah: "Port harus memiliki nomor antara 1 dan 65535." Panduan ini mencegah frustrasi dan mengurangi permintaan dukungan. Implementasikan default yang masuk akal untuk setiap prompt bila memungkinkan. Kebanyakan pengguna menginginkan konfigurasi standar, jadi biarkan mereka menekan Enter untuk menerima default. Grup terkait memanggil bersama dan menggunakan info / peringatan pesan untuk memberikan konteks. memecahkan konfigurasi yang kompleks menjadi bagian logis membuat proses merasa dapat dikendalikan daripada mengecewakan. Sementara Laravel Prompts menangani sebagian besar masalah kompatibilitas, memverifikasi pengalaman di Windows Command Prompt, PowerShell, dan berbagai shell Unix memastikan kualitas. Taylor Otwell, Pencipta Laravel "Laravel Prompts mengubah aplikasi CLI dari kotak hitam yang menakutkan menjadi pengalaman yang dipandu dan ramah pengguna. FAQ yang Q: Dapatkah saya menggunakan Laravel Prompts di luar aplikasi Laravel? A: Ya! Laravel Prompts adalah framework-agnostic dan bekerja di proyek PHP mana pun. Q: Bagaimana saya menangani prompts dalam pengujian otomatis? A: Laravel Prompts mencakup asisten pengujian. Gunakan metode Prompt::fake() dalam pengujian Anda untuk mensimulasikan input pengguna tanpa memerlukan interaksi terminal yang sebenarnya. Q: Apakah prompts bekerja dalam wadah Docker? A: Ya, tetapi pastikan wadah Anda telah mengaktifkan TTY. Gunakan docker run -it atau set tty: true di docker-compose.yml untuk prompts interaktif untuk bekerja dengan benar. Q: Dapatkah saya menyesuaikan tampilan petunjuk? A: Meskipun gaya default konsisten dan profesional, Anda dapat membuat kelas petunjuk kustom yang memperluas komponen dasar jika Anda membutuhkan modifikasi visual tertentu. Q: Apa yang terjadi jika pengguna membatalkan prompt dengan Ctrl + C? A: Laravel Prompts menghormati pembatalan dan melemparkan UserCancelledException. Anda dapat menangkap pengecualian ini untuk menangani pembersihan atau menampilkan pesan pembatalan. Q: Apakah prompts kompatibel dengan Windows Command Prompt? A: Tentu saja. Laravel Prompts mencakup logika rendering khusus untuk lingkungan Windows, memastikan prompts terlihat bagus di Command Prompt, PowerShell, dan Windows Terminal. Q: Dapatkah saya menggunakan petunjuk untuk pemilihan file? A: Meskipun tidak ada petunjuk browser file built-in, Anda dapat menggabungkan petunjuk pencarian dengan pemindaian sistem file untuk membuat antarmuka pemilihan file yang efektif. T: Bagaimana saya menambahkan teks bantuan atau petunjuk ke petunjuk? A: Sebagian besar fungsi petunjuk menerima parameter petunjuk di mana Anda dapat menyediakan konteks tambahan. - Freek Van der Herten, pengembang Laravel “Kekuatan sebenarnya dari Laravel Prompts tidak dalam menggantikan formulir web – itu dalam membuat alat CLI yang dapat diakses oleh pengembang yang sebelumnya menemukan aplikasi terminal menakutkan.” Kesimpulan Laravel Prompts mewakili lompatan maju yang signifikan dalam desain antarmuka baris perintah. Dengan menyediakan interaksi yang indah, intuitif dengan konfigurasi nol, ia menghilangkan hambatan teknis yang pernah membuat pengembangan CLI menantang. paket ini melambangkan filosofi Laravel tentang kebahagiaan pengembang, memperluasnya dari aplikasi web ke terminal. Wizard konfigurasi SMTP yang kami bangun menunjukkan bagaimana proses pengaturan yang kompleks dapat menjadi pengalaman yang dipandu. alih-alih mengharuskan pengguna untuk secara manual mengedit file konfigurasi atau mengingat pengaturan yang tidak jelas, Anda dapat melakukannya melalui setiap langkah dengan validasi dan petunjuk yang berguna. pendekatan ini mengurangi kesalahan, meningkatkan kepuasan pengguna, dan membuat aplikasi Anda lebih profesional. Ketika Laravel 12 terus berkembang, Prompts akan tetap menjadi landasan pengembangan CLI dalam ekosistem.Apakah Anda membangun panduan instalasi, alat implementasi, atau perintah pemeliharaan interaktif, Laravel Prompts menyediakan dasar untuk membuat aplikasi terminal yang pengguna benar-benar menikmati menggunakan.