A lista de opções de linha de comando fornecidas pelo binário do PHP pode ser requisitada a qualquer momento bastando executar o PHP com a opção -h :
Usage: php [options] [-f] <file> [--] [args...]
php [options] -r <code> [--] [args...]
php [options] [-B <begin_code>] -R <code> [-E <end_code>] [--] [args...]
php [options] [-B <begin_code>] -F <file> [-E <end_code>] [--] [args...]
php [options] -- [args...]
php [options] -a
-a Run interactively
-c <path>|<file> Look for php.ini file in this directory
-n No php.ini file will be used
-d foo[=bar] Define INI entry foo with value 'bar'
-e Generate extended information for debugger/profiler
-f <file> Parse and execute <file>.
-h This help
-i PHP information
-l Syntax check only (lint)
-m Show compiled in modules
-r <code> Run PHP <code> without using script tags <?..?>
-B <begin_code> Run PHP <begin_code> before processing input lines
-R <code> Run PHP <code> for every input line
-F <file> Parse and execute <file> for every input line
-E <end_code> Run PHP <end_code> after processing all input lines
-H Hide any passed arguments from external tools.
-S <addr>:<port> Run with built-in web server.
-t <docroot> Specify document root <docroot> for built-in web server.
-s Output HTML syntax highlighted source.
-v Version number
-w Output source with stripped comments and whitespace.
-z <file> Load Zend extension <file>.
args... Arguments passed to script. Use -- args when first argument
starts with - or script is read from stdin
--ini Show configuration file names
--rf <name> Show information about function <name>.
--rc <name> Show information about class <name>.
--re <name> Show information about extension <name>.
--rz <name> Show information about Zend extension <name>.
--ri <name> Show configuration for extension <name>.
| Opção | Opção Extendida | Descrição |
|---|---|---|
| -a | --interactive |
Executa o PHP interativamente. Para mais informações veja a seção Shell interativo. |
| -b | --bindpath |
Vincula o Path para o modo externo do servidor FASTCGI (apenas em CGI). |
| -C | --no-chdir |
Não executa chdir para o diretório do script (apenas em CGI). |
| -q | --no-header |
Modo silencioso. Suprime os cabeçalhos HTTP na saída (apenas em CGI). |
| -T | --timing |
Calcula o tempo de execução do script repetidas quantidades de vezes (apenas em CGI). |
| -c | --php-ini |
Especifica um diretório para procurar pelo php.ini, ou um arquivo INI personalizado (que não precisa se chamar php.ini), exemplo: $ php -c /custom/directory/ my_script.php $ php -c /custom/directory/custom-file.ini my_script.php Se essa opção não for especificada, o php.ini será procurado no local padrão. |
| -n | --no-php-ini |
Ignore o php.ini completamente. |
| -d | --define |
Defina um valor personalizado para qualquer uma das diretivas de configuração permitidas em arquivos php.ini. A sintaxe é: -d configuration_directive[=value]
# Omitting the value part will set the given configuration directive to "1"
$ php -d max_execution_time
-r '$foo = ini_get("max_execution_time"); var_dump($foo);'
string(1) "1"
# Passing an empty value part will set the configuration directive to ""
php -d max_execution_time=
-r '$foo = ini_get("max_execution_time"); var_dump($foo);'
string(0) ""
# The configuration directive will be set to anything passed after the '=' character
$ php -d max_execution_time=20
-r '$foo = ini_get("max_execution_time"); var_dump($foo);'
string(2) "20"
$ php
-d max_execution_time=doesntmakesense
-r '$foo = ini_get("max_execution_time"); var_dump($foo);'
string(15) "doesntmakesense"
|
| -e | --profile-info |
Ativa o mode de informação extendido, para ser usado por um debugger/profiler. |
| -f | --file |
Lê e executa o arquivo especificado. A opção -f é opcional e pode ser omitida - fornecer somente o nome do arquivo a ser executado é suficiente.
|
| -h and -? | --help e --usage | Exibe uma lista de opções de linha de comando com a descrição do seu funcionamento. |
| -i | --info | Invoca phpinfo(), e exibe o resultado. Caso o PHP não esteja executando corretamente, é aconselhável usar o comando php -i e verificar se alguma mensagem de erro é informada antes ou no lugar da tabela de informações. Esteja ciente de que ao usar o modo CGI a saída será em HTML e portanto bastante longa. |
| -l | --syntax-check |
Fornece uma forma conveniente de realizar uma verificação da sintaxe no código PHP informado. Em caso de sucesso, o texto No syntax errors detected in <filename> é disparado para a saída padrão da linha de comando e o código de retorno é 0. Em caso de falha, o texto Errors parsing <filename> assim como as mensagens adicionais de erros são retornados para a saída padrão do terminal e o código retornado é -1. Isso não irá encontrar error fatais (como funções não definidas). Use a opção -f para também testar os erros fatais.
|
| -m | --modules |
Exemplo #1 Retorna os módulos PHP e Zend embutidos e carregados $ php -m [PHP Modules] xml tokenizer standard session posix pcre overload mysql mbstring ctype [Zend Modules] |
| -r | --run |
Habilita a execução do código PHP incluído diretamente na linha de comando. As tags de abertura e fechamento do PHP (<?php e ?>) não são necessárias e irão causar um erro de leitura caso sejam incluidas.
|
| -B | --process-begin |
O código PHP executado antes do processamento do stdin. Incluído na versão 5 do PHP. |
| -R | --process-code |
Código PHP para ser executado a cada linha de entrada. Incluído na versão 5 do PHP. Existem duas variáveis especiais disponíveis nesse modo: $argn e $argi. $argn conterá a linha que está sendo processada pelo PHP no momento, enquanto $argi irá conter o número da linha. |
| -F | --process-file |
Arquivo PHP para ser executado a cada linha de entrada. Incluído na versão 5 do PHP. |
| -E | --process-end |
Código PHP para ser executado após o processamento da entrada. Incluído na versão 5 do PHP. Exemplo #4 Usando as opções -B , -R e -E para contar o número de linhas de um projeto. $ find my_proj | php -B '$l=0;' -R '$l += count(@file($argn));' -E 'echo "Total Lines: $l\n";' Total Lines: 37328 |
| -S | --server |
Inicia o servidor embutido do PHP. Disponível a partir da versão 5.4.0 do PHP. |
| -t | --docroot | Específica a raiz do documento para o servidor embutido do PHP. Disponível a partir da versão 5.4.0 do PHP. |
| -s | --syntax-highlight and --syntax-highlighting |
Destaca a sintaxe de código (syntax-highlighting). Essa opção usa os mecanismos internos para interpretar os arquivos e escrever uma versão HTML colorida do código para a saída padrão. Repare que tudo que ele faz é gerar um bloco de tags HTML <code> [...] </code>, sem os cabeçalhos HTML.
|
| -v | --version |
Exemplo #5 Use -v para requisitar o nome SAPI e a versão do PHP e Zend Engine $ php -v PHP 5.3.1 (cli) (built: Dec 11 2009 19:55:07) Copyright (c) 1997-2009 The PHP Group Zend Engine v2.3.0, Copyright (c) 1998-2009 Zend Technologies |
| -w | --strip |
Exibe o código com comentários e espaços em branco removidos.
|
| -z | --zend-extension |
Carrega uma extensão Zend. Se somente um nome de arquivo for fornecido, O PHP irá tentar carregar essa extensão a partir do diretório padrão de extensões do seu sistema, (geralmente /etc/ld.so.conf em sistemas linux, por exemplo). Ao passar o nome do arquivo juntamente com seu caminho absoluto não usará o diretório padrão de extensões. Um caminho relativo incluindo informações de diretórios dirá ao PHP para tentar carregar a extensão relativamente ao diretório atual. |
| --ini |
Exibir nomes de arquivos de configuração e diretórios verificados. Disponível a partir da versão 5.2.3 do PHP. Exemplo #6 --ini exemplo $ php --ini Configuration File (php.ini) Path: /usr/dev/php/5.2/lib Loaded Configuration File: /usr/dev/php/5.2/lib/php.ini Scan for additional .ini files in: (none) Additional .ini files parsed: (none) |
|
| --rf | --rfunction |
Exibe informações sobre a função ou método de objeto informado (como por exemplo o número e nome dos parâmetros). Disponível a partir da versão 5.1.2 do PHP. Essa opção só está disponível se o PHP for compilado com suporte a Reflexão.
Exemplo #7 uso básico da opção --rf $ php --rf var_dump
Function [ <internal> public function var_dump ] {
- Parameters [2] {
Parameter #0 [ <required> $var ]
Parameter #1 [ <optional> $... ]
}
}
|
| --rc | --rclass |
Exibe informações sobre uma determinada classe (lista de constantes, propriedades e métodos). Disponível a partir da versão 5.1.2 do PHP. Essa opção só está disponível se o PHP for compilado com suporte a Reflexão.
Exemplo #8 exemplo de --rc $ php --rc Directory
Class [ <internal:standard> class Directory ] {
- Constants [0] {
}
- Static properties [0] {
}
- Static methods [0] {
}
- Properties [0] {
}
- Methods [3] {
Method [ <internal> public method close ] {
}
Method [ <internal> public method rewind ] {
}
Method [ <internal> public method read ] {
}
}
}
|
| --re | --rextension |
Exibe informações sobre uma determinada extensão (lista de opções do php.ini, funcões definidas, constantes e classes. Disponível a partir da versão 5.1.2 do PHP. Essa opção só está disponível se o PHP for compilado com suporte a Reflexão.
Exemplo #9 Exemplo de --re $ php --re json
Extension [ <persistent> extension #19 json version 1.2.1 ] {
- Functions {
Function [ <internal> function json_encode ] {
}
Function [ <internal> function json_decode ] {
}
}
}
|
| --rz | --rzendextension |
Exibe as informações de configuração de uma determinada extensão Zend (a mesma informação retornada pela phpinfo()). Disponível a partir da versão 5.4 do PHP. |
| --ri | --rextinfo |
Exibe as informações de configuração de uma determinada extensão (as mesmas informações retornadas pela phpinfo()). Disponível a partir do PHP 5.2.2. As informações de configurações do núcleo da linguagem estão disponíveis usando "main" como nome da extensão.
Exemplo #10 exemplo de --ri $ php --ri date date date/time support => enabled "Olson" Timezone Database Version => 2009.20 Timezone Database => internal Default timezone => Europe/Oslo Directive => Local Value => Master Value date.timezone => Europe/Oslo => Europe/Oslo date.default_latitude => 59.930972 => 59.930972 date.default_longitude => 10.776699 => 10.776699 date.sunset_zenith => 90.583333 => 90.583333 date.sunrise_zenith => 90.583333 => 90.583333 |
Nota:
As opções -rBRFEH, --ini e --r[fcezi] estão disponíveis somente no CLI.