Allows you to prompt for user input on the command line, and optionally hide the characters they type

Installs: 21 204 931

Dependents: 16

Suggesters: 0

Security: 0

Stars: 243

Watchers: 6

Forks: 7

Open Issues: 0

1.0.4 2020-12-15 21:32 UTC

This package is auto-updated.

Last update: 2024-05-16 04:59:19 UTC


While prompting for user input using fgets() is quite easy, sometimes you need to prompt for sensitive information. In these cases, the characters typed in by the user should not be directly visible, and this is quite a pain to do in a cross-platform way.

This tiny package fixes just that for you:


echo 'Say hello: ';

$answer = Seld\CliPrompt\CliPrompt::hiddenPrompt();

echo 'You answered: '.$answer . PHP_EOL;

// Output in the CLI:
// Say hello:
// You answered: hello


composer require seld/cli-prompt


  • Seld\CliPrompt\CliPrompt::hiddenPrompt($allowFallback = false);

    Prompts the user for input and hides what they type. If this fails for any reason and $allowFallback is set to true the prompt will be done using the usual fgets() and characters will be visible.

  • Seld\CliPrompt\CliPrompt::prompt();

    Regular user prompt for input with characters being shown on screen.

In both cases, the trailing newline the user enters when submitting the answer is trimmed.


PHP 5.3 and above


CLI-Prompt is licensed under the MIT License - see the LICENSE file for details


  • This project uses hiddeninput.exe to prompt for passwords on Windows, sources and details can be found on the github page of the project.