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 and --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.