A partir do PHP 5.1.0, o CLI SAPI fornece um shell interativo usando a opção -a se o PHP for compilado com a opção --with-readline .
Usando o shell interativo você será capaz de escrever código PHP e executá-lo diretamente.
Exemplo #1 Executando código usando o shell interativo
$ php -a
Interactive shell
php > echo 5+8;
13
php > function addTwo($n)
php > {
php { return $n + 2;
php { }
php > var_dump(addtwo(2));
int(4)
php >
O shel interativo também possui sugestões de complemento com tab para funções, constantes, nomes de classes, variáveis, chamadas para métodos estáticos e constantes de classe.
Exemplo #2 Sugestões de complemento com tab
Pressionar a tecla tab duas vezes quando tiver mais de uma sugestão de complemento resultará numa lista desses complementos.
php > strp[TAB][TAB] strpbrk strpos strptime php > strp
Quando existir apenas um possível complemento, pressionar a tecla tab uma vez irá completar o restante da mesma linha:
php > strpt[TAB]ime(
Complementos também funcionarão para nomes que forem definidos durante a mesma sessão do shell interativo:
php > $fooThisIsAReallyLongVariableName = 42; php > $foo[TAB]ThisIsAReallyLongVariableName
O shell interativo armazena seu histórico que pode ser acessado usando as teclas para cima e para baixo. O histórico é salvo no arquivo ~/.php_history.
A partir da versão 5.4.0 do PHP, o CLI SAPI fornece as configurações do
php.ini cli.pager e
cli.prompt. A configuração cli.pager
permite que um programa externo (como o less) aja como
uma alternativa para a saída ao invés dela ser exibida diretamente na tela.
A configuração cli.prompt faz com que seja possível alterar
a saída php >.
No PHP 5.4.0 também é possível definir configurações php.ini no shell interativo usando uma notação abreviada.
Exemplo #3 Definindo configurações php.ini no shell interativo
A opção cli.prompt:
php > #cli.prompt=hello world :> hello world :>
Usando crase é possível executar o PHP diretamente no terminal:
php > #cli.prompt=`echo date('H:i:s');` php >
15:49:35 php > echo 'hi';
hi
15:49:43 php > sleep(2);
15:49:45 php >
Setando o paginador paraless:
php > #cli.pager=less php > phpinfo(); (output displayed in less) php >
A configuração cli.prompt suporta algumas sequências de
escape:
| Sequência | Descrição |
|---|---|
| \e | Usada para adicionar cores ao terminal. Um exemplo pode ser \e[032m\v \e[031m\b \e[34m\> \e[0m |
| \v | A versão do PHP. |
| \b | Indica em qual bloco o PHP está. Por exemplo /* irá indicar que o PHP está dentro de um comentário de multiplas linhas. O escopo externo será denominado por php. |
| \> | Indica o caractere do terminal. Por padrão é >, mas pode alterar qaundo o shell estiver dentro de um bloco indeterminado ou de uma string. Possíveis caracteres são: ' " { ( > |
Nota:
Arquivos incluídos através de auto_prepend_file e auto_append_file são interpretados nesse modo porém com algumas restrições - Exemplo: funções devem ser definidas antes de sua chamada.
Nota:
Autoloading não está disponível quando estiver usando o PHP no modo interativo da CLI.