Laravel通过Symfony Console组件提供ask、secret、confirm和choice等方法实现命令行交互,可创建用户输入、密码隐藏、选项选择等功能;结合Laravel Zero及第三方库如laravel-console-menu,还能构建更复杂的交互式CLI应用,适用于高级菜单与独立工具开发。

在 Laravel 生态中,虽然没有原生的 Laravel Prompts 组件,但你可以使用社区广泛采用的 spatie/laravel-artisan-prompt 或基于 symfony/console 的交互功能来创建交互式命令行工具。不过最近,Laravel Zero 和一些前端提示库(如 bobthecow/psysh 风格)也推动了更现代的交互式 CLI 开发方式。下面介绍如何在 Laravel 中创建交互式命令行工具。
使用 Artisan 命令实现基础交互
Laravel 自带的 Artisan 命令系统基于 Symfony Console 组件,支持多种用户交互方式:
- ask():请求用户输入文本
- secret():隐藏输入(如密码)
- confirm():确认操作(是/否)
- choice():从选项中选择一项
示例:创建一个可交互的用户创建命令
php artisan make:command CreateUserCommand
编辑生成的命令文件:
namespace App\Console\Commands;
use Illuminate\Console\Command;
use App\Models\User;
class CreateUserCommand extends Command
{
protected $signature = 'user:create';
protected $description = '创建新用户';
public function handle()
{
$name = $this->ask('请输入用户名');
$email = $this->ask('请输入邮箱');
$password = $this->secret('请输入密码');
$confirmed = $this->confirm('确定要创建这个用户吗?', true);
if (! $confirmed) {
$this->info('操作已取消');
return;
}
User::create([
'name' => $name,
'email' => $email,
'password' => bcrypt($password),
]);
$this->info('用户创建成功!');
}
}
使用 choice 实现菜单式交互
如果你希望用户提供多个选项中的一个,可以使用 choice() 方法:
$role = $this->choice(
'请选择用户角色',
['admin', 'editor', 'viewer'],
'viewer'
);
这会显示一个选择列表,用户可通过键盘上下键选择,默认值为 viewer。
高级交互:集成第三方提示库
如果你想获得更现代的交互体验(比如自动补全、多选、滑块等),可以考虑使用 PHP 的 Webuni\Symfony\Console\Prompts 或结合 dialog、inquirer.php 类似库。
目前有一个流行的趋势是使用 Laravel Zero 搭建独立的 CLI 应用,它集成了 nunomaduro/laravel-console-menu 等包:
composer require laravel-zero/framework php application app:install nunomaduro/laravel-console-menu
然后可在命令中使用图形化菜单:
use LaravelZero\Framework\Components\ConsoleMenu\Menu;
$menu = $this->menu('选择操作', [
'创建用户',
'删除用户',
'列出用户'
]);
$option = $menu->open();
match($option) {
0 => $this->createUser(),
1 => $this->deleteUser(),
2 => $this->listUsers()
};
注册命令并运行
确保你的命令已注册到 app/Console/Kernel.php 的 $commands 数组中:
protected $commands = [
Commands\CreateUserCommand::class,
];
运行命令:
php artisan user:create
基本上就这些。Laravel 自身提供的交互方法已经足够应对大多数 CLI 场景。如果需要更复杂的界面,建议使用 Laravel Zero 构建专用命令行应用。交互设计的关键是清晰提示和良好反馈,避免让用户迷失在流程中。










