php man page for readline

READLINE(3)								 1							       READLINE(3)

readline - Reads a line

SYNOPSIS
       string readline ([string  $prompt])

DESCRIPTION
	Reads a single line from the user. You must add this line to the history yourself using readline_add_history(3).

PARAMETERS
	      o $prompt
		- You may specify a string with which to prompt the user.

RETURN VALUES
	Returns a single string from the user. The line returned has the ending newline removed.

EXAMPLES
       Example #1

	      readline(3) Example

	      <?php
	      //get 3 commands from user
	      for ($i=0; $i < 3; $i++) {
		      $line = readline("Command: ");
		      readline_add_history($line);
	      }

	      //dump history
	      print_r(readline_list_history());

	      //dump variables
	      print_r(readline_info());
	      ?>

PHP Documentation Group 													       READLINE(3)