Prompts
- Introduction
- Installation
- Available Prompts
- Informational Messages
- Tables
- Spin
- Progress Bar
- Terminal Considerations
- Unsupported Environments and Fallbacks
Introduction
Laravel Prompts is a PHP package for adding beautiful and user-friendly forms to your command-line applications, with browser-like features including placeholder text and validation.
![](https://laravel.com/img/docs/prompts-example.png)
Laravel Prompts is perfect for accepting user input in your Artisan console commands, but it may also be used in any command-line PHP project.
[!NOTE]
Laravel Prompts supports macOS, Linux, and Windows with WSL. For more information, please see our documentation on unsupported environments & fallbacks.
Installation
Laravel Prompts is already included with the latest release of Laravel.
Laravel Prompts may also be installed in your other PHP projects by using the Composer package manager:
1composer require laravel/prompts
1composer require laravel/prompts
Available Prompts
Text
The text
function will prompt the user with the given question, accept their input, and then return it:
1use function Laravel\Prompts\text;23$name = text('What is your name?');
1use function Laravel\Prompts\text;23$name = text('What is your name?');
You may also include placeholder text, a default value, and an informational hint:
1$name = text(2 label: 'What is your name?',3 placeholder: 'E.g. Taylor Otwell',4 default: $user?->name,5 hint: 'This will be displayed on your profile.'6);
1$name = text(2 label: 'What is your name?',3 placeholder: 'E.g. Taylor Otwell',4 default: $user?->name,5 hint: 'This will be displayed on your profile.'6);
Required Values
If you require a value to be entered, you may pass the required
argument:
1$name = text(2 label: 'What is your name?',3 required: true4);
1$name = text(2 label: 'What is your name?',3 required: true4);
If you would like to customize the validation message, you may also pass a string:
1$name = text(2 label: 'What is your name?',3 required: 'Your name is required.'4);
1$name = text(2 label: 'What is your name?',3 required: 'Your name is required.'4);
Additional Validation
Finally, if you would like to perform additional validation logic, you may pass a closure to the validate
argument:
1$name = text(2 label: 'What is your name?',3 validate: fn (string $value) => match (true) {4 strlen($value) < 3 => 'The name must be at least 3 characters.',5 strlen($value) > 255 => 'The name must not exceed 255 characters.',6 default => null7 }8);
1$name = text(2 label: 'What is your name?',3 validate: fn (string $value) => match (true) {4 strlen($value) < 3 => 'The name must be at least 3 characters.',5 strlen($value) > 255 => 'The name must not exceed 255 characters.',6 default => null7 }8);
The closure will receive the value that has been entered and may return an error message, or null
if the validation passes.
Password
The password
function is similar to the text
function, but the user's input will be masked as they type in the console. This is useful when asking for sensitive information such as passwords:
1use function Laravel\Prompts\password;23$password = password('What is your password?');
1use function Laravel\Prompts\password;23$password = password('What is your password?');
You may also include placeholder text and an informational hint:
1$password = password(2 label: 'What is your password?',3 placeholder: 'password',4 hint: 'Minimum 8 characters.'5);
1$password = password(2 label: 'What is your password?',3 placeholder: 'password',4 hint: 'Minimum 8 characters.'5);
Required Values
If you require a value to be entered, you may pass the required
argument:
1$password = password(2 label: 'What is your password?',3 required: true4);
1$password = password(2 label: 'What is your password?',3 required: true4);
If you would like to customize the validation message, you may also pass a string:
1$password = password(2 label: 'What is your password?',3 required: 'The password is required.'4);
1$password = password(2 label: 'What is your password?',3 required: 'The password is required.'4);
Additional Validation
Finally, if you would like to perform additional validation logic, you may pass a closure to the validate
argument:
1$password = password(2 label: 'What is your password?',3 validate: fn (string $value) => match (true) {4 strlen($value) < 8 => 'The password must be at least 8 characters.',5 default => null6 }7);
1$password = password(2 label: 'What is your password?',3 validate: fn (string $value) => match (true) {4 strlen($value) < 8 => 'The password must be at least 8 characters.',5 default => null6 }7);
The closure will receive the value that has been entered and may return an error message, or null
if the validation passes.
Confirm
If you need to ask the user for a "yes or no" confirmation, you may use the confirm
function. Users may use the arrow keys or press y
or n
to select their response. This function will return either true
or false
.
1use function Laravel\Prompts\confirm;23$confirmed = confirm('Do you accept the terms?');
1use function Laravel\Prompts\confirm;23$confirmed = confirm('Do you accept the terms?');
You may also include a default value, customized wording for the "Yes" and "No" labels, and an informational hint:
1$confirmed = confirm(2 label: 'Do you accept the terms?',3 default: false,4 yes: 'I accept',5 no: 'I decline',6 hint: 'The terms must be accepted to continue.'7);
1$confirmed = confirm(2 label: 'Do you accept the terms?',3 default: false,4 yes: 'I accept',5 no: 'I decline',6 hint: 'The terms must be accepted to continue.'7);
Requiring "Yes"
If necessary, you may require your users to select "Yes" by passing the required
argument:
1$confirmed = confirm(2 label: 'Do you accept the terms?',3 required: true4);
1$confirmed = confirm(2 label: 'Do you accept the terms?',3 required: true4);
If you would like to customize the validation message, you may also pass a string:
1$confirmed = confirm(2 label: 'Do you accept the terms?',3 required: 'You must accept the terms to continue.'4);
1$confirmed = confirm(2 label: 'Do you accept the terms?',3 required: 'You must accept the terms to continue.'4);
Select
If you need the user to select from a predefined set of choices, you may use the select
function:
1use function Laravel\Prompts\select;23$role = select(4 'What role should the user have?',5 ['Member', 'Contributor', 'Owner'],6);
1use function Laravel\Prompts\select;23$role = select(4 'What role should the user have?',5 ['Member', 'Contributor', 'Owner'],6);
You may also specify the default choice and an informational hint:
1$role = select(2 label: 'What role should the user have?',3 options: ['Member', 'Contributor', 'Owner'],4 default: 'Owner',5 hint: 'The role may be changed at any time.'6);
1$role = select(2 label: 'What role should the user have?',3 options: ['Member', 'Contributor', 'Owner'],4 default: 'Owner',5 hint: 'The role may be changed at any time.'6);
You may also pass an associative array to the options
argument to have the selected key returned instead of its value:
1$role = select(2 label: 'What role should the user have?',3 options: [4 'member' => 'Member',5 'contributor' => 'Contributor',6 'owner' => 'Owner'7 ],8 default: 'owner'9);
1$role = select(2 label: 'What role should the user have?',3 options: [4 'member' => 'Member',5 'contributor' => 'Contributor',6 'owner' => 'Owner'7 ],8 default: 'owner'9);
Up to five options will be displayed before the list begins to scroll. You may customize this by passing the scroll
argument:
1$role = select(2 label: 'Which category would you like to assign?',3 options: Category::pluck('name', 'id'),4 scroll: 105);
1$role = select(2 label: 'Which category would you like to assign?',3 options: Category::pluck('name', 'id'),4 scroll: 105);
Validation
Unlike other prompt functions, the select
function doesn't accept the required
argument because it is not possible to select nothing. However, you may pass a closure to the validate
argument if you need to present an option but prevent it from being selected:
1$role = select(2 label: 'What role should the user have?',3 options: [4 'member' => 'Member',5 'contributor' => 'Contributor',6 'owner' => 'Owner'7 ],8 validate: fn (string $value) =>9 $value === 'owner' && User::where('role', 'owner')->exists()10 ? 'An owner already exists.'11 : null12);
1$role = select(2 label: 'What role should the user have?',3 options: [4 'member' => 'Member',5 'contributor' => 'Contributor',6 'owner' => 'Owner'7 ],8 validate: fn (string $value) =>9 $value === 'owner' && User::where('role', 'owner')->exists()10 ? 'An owner already exists.'11 : null12);
If the options
argument is an associative array, then the closure will receive the selected key, otherwise it will receive the selected value. The closure may return an error message, or null
if the validation passes.
Multi-select
If you need to the user to be able to select multiple options, you may use the multiselect
function:
1use function Laravel\Prompts\multiselect;23$permissions = multiselect(4 'What permissions should be assigned?',5 ['Read', 'Create', 'Update', 'Delete']6);
1use function Laravel\Prompts\multiselect;23$permissions = multiselect(4 'What permissions should be assigned?',5 ['Read', 'Create', 'Update', 'Delete']6);
You may also specify default choices and an informational hint:
1use function Laravel\Prompts\multiselect;23$permissions = multiselect(4 label: 'What permissions should be assigned?',5 options: ['Read', 'Create', 'Update', 'Delete'],6 default: ['Read', 'Create'],7 hint: 'Permissions may be updated at any time.'8);
1use function Laravel\Prompts\multiselect;23$permissions = multiselect(4 label: 'What permissions should be assigned?',5 options: ['Read', 'Create', 'Update', 'Delete'],6 default: ['Read', 'Create'],7 hint: 'Permissions may be updated at any time.'8);
You may also pass an associative array to the options
argument to return the selected options' keys instead of their values:
1$permissions = multiselect(2 label: 'What permissions should be assigned?',3 options: [4 'read' => 'Read',5 'create' => 'Create',6 'update' => 'Update',7 'delete' => 'Delete'8 ],9 default: ['read', 'create']10);
1$permissions = multiselect(2 label: 'What permissions should be assigned?',3 options: [4 'read' => 'Read',5 'create' => 'Create',6 'update' => 'Update',7 'delete' => 'Delete'8 ],9 default: ['read', 'create']10);
Up to five options will be displayed before the list begins to scroll. You may customize this by passing the scroll
argument:
1$categories = multiselect(2 label: 'What categories should be assigned?',3 options: Category::pluck('name', 'id'),4 scroll: 105);
1$categories = multiselect(2 label: 'What categories should be assigned?',3 options: Category::pluck('name', 'id'),4 scroll: 105);
Requiring a Value
By default, the user may select zero or more options. You may pass the required
argument to enforce one or more options instead:
1$categories = multiselect(2 label: 'What categories should be assigned?',3 options: Category::pluck('name', 'id'),4 required: true,5);
1$categories = multiselect(2 label: 'What categories should be assigned?',3 options: Category::pluck('name', 'id'),4 required: true,5);
If you would like to customize the validation message, you may provide a string to the required
argument:
1$categories = multiselect(2 label: 'What categories should be assigned?',3 options: Category::pluck('name', 'id'),4 required: 'You must select at least one category',5);
1$categories = multiselect(2 label: 'What categories should be assigned?',3 options: Category::pluck('name', 'id'),4 required: 'You must select at least one category',5);
Validation
You may pass a closure to the validate
argument if you need to present an option but prevent it from being selected:
1$permissions = multiselect(2 label: 'What permissions should the user have?',3 options: [4 'read' => 'Read',5 'create' => 'Create',6 'update' => 'Update',7 'delete' => 'Delete'8 ],9 validate: fn (array $values) => ! in_array('read', $values)10 ? 'All users require the read permission.'11 : null12);
1$permissions = multiselect(2 label: 'What permissions should the user have?',3 options: [4 'read' => 'Read',5 'create' => 'Create',6 'update' => 'Update',7 'delete' => 'Delete'8 ],9 validate: fn (array $values) => ! in_array('read', $values)10 ? 'All users require the read permission.'11 : null12);
If the options
argument is an associative array then the closure will receive the selected keys, otherwise it will receive the selected values. The closure may return an error message, or null
if the validation passes.
Suggest
The suggest
function can be used to provide auto-completion for possible choices. The user can still provide any answer, regardless of the auto-completion hints:
1use function Laravel\Prompts\suggest;23$name = suggest('What is your name?', ['Taylor', 'Dayle']);
1use function Laravel\Prompts\suggest;23$name = suggest('What is your name?', ['Taylor', 'Dayle']);
Alternatively, you may pass a closure as the second argument to the suggest
function. The closure will be called each time the user types an input character. The closure should accept a string parameter containing the user's input so far and return an array of options for auto-completion:
1$name = suggest(2 'What is your name?',3 fn ($value) => collect(['Taylor', 'Dayle'])4 ->filter(fn ($name) => Str::contains($name, $value, ignoreCase: true))5)
1$name = suggest(2 'What is your name?',3 fn ($value) => collect(['Taylor', 'Dayle'])4 ->filter(fn ($name) => Str::contains($name, $value, ignoreCase: true))5)
You may also include placeholder text, a default value, and an informational hint:
1$name = suggest(2 label: 'What is your name?',3 options: ['Taylor', 'Dayle'],4 placeholder: 'E.g. Taylor',5 default: $user?->name,6 hint: 'This will be displayed on your profile.'7);
1$name = suggest(2 label: 'What is your name?',3 options: ['Taylor', 'Dayle'],4 placeholder: 'E.g. Taylor',5 default: $user?->name,6 hint: 'This will be displayed on your profile.'7);
Required Values
If you require a value to be entered, you may pass the required
argument:
1$name = suggest(2 label: 'What is your name?',3 options: ['Taylor', 'Dayle'],4 required: true5);
1$name = suggest(2 label: 'What is your name?',3 options: ['Taylor', 'Dayle'],4 required: true5);
If you would like to customize the validation message, you may also pass a string:
1$name = suggest(2 label: 'What is your name?',3 options: ['Taylor', 'Dayle'],4 required: 'Your name is required.'5);
1$name = suggest(2 label: 'What is your name?',3 options: ['Taylor', 'Dayle'],4 required: 'Your name is required.'5);
Additional Validation
Finally, if you would like to perform additional validation logic, you may pass a closure to the validate
argument:
1$name = suggest(2 label: 'What is your name?',3 options: ['Taylor', 'Dayle'],4 validate: fn (string $value) => match (true) {5 strlen($value) < 3 => 'The name must be at least 3 characters.',6 strlen($value) > 255 => 'The name must not exceed 255 characters.',7 default => null8 }9);
1$name = suggest(2 label: 'What is your name?',3 options: ['Taylor', 'Dayle'],4 validate: fn (string $value) => match (true) {5 strlen($value) < 3 => 'The name must be at least 3 characters.',6 strlen($value) > 255 => 'The name must not exceed 255 characters.',7 default => null8 }9);
The closure will receive the value that has been entered and may return an error message, or null
if the validation passes.
Search
If you have a lot of options for the user to select from, the search
function allows the user to type a search query to filter the results before using the arrow keys to select an option:
1use function Laravel\Prompts\search;23$id = search(4 'Search for the user that should receive the mail',5 fn (string $value) => strlen($value) > 06 ? User::where('name', 'like', "%{$value}%")->pluck('name', 'id')->all()7 : []8);
1use function Laravel\Prompts\search;23$id = search(4 'Search for the user that should receive the mail',5 fn (string $value) => strlen($value) > 06 ? User::where('name', 'like', "%{$value}%")->pluck('name', 'id')->all()7 : []8);
The closure will receive the text that has been typed by the user so far and must return an array of options. If you return an associative array then the selected option's key will be returned, otherwise its value will be returned instead.
You may also include placeholder text and an informational hint:
1$id = search(2 label: 'Search for the user that should receive the mail',3 placeholder: 'E.g. Taylor Otwell',4 options: fn (string $value) => strlen($value) > 05 ? User::where('name', 'like', "%{$value}%")->pluck('name', 'id')->all()6 : [],7 hint: 'The user will receive an email immediately.'8);
1$id = search(2 label: 'Search for the user that should receive the mail',3 placeholder: 'E.g. Taylor Otwell',4 options: fn (string $value) => strlen($value) > 05 ? User::where('name', 'like', "%{$value}%")->pluck('name', 'id')->all()6 : [],7 hint: 'The user will receive an email immediately.'8);
Up to five options will be displayed before the list begins to scroll. You may customize this by passing the scroll
argument:
1$id = search(2 label: 'Search for the user that should receive the mail',3 options: fn (string $value) => strlen($value) > 04 ? User::where('name', 'like', "%{$value}%")->pluck('name', 'id')->all()5 : [],6 scroll: 107);
1$id = search(2 label: 'Search for the user that should receive the mail',3 options: fn (string $value) => strlen($value) > 04 ? User::where('name', 'like', "%{$value}%")->pluck('name', 'id')->all()5 : [],6 scroll: 107);
Validation
If you would like to perform additional validation logic, you may pass a closure to the validate
argument:
1$id = search(2 label: 'Search for the user that should receive the mail',3 options: fn (string $value) => strlen($value) > 04 ? User::where('name', 'like', "%{$value}%")->pluck('name', 'id')->all()5 : [],6 validate: function (int|string $value) {7 $user = User::findOrFail($value);89 if ($user->opted_out) {10 return 'This user has opted-out of receiving mail.';11 }12 }13);
1$id = search(2 label: 'Search for the user that should receive the mail',3 options: fn (string $value) => strlen($value) > 04 ? User::where('name', 'like', "%{$value}%")->pluck('name', 'id')->all()5 : [],6 validate: function (int|string $value) {7 $user = User::findOrFail($value);89 if ($user->opted_out) {10 return 'This user has opted-out of receiving mail.';11 }12 }13);
If the options
closure returns an associative array, then the closure will receive the selected key, otherwise, it will receive the selected value. The closure may return an error message, or null
if the validation passes.
Multi-search
If you have a lot of searchable options and need the user to be able to select multiple items, the multisearch
function allows the user to type a search query to filter the results before using the arrow keys and space-bar to select options:
1use function Laravel\Prompts\multisearch;23$ids = multisearch(4 'Search for the users that should receive the mail',5 fn (string $value) => strlen($value) > 06 ? User::where('name', 'like', "%{$value}%")->pluck('name', 'id')->all()7 : []8);
1use function Laravel\Prompts\multisearch;23$ids = multisearch(4 'Search for the users that should receive the mail',5 fn (string $value) => strlen($value) > 06 ? User::where('name', 'like', "%{$value}%")->pluck('name', 'id')->all()7 : []8);
The closure will receive the text that has been typed by the user so far and must return an array of options. If you return an associative array then the selected options' keys will be returned; otherwise, their values will be returned instead.
You may also include placeholder text and an informational hint:
1$ids = multisearch(2 label: 'Search for the users that should receive the mail',3 placeholder: 'E.g. Taylor Otwell',4 options: fn (string $value) => strlen($value) > 05 ? User::where('name', 'like', "%{$value}%")->pluck('name', 'id')->all()6 : [],7 hint: 'The user will receive an email immediately.'8);
1$ids = multisearch(2 label: 'Search for the users that should receive the mail',3 placeholder: 'E.g. Taylor Otwell',4 options: fn (string $value) => strlen($value) > 05 ? User::where('name', 'like', "%{$value}%")->pluck('name', 'id')->all()6 : [],7 hint: 'The user will receive an email immediately.'8);
Up to five options will be displayed before the list begins to scroll. You may customize this by providing the scroll
argument:
1$ids = multisearch(2 label: 'Search for the users that should receive the mail',3 options: fn (string $value) => strlen($value) > 04 ? User::where('name', 'like', "%{$value}%")->pluck('name', 'id')->all()5 : [],6 scroll: 107);
1$ids = multisearch(2 label: 'Search for the users that should receive the mail',3 options: fn (string $value) => strlen($value) > 04 ? User::where('name', 'like', "%{$value}%")->pluck('name', 'id')->all()5 : [],6 scroll: 107);
Requiring a Value
By default, the user may select zero or more options. You may pass the required
argument to enforce one or more options instead:
1$ids = multisearch(2 'Search for the users that should receive the mail',3 fn (string $value) => strlen($value) > 04 ? User::where('name', 'like', "%{$value}%")->pluck('name', 'id')->all()5 : [],6 required: true,7);
1$ids = multisearch(2 'Search for the users that should receive the mail',3 fn (string $value) => strlen($value) > 04 ? User::where('name', 'like', "%{$value}%")->pluck('name', 'id')->all()5 : [],6 required: true,7);
If you would like to customize the validation message, you may also provide a string to the required
argument:
1$ids = multisearch(2 'Search for the users that should receive the mail',3 fn (string $value) => strlen($value) > 04 ? User::where('name', 'like', "%{$value}%")->pluck('name', 'id')->all()5 : [],6 required: 'You must select at least one user.'7);
1$ids = multisearch(2 'Search for the users that should receive the mail',3 fn (string $value) => strlen($value) > 04 ? User::where('name', 'like', "%{$value}%")->pluck('name', 'id')->all()5 : [],6 required: 'You must select at least one user.'7);
Validation
If you would like to perform additional validation logic, you may pass a closure to the validate
argument:
1$ids = multisearch(2 label: 'Search for the users that should receive the mail',3 options: fn (string $value) => strlen($value) > 04 ? User::where('name', 'like', "%{$value}%")->pluck('name', 'id')->all()5 : [],6 validate: function (array $values) {7 $optedOut = User::where('name', 'like', '%a%')->findMany($values);89 if ($optedOut->isNotEmpty()) {10 return $optedOut->pluck('name')->join(', ', ', and ').' have opted out.';11 }12 }13);
1$ids = multisearch(2 label: 'Search for the users that should receive the mail',3 options: fn (string $value) => strlen($value) > 04 ? User::where('name', 'like', "%{$value}%")->pluck('name', 'id')->all()5 : [],6 validate: function (array $values) {7 $optedOut = User::where('name', 'like', '%a%')->findMany($values);89 if ($optedOut->isNotEmpty()) {10 return $optedOut->pluck('name')->join(', ', ', and ').' have opted out.';11 }12 }13);
If the options
closure returns an associative array, then the closure will receive the selected keys; otherwise, it will receive the selected values. The closure may return an error message, or null
if the validation passes.
Pause
The pause
function may be used to display informational text to the user and wait for them to confirm their desire to proceed by pressing the Enter / Return key:
1use function Laravel\Prompts\pause;23pause('Press ENTER to continue.');
1use function Laravel\Prompts\pause;23pause('Press ENTER to continue.');
Informational Messages
The note
, info
, warning
, error
, and alert
functions may be used to display informational messages:
1use function Laravel\Prompts\info;23info('Package installed successfully.');
1use function Laravel\Prompts\info;23info('Package installed successfully.');
Tables
The table
function makes it easy to display multiple rows and columns of data. All you need to do is provide the column names and the data for the table:
1use function Laravel\Prompts\table;23table(4 ['Name', 'Email'],5 User::all(['name', 'email'])6);
1use function Laravel\Prompts\table;23table(4 ['Name', 'Email'],5 User::all(['name', 'email'])6);
Spin
The spin
function displays a spinner along with an optional message while executing a specified callback. It serves to indicate ongoing processes and returns the callback's results upon completion:
1use function Laravel\Prompts\spin;23$response = spin(4 fn () => Http::get('http://example.com'),5 'Fetching response...'6);
1use function Laravel\Prompts\spin;23$response = spin(4 fn () => Http::get('http://example.com'),5 'Fetching response...'6);
[!WARNING]
Thespin
function requires thepcntl
PHP extension to animate the spinner. When this extension is not available, a static version of the spinner will appear instead.
Progress Bars
For long running tasks, it can be helpful to show a progress bar that informs users how complete the task is. Using the progress
function, Laravel will display a progress bar and advance its progress for each iteration over a given iterable value:
1use function Laravel\Prompts\progress;23$users = progress(4 label: 'Updating users',5 steps: User::all(),6 callback: fn ($user) => $this->performTask($user),7);
1use function Laravel\Prompts\progress;23$users = progress(4 label: 'Updating users',5 steps: User::all(),6 callback: fn ($user) => $this->performTask($user),7);
The progress
function acts like a map function and will return an array containing the return value of each iteration of your callback.
The callback may also accept the \Laravel\Prompts\Progress
instance, allowing you to modify the label and hint on each iteration:
1$users = progress(2 label: 'Updating users',3 steps: User::all(),4 callback: function ($user, $progress) {5 $progress6 ->label("Updating {$user->name}")7 ->hint("Created on {$user->created_at}");89 return $this->performTask($user);10 },11 hint: 'This may take some time.',12);
1$users = progress(2 label: 'Updating users',3 steps: User::all(),4 callback: function ($user, $progress) {5 $progress6 ->label("Updating {$user->name}")7 ->hint("Created on {$user->created_at}");89 return $this->performTask($user);10 },11 hint: 'This may take some time.',12);
Sometimes, you may need more manual control over how a progress bar is advanced. First, define the total number of steps the process will iterate through. Then, advance the progress bar via the advance
method after processing each item:
1$progress = progress(label: 'Updating users', steps: 10);23$users = User::all();45$progress->start();67foreach ($users as $user) {8 $this->performTask($user);910 $progress->advance();11}1213$progress->finish();
1$progress = progress(label: 'Updating users', steps: 10);23$users = User::all();45$progress->start();67foreach ($users as $user) {8 $this->performTask($user);910 $progress->advance();11}1213$progress->finish();
Terminal Considerations
Terminal Width
If the length of any label, option, or validation message exceeds the number of "columns" in the user's terminal, it will be automatically truncated to fit. Consider minimizing the length of these strings if your users may be using narrower terminals. A typically safe maximum length is 74 characters to support an 80-character terminal.
Terminal Height
For any prompts that accept the scroll
argument, the configured value will automatically be reduced to fit the height of the user's terminal, including space for a validation message.
Unsupported Environments and Fallbacks
Laravel Prompts supports macOS, Linux, and Windows with WSL. Due to limitations in the Windows version of PHP, it is not currently possible to use Laravel Prompts on Windows outside of WSL.
For this reason, Laravel Prompts supports falling back to an alternative implementation such as the Symfony Console Question Helper.
[!NOTE]
When using Laravel Prompts with the Laravel framework, fallbacks for each prompt have been configured for you and will be automatically enabled in unsupported environments.
Fallback Conditions
If you are not using Laravel or need to customize when the fallback behavior is used, you may pass a boolean to the fallbackWhen
static method on the Prompt
class:
1use Laravel\Prompts\Prompt;23Prompt::fallbackWhen(4 ! $input->isInteractive() || windows_os() || app()->runningUnitTests()5);
1use Laravel\Prompts\Prompt;23Prompt::fallbackWhen(4 ! $input->isInteractive() || windows_os() || app()->runningUnitTests()5);
Fallback Behavior
If you are not using Laravel or need to customize the fallback behavior, you may pass a closure to the fallbackUsing
static method on each prompt class:
1use Laravel\Prompts\TextPrompt;2use Symfony\Component\Console\Question\Question;3use Symfony\Component\Console\Style\SymfonyStyle;45TextPrompt::fallbackUsing(function (TextPrompt $prompt) use ($input, $output) {6 $question = (new Question($prompt->label, $prompt->default ?: null))7 ->setValidator(function ($answer) use ($prompt) {8 if ($prompt->required && $answer === null) {9 throw new \RuntimeException(is_string($prompt->required) ? $prompt->required : 'Required.');10 }1112 if ($prompt->validate) {13 $error = ($prompt->validate)($answer ?? '');1415 if ($error) {16 throw new \RuntimeException($error);17 }18 }1920 return $answer;21 });2223 return (new SymfonyStyle($input, $output))24 ->askQuestion($question);25});
1use Laravel\Prompts\TextPrompt;2use Symfony\Component\Console\Question\Question;3use Symfony\Component\Console\Style\SymfonyStyle;45TextPrompt::fallbackUsing(function (TextPrompt $prompt) use ($input, $output) {6 $question = (new Question($prompt->label, $prompt->default ?: null))7 ->setValidator(function ($answer) use ($prompt) {8 if ($prompt->required && $answer === null) {9 throw new \RuntimeException(is_string($prompt->required) ? $prompt->required : 'Required.');10 }1112 if ($prompt->validate) {13 $error = ($prompt->validate)($answer ?? '');1415 if ($error) {16 throw new \RuntimeException($error);17 }18 }1920 return $answer;21 });2223 return (new SymfonyStyle($input, $output))24 ->askQuestion($question);25});
Fallbacks must be configured individually for each prompt class. The closure will receive an instance of the prompt class and must return an appropriate type for the prompt.