Laravel Prompts核心功能全解析：10种表单组件让你的CLI应用脱颖而出

【免费下载链接】promptsBeautiful and user-friendly forms for your command-line PHP applications.项目地址: https://gitcode.com/gh_mirrors/pro/prompts

Laravel Prompts是一款专为PHP命令行应用设计的表单组件库，它能帮助开发者轻松构建美观且用户友好的命令行交互界面。无论是Artisan控制台命令还是独立的PHP CLI项目，Laravel Prompts都能提供浏览器级别的用户体验，包括占位符文本、实时验证和交互式操作等功能。通过本文，你将了解如何利用其10种核心表单组件，让你的命令行应用脱颖而出。

为什么选择Laravel Prompts？

在命令行应用开发中，用户输入的处理往往是最繁琐的部分之一。Laravel Prompts通过提供一系列预构建的表单组件，极大简化了这一过程。它不仅支持基础的文本输入、选择框等元素，还提供了高级功能如自动完成、数据表格和进度条，让CLI应用的交互体验提升到新的水平。

核心优势

• 美观的默认主题：内置的默认主题采用现代化设计，支持亮色/暗色模式自动切换，确保在不同终端环境下都有出色的显示效果。
• 丰富的交互组件：从简单的文本输入到复杂的多选项搜索，满足各种场景需求。
• 实时验证：提供即时的输入验证反馈，减少用户错误。
• 跨平台兼容：支持Windows、macOS和Linux等主流操作系统。

10种必备表单组件详解

1. 文本输入（Text Prompt）

文本输入是最基础也最常用的表单组件，适用于收集用户的单行文本信息。Laravel Prompts的文本输入组件支持占位符、默认值、必填项验证和输入转换等功能。

使用场景：收集用户名、邮箱地址、标题等简单文本信息。

核心特性：

• 支持占位符文本
• 实时输入验证
• 输入值转换（如自动转为小写）
• 自定义提示信息和错误提示

实现文件：src/TextPrompt.php

2. 多行文本输入（Textarea Prompt）

当需要收集多行文本信息时，多行文本输入组件是理想选择。它提供了类似文本编辑器的体验，支持指定行数和自动换行。

使用场景：收集描述信息、备注、长文本输入等。

核心特性：

• 可指定显示行数
• 支持自动换行
• 滚动条支持
• 长度限制验证

实现文件：src/TextareaPrompt.php

3. 密码输入（Password Prompt）

密码输入组件用于收集敏感信息，如密码或API密钥。它会自动隐藏用户输入的内容，确保信息安全。

使用场景：用户认证、敏感信息输入等。

核心特性：

• 输入内容隐藏显示
• 支持密码强度验证
• 可自定义掩码字符
• 确认密码功能

实现文件：src/PasswordPrompt.php

4. 单选框（Select Prompt）

单选框组件允许用户从预定义的选项列表中选择一个选项。它支持键盘导航和搜索功能，特别适合选项较多的场景。

使用场景：选择类别、状态、优先级等单一选项。

核心特性：

• 支持键盘上下键导航
• 选项搜索功能
• 可设置默认选项
• 滚动列表支持

实现文件：src/SelectPrompt.php

5. 多选框（MultiSelect Prompt）

多选框组件允许用户从选项列表中选择多个选项，适用于需要收集多个相关值的场景。

使用场景：选择多个标签、权限设置、批量操作等。

核心特性：

• 空格键切换选择状态
• 支持全选/取消全选
• 已选项目计数显示
• 滚动列表支持

实现文件：src/MultiSelectPrompt.php

6. 确认提示（Confirm Prompt）

确认提示用于获取用户的简单是/否回答，通常用于确认操作或重要决策。

使用场景：确认删除操作、提交表单前确认、重要操作二次确认等。

核心特性：

• 支持自定义"是/否"文本
• 可设置默认选项
• 简洁的交互方式
• 适合快速决策

实现文件：src/ConfirmPrompt.php

7. 数字输入（Number Prompt）

数字输入组件专门用于收集数字类型的输入，支持范围限制和步长设置。

使用场景：收集数量、年龄、价格等数值信息。

核心特性：

• 支持键盘上下键调整数值
• 可设置最小值和最大值
• 自定义步长
• 数字格式化显示

实现文件：src/NumberPrompt.php

8. 自动完成（AutoComplete Prompt）

自动完成组件会根据用户输入实时提供匹配的选项，大大提高输入效率和准确性。

使用场景：输入已知的选项值，如国家/地区、产品名称、用户名等。

核心特性：

• 实时匹配建议
• 支持键盘选择建议
• 可自定义匹配逻辑
• 支持动态数据源

实现文件：src/AutoCompletePrompt.php

9. 搜索提示（Search Prompt）

搜索提示组件允许用户通过关键词搜索并选择选项，特别适合处理大量数据的场景。

使用场景：从大型列表中查找并选择项目，如客户、产品、文章等。

核心特性：

• 实时搜索结果
• 支持分页加载
• 搜索历史记录
• 高亮显示匹配结果

实现文件：src/SearchPrompt.php

10. 数据表格（DataTable Prompt）

数据表格组件以表格形式展示结构化数据，并允许用户浏览、搜索和选择行。

使用场景：展示订单列表、用户列表、产品目录等结构化数据。

核心特性：

• 支持列排序
• 内置搜索功能
• 分页浏览
• 行选择功能

实现文件：src/DataTablePrompt.php

如何开始使用Laravel Prompts

安装步骤

要在你的项目中使用Laravel Prompts，首先需要通过Composer安装：

composer require laravel/prompts

如果你想直接体验所有组件，可以克隆官方仓库并运行示例：

git clone https://gitcode.com/gh_mirrors/pro/prompts cd prompts composer install php artisan playground

基本使用示例

以下是一个简单的表单示例，展示了如何使用多个Laravel Prompts组件：

use function Laravel\Prompts\form; $responses = form() ->text('What is your name?', placeholder: 'John Doe') ->email('What is your email?') ->password('Create a password') ->select('Choose a plan', [ 'basic' => 'Basic ($9.99/month)', 'pro' => 'Pro ($19.99/month)', 'enterprise' => 'Enterprise ($49.99/month)', ]) ->multiselect('Select features', [ 'analytics' => 'Analytics', 'api' => 'API Access', 'support' => 'Priority Support', ]) ->confirm('Agree to terms?') ->submit(); // 处理表单提交结果 print_r($responses);

高级功能

表单构建器

Laravel Prompts提供了一个强大的表单构建器，允许你创建包含多个组件的复杂表单，并轻松处理表单提交结果。

实现文件：src/FormBuilder.php

主题定制

如果你不满足于默认主题，可以通过实现自定义渲染器来创建自己的主题。每个组件都有对应的渲染器，可以单独定制。

主题基础文件：src/Themes/Default/Renderer.php

输入转换和验证

所有组件都支持输入转换和验证功能，你可以轻松实现自定义的业务逻辑：

$name = text( label: 'What is your name?', validate: fn ($value) => strlen($value) < 3 ? 'Name must be at least 3 characters.' : null, transform: fn ($value) => ucwords(strtolower($value)) );

结语

Laravel Prompts为PHP命令行应用提供了一套完整的表单解决方案，通过其丰富的组件和直观的API，开发者可以轻松创建专业级的CLI交互界面。无论你是构建简单的脚本工具还是复杂的命令行应用，Laravel Prompts都能帮助你提升用户体验，减少开发时间。

立即尝试Laravel Prompts，让你的命令行应用焕发新的活力！

【免费下载链接】promptsBeautiful and user-friendly forms for your command-line PHP applications.项目地址: https://gitcode.com/gh_mirrors/pro/prompts