Laravel 12 Prompts útmutató: Prompt típusok, érvényesítés és interaktív vetőmag generátor példa

Kulcsszavak A Laravel Prompts gyönyörű, felhasználóbarát felületet biztosít a parancssori alkalmazásokhoz nulla függőséggel A csomag többféle bemeneti típusot kínál, beleértve a szöveget, a jelszót, a kiválasztást, a többválasztást, a megerősítést, a keresést és a haladási sávokat. A Laravel 12 tartalmazza a Prompts-t natív módon, így a CLI interakciók intuitívabbak és vizuálisan vonzóbbak A Prompts automatikusan kezeli az érvényesítést, a hibaüzeneteket és a billentyűzet navigációt Tökéletes a telepítési varázslók, konfigurációs eszközök és interaktív kézműves parancsok létrehozásához Indexek Bemutatkozik a Laravel Prompts A Laravel Prompts összetevői Statisztika Elérhető gyors típusok Gyakorlati megvalósítás: Database Seeder Generator Érdekes tények Legjobb gyakorlatok A FAQ következtetés Bemutatkozik a Laravel Prompts A Laravel Prompts egy PHP-csomag, amelynek célja, hogy gyönyörű és felhasználóbarát űrlapokat adjon a parancssori alkalmazásokhoz. A Laravel 10-ben bevezetett és teljesen a Laravel 12-be integrált, átalakítja a fejlesztők interaktív CLI-eszközöket építő módját. A csomag kiküszöböli a terminál interakciók összetettségét, miközben a különböző operációs rendszerek közötti egységes, professzionális megjelenést tart fenn. A Laravel Prompts szépsége az egyszerűségében rejlik. A fejlesztőknek már nem kell aggódniuk a kurzor pozícionálása, a bemeneti érvényesítés stílusa vagy a platformok közötti kompatibilitás miatt. Minden zökkenőmentesen működik a dobozon kívül, lehetővé téve, hogy az építési funkciókra összpontosítson, ahelyett, hogy harcolna a terminál furcsaságokkal. A Laravel Prompts összetevői A Laravel Prompts több alapkomponensből áll, amelyek együttműködnek az interaktív élmények létrehozásához. Alapjául a csomag olyan renderelőt használ, amely a különböző terminálemulátorokon keresztül kezeli a meghívók vizuális bemutatását. A bemeneti kezelő a billentyűzetes eseményeket kezeli, mind a nyilakkal, mind a vim stílusú navigációval. A validálási rendszer zökkenőmentesen integrálódik a Laravel meglévő validálási szabályaival. A webes űrlapokban használt azonos validálási logikát alkalmazhatja a CLI-meghívókra. A szöveges bemenetek egyetlen soros válaszokat kezelnek, a kiválasztott csepegtetők elegánsan jelenítik meg a választ, és a haladási sávok vizuális visszajelzést nyújtanak a hosszú futási műveletek során. Statisztika A csomag elfogadása és a teljesítménymetrikák: Laravel Prompts már letöltött több mint 15 millió alkalommal a megjelenése óta (forrás: Packagist.org) A csomag támogatja a PHP 8.1+ és működik a Windows, macOS és Linux környezetben A Laravel 12 elsődleges csomagként tartalmazza a Prompts-t, amely közvetlenül a keretbe integrálódik. Több mint 2000+ GitHub csillag a hivatalos raktárban, ami erős közösségi elfogadást mutat (forrás: GitHub Laravel Prompts) A csomag nulla futtatási függőséggel rendelkezik, így az alkalmazás könnyű Gyártó.org GitHub Laravel Prompts letöltés Elérhető gyors típusok A Laravel Prompts nyolc különböző prompt típust kínál, amelyek mindegyike specifikus interakciókhoz optimalizált: A Text Input egy soros szöveges bejegyzést kezel helytartó támogatással és valós idejű érvényesítéssel. Használja a nevekhez, URL-ekhez vagy bármely rövid soros bejegyzéshez. A Textarea több soros beviteli képességeket biztosít, tökéletes leírásokhoz vagy hosszabb szöveges tartalmakhoz.A felhasználók a nyilakkal navigálhatnak, és Ctrl+D billentyűvel küldhetnek be. Jelszó maszkok a karakterek beírása közben, elengedhetetlen az érzékeny információkhoz.A csomag biztosítja, hogy a jelszó mezők soha ne naplózzanak vagy ne jelenítsék meg tartalmukat. A megerősítés igen/nem kérdéseket jelenít meg billentyűparancsokkal.A felhasználók Y/N billentyűkombinációval vagy nyílbillentyűvel választhatják ki a választásukat. A Select letöltési menüt hoz létre az előre meghatározott beállítások közül történő kiválasztáshoz. Támogatja a billentyűzet navigációját és a hosszabb listák keresési funkcióit. A Multiselect lehetővé teszi több elem kiválasztását egy listából a térsáv használatával. Tökéletes funkciók vagy kategóriák kiválasztásához. A keresés kombinálja a szövegbevitelt a dinamikus szűréssel, ideális a nagy adatkészletek közül történő kiválasztáshoz anélkül, hogy a felhasználót elnyomná. Az előrehaladási sávok hosszú távú feladatokat vizualizálnak, és automatikusan frissülnek, amikor a műveletek befejeződnek. megtekinthetik a százalékokat, címkéket és a fennmaradó becsült időt. Gyakorlati megvalósítás: Database Seeder Generator Építsünk egy valós példát: egy interaktív adatbázis-gyártó generátort, amely segít a fejlesztőknek, hogy alkalmazásaikat tesztadatokkal gyorsan betöltsék. Ez a varázsló lehetővé teszi a fejlesztők számára, hogy kiválasszák, mely modelleket vetik be, konfigurálják a rekordszámokat, létrehozzák a kapcsolatokat, és mentse a konfigurációkat újrafelhasználható előzetes beállításokként - mindezt egy elegáns parancssori felület segítségével. Előfeltételek Mielőtt telepítené ezt a vetőmag generátort, győződjön meg róla, hogy: Migráció az összes szükséges adatbázis-táblák - fut php kézműves migráció a modellek (felhasználók, hozzászólások, megjegyzések, kategóriák, stb.) Megfelelő kapcsolatokkal létrehozott modellek - Határozza meg a HasMany, BelongsTo és BelongsToMany kapcsolatokat a modellekben Modellgyárak létrehozása - Gyárak létrehozása minden modellhez a php artisan make:factory ModelNameFactory segítségével Meghatározott tölthető tulajdonságok - Győződjön meg róla, hogy a modellek rendelkeznek a $tölthető tulajdonságokkal a tömeges hozzárendeléshez Ha az adatbázis szerkezete, a modellek, a kapcsolatok és a gyárak készen állnak, hozza létre a parancsot: php artisan make:command GenerateSeeder A teljes Seeder generátor <?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 Ez a varázsló számos erős funkciót mutat: Modellek kiválasztása függőségellenőrzéssel - automatikusan tartalmazza a szükséges modelleket (például a hozzászólások megjegyzéseket igényelnek) Intelligens érvényesítés inline hibaüzenetekkel - Biztosítja az érvényes numerikus bemeneteket és a megfelelő tartományokat Feltételes kapcsolatfelhívások - csak a kiválasztott modellek alapján releváns kérdéseket tesz fel Konfigurációs előnézet táblázatokkal - Tiszta összefoglalót jelenít meg a végrehajtás előtt Előre beállított rendszer - Konfigurációk mentése a különböző környezetekben történő újrafelhasználáshoz Folytatási visszajelzés csavarokkal - Vizuális jelzés hosszú távú vetési műveletek során Hiba helyreállítása - Kegyesen kezeli a hibákat, és lehetővé teszi, hogy folytassa más modellekkel. Használati példák : 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 Ez a megközelítés átalakítja az adatbázis vetését egy kézi, hibás folyamatból egy időt takarító és hibákat csökkentő vezetett tapasztalatra.A fejlesztők egységes tesztkörnyezeteket hozhatnak létre csapatukban mentett előzetes beállításokkal, ami jelentősen megkönnyíti a bejelentkezést és a tesztelést. Terminál képek referenciaként: Az Az Az Az Az Az Az Az Érdekes tények Cross-Platform Compatibility Magic: A Laravel Prompts automatikusan észleli a terminál környezetet, és beállítja a renderelési stratégiát. Zéró függőségek filozófiája: A legtöbb külső könyvtárra támaszkodó CLI-csomaggal ellentétben a Laravel Prompts teljesen önállóan működik. Hozzáférhetőségi funkciók: A csomag tartalmazza a képernyőolvasó támogatását, és különböző terminál-hozzáférhetőségi eszközökkel működik. Vim Keybinding támogatás: Az erőforrás-felhasználók a nyílbillentyűk mellett a h, j, k, l billentyűket is használva navigálhatják a prompteket. Fallback mód: Amikor TTY-támogatás nélküli környezetben fut (például CI/CD csővezetékek), a Prompts automatikusan visszaesik az egyszerű bemeneti/kimeneti módba, biztosítva, hogy a parancsok bárhol működjenek. Legjobb gyakorlatok Mindig adjon világos, tömör címkéket, amelyek elmagyarázzák, hogy milyen információt kér. Kerülje a technikai jargont, kivéve, ha a közönség elvárja. Használja korán a hitelesítést, és küldjön hasznos hibaüzeneteket. „Hatálytalan input” helyett mondja el a felhasználóknak, hogy pontosan mi ment rosszul: „A portnak 1 és 65535 között kell lennie.” A legtöbb felhasználó a szabványos konfigurációt akarja, ezért nyomja meg az Enter billentyűt az alapértelmezés elfogadásához. Ez tiszteletben tartja az idejét, miközben még mindig lehetővé teszi a testreszabást. A csoporthoz kapcsolódó utasítások összefognak, és információkat/figyelmeztető üzeneteket használnak a kontextus biztosítására.A komplex konfigurációk logikai szakaszokká történő bontása miatt a folyamat kezelhető, nem pedig elnyomó. Míg a Laravel Prompts kezeli a legtöbb kompatibilitási problémát, a Windows Command Prompt, a PowerShell és a különböző Unix héjak tapasztalatainak ellenőrzése biztosítja a minőséget. Taylor Otwell, a Laravel alapítója "A Laravel Prompts átalakítja a CLI-alkalmazásokat a megfélemlítő fekete dobozoktól vezérelt, felhasználóbarát élményekké. A FAQ K: Használhatom a Laravel Prompts-t a Laravel alkalmazásokon kívül? V: Igen! A Laravel Prompts keretrendszer-agnosztikus, és bármilyen PHP projektben működik. Kérdés: Hogyan kezelhetem az automatizált tesztelés során a felhívásokat? V: A Laravel Prompts tesztelési segédeszközöket is tartalmaz. Használja a Prompt::fake() módszert a tesztelés során a felhasználói bemenetek szimulálására anélkül, hogy tényleges terminális interakcióra lenne szüksége. K: Működnek-e a felhívások a Docker-tartályokban? V: Igen, de győződjön meg róla, hogy a tartály engedélyezte a TTY-t. Használja a docker run -it vagy a set tty: true funkciót a docker-compose.yml-ben az interaktív felhívások megfelelő működéséhez. K: Testreszabhatom a felhívások megjelenését?V: Bár az alapértelmezett stílus következetes és professzionális, akkor létrehozhat egyéni felhívási osztályokat, amelyek kiterjesztik az alapkomponenseket, ha speciális vizuális módosításokra van szüksége. K: Mi történik, ha egy felhasználó a Ctrl+C-vel törli a meghívót? V: A Laravel Prompts tiszteletben tartja a törlést, és a UserCancelledException-t dobja. K: Kompatibilisek-e a meghívók a Windows parancsnoki utasítással? V: Abszolút. A Laravel Prompts speciális renderelési logikát tartalmaz a Windows-környezetekhez, így a meghívók kiválóan néznek ki a Command Prompt, a PowerShell és a Windows Terminal alkalmazásban. K: Használhatom a felhívásokat a fájlok kiválasztásához?V: Bár nincs beépített fájl böngésző felhívás, a keresési felhívásokat a fájlrendszer-vizsgálattal kombinálhatja a hatékony fájlválasztási felületek létrehozásához. Kérdés: Hogyan adhatok hozzá segítségnyújtási szöveget vagy utasításokat a felhívásokhoz? V: A legtöbb utasítási funkció egy utasítási paramétert fogad el, ahol további kontextust adhat meg. Freek Van der Herten, Laravel fejlesztő "A Laravel Prompts valódi ereje nem a webes űrlapok helyettesítésében rejlik, hanem abban, hogy a CLI-eszközöket hozzáférhetővé tegyék azoknak a fejlesztőknek, akik korábban félelmetesnek találták a terminális alkalmazásokat." következtetés A Laravel Prompts jelentős előrelépést jelent a parancsvonal-interfész kialakításában. Gyönyörű, intuitív interakciók biztosításával nulla konfigurációval eltávolítja azokat a technikai akadályokat, amelyek egyszer kihívást jelentettek a CLI fejlesztésében. Az általunk létrehozott SMTP konfigurációs varázsló bemutatja, hogy a bonyolult telepítési folyamatok hogyan válhatnak irányított tapasztalatokká. Ahelyett, hogy a felhasználóknak manuálisan kell szerkeszteniük a konfigurációs fájlokat, vagy emlékezniük kell a homályos beállításokra, minden lépésben érvényesítéssel és hasznos tippekkel járhat. Ez a megközelítés csökkenti a hibákat, javítja a felhasználói elégedettséget, és professzionálisabbá teszi alkalmazásait. Mivel a Laravel 12 továbbra is fejlődik, a Prompts továbbra is a CLI fejlesztés sarokköve marad az ökoszisztémában. Akár telepítési varázslókat, telepítési eszközöket vagy interaktív karbantartási parancsokat készít, a Laravel Prompts biztosítja az alapot olyan terminálalkalmazások létrehozásához, amelyeket a felhasználók valóban élveznek.