GNU Readline
Introdução
As funções readline() implementam uma interface para a biblioteca GNU Readline. Estas são funções que provem uma linha de comando editável. Um exeplo é o bash que permite a você usar as setas para inserir caracteres ou navegas no historico dos comandos. Por causa da naturesa interativa desta biblioteca, ela será de pouco uso para escrever aplicações web, mas será util quando você estiver escrevendo scripts que usem o PHP a partir da linha de comando.
Nota: Esta extensão não está disponível na plataforma Windows.
Dependências
Para usar as funções readline, você precisa instalar a libreadline. Você pode encontrar a libreadline na página do projeto GNU Readline, em » https://cnswww.cns.cwru.edu/~chet/readline/rltop.html. É mantida por Chet Ramey, que também é o autor do Bash.
Você também pode utilizar estas funções com a biblioteca libedit, uma substituição não-GLP para a biblioteca readline. A biblioteca libedit esta sobre a licença BSD e esta disponível para download a partir de » https://www.thrysoee.dk/editline/.
Instalação
Para usar estas funções você deverá compilar as versões CGI ou CLI version do PHP com suporte readline. Você precisa configurar o PHP com --with-readline[=DIR]. Para usar a substituiçao libedit readline, configure o PHP com --with-libedit[=DIR].
Configurações em execução
Esta extensão não define nenhum parâmetro de configuração no php.ini.
Tipos Resource
Esta extensão não possui nenhum tipo resource.
Constantes pré-definidas
Esta extensão não possui nenhuma constante.
Índice
- readline_add_history — Adiciona uma linha ao histórico
- readline_callback_handler_install — Initializes the readline callback interface and terminal, prints the prompt and returns immediately
- readline_callback_handler_remove — Removes a previously installed callback handler and restores terminal settings
- readline_callback_read_char — Reads a character and informs the readline callback interface when a line is received
- readline_clear_history — Limpa a história
- readline_completion_function — Registra uma função de completar
- readline_info — Obtém/Define várias variáveis internas do readline
- readline_list_history — Lista a história
- readline_on_new_line — Inform readline that the cursor has moved to a new line
- readline_read_history — Lê a história
- readline_redisplay — Redraws the display
- readline_write_history — Grava a história
- readline — Lê uma linha