LXXXII. PHP Opções e Informações

Introdução

Estas funções permitem a você obter muitas informações sobre o PHP em si, ex. Configurações em tempo de execução, extensões carregadas, versão e muito mais. Você também encontrará funções para definir opções durante a execução. A provavelmente mais conhecida função do PHP - phpinfo() - pode ser encontrada aqui.

Requisitos

Nenhuma biblioteca externa é necessária para compilar esta extensão.

Instalação

Não há nenhuma instalação necessária para utilizar estas funções, elas fazem parte do núcleo do PHP.

Configuração durante execução

O comportamento dessas funções podem ser modificado pelas configurações do php.ini.

Tabela 1. PHP opções e informações de configuração

NomePadrãoModificável
assert.active"1"PHP_INI_ALL
assert.bail"0"PHP_INI_ALL
assert.warning"1"PHP_INI_ALL
assert.callbackNULLPHP_INI_ALL
assert.quiet_eval"0"PHP_INI_ALL
enable_dl"1"PHP_INI_SYSTEM
max_execution_time"30"PHP_INI_ALL
magic_quotes_gpc"1"PHP_INI_PERDIR|PHP_INI_SYSTEM
magic_quotes_runtime"0"PHP_INI_ALL
Para maiores detalhes e definição das constantes PHP_INI_* veja ini_set().

Breve descrição das diretivas de configuração.

assert.active boolean

Ativa a comparação assert().

assert.bail boolean

Termina a execução do script no caso de uma afirmação(assert) falhar.

assert.warning boolean

Mostra um aviso PHP para cada afirmação(assert) que falhar.

assert.callback string

Função do usuário a ser executado no caso de uma afirmação(assert) falhar.

assert.quiet_eval boolean

Usa o que esta definido atualmente para a função error_reporting() durante a avaliação da afirmação. Se ativado, não são mostrados erros (error_reporting(0) implícito) durante a avaliação. Se desativado, os erros são mostrados de acordo com as definições de error_reporting()

enable_dl boolean

Esta diretiva somente é realmente útil na versão do PHP como módulo do apache. Você pode mudar o carregamento dinâmico de extensões do PHP com dl() on e off para cada servidor virtual ou por diretório.

A principal razão para mudar o carregamento dinâmico para off é segurança. Com o carregamento dinâmico é possível ignorar todas as restrições de open_basedir. O padrão é permitir o carregamento dinâmico exceto quando usando o safe mode. No safe mode, é sempre impossível usar dl().

max_execution_time integer

Isto define o limite de tempo de execução de um script antes que seja terminado pelo interpretador. Isto ajuda a prevenir que scripts mal escritos serem executados indefinidamente pelo servidor. O padrão é 30.

O limite de tempo de execução não é afetado por chamadas do sistema, a função sleep(), etc. Por favor veja a função set_time_limit() para maiores detalhes.

Você não pode mudar esta definição com a função ini_set() quando estiver executando em safe mode. O único meio de contornar é desativar o safe mode ou mudar o limite de tempo no php.ini.

magic_quotes_gpc boolean

Define o estado para as aspas mágicas para operações GPC (Get/Post/Cookie). Quando as aspas mágicas estiverem em on, todas ' (aspas simples), " (aspas duplas), \ (barras invertidas) e NULL's são escapados com uma barra invertida automaticamente.

Nota: Se a diretiva magic_quotes_sybase também estiver em ON ela irá sobrescrever completamente magic_quotes_gpc. Tendo ambas diretivas ativadas faz com que apenas as aspas simples sejam escapadas como ''. Aspas duplas, barras invertidas e NULL's irão permanecer intocados e não escapados.

Veja também get_magic_quotes_gpc().

magic_quotes_runtime boolean

Se magic_quotes_runtime estiver ativado, a maioria das funções que retornarem dados de qualquer fonte externa incluindo banco de dados e arquivos de texto terão as aspas escapadas com uma barra invertida. Se magic_quotes_sybase também estiver em on, uma aspa simples é escapada com uma aspa simples ao invés de uma barra invertida.

Tipos Resource

Esta extensão não possui nenhum tipo resource.

Constantes Predefinidas

As constantes listadas abaixo estão sempre disponíveis como parte do núcleo do PHP.

Tabela 2. Constantes phpcredits() predefinidas

ConstanteValorDescrição
CREDITS_GROUP1Uma lista do núcleo de desenvolvedores
CREDITS_GENERAL2 Créditos em geral: design e conceito da linguagem, autores do PHP 4.0 e do módulo SAPI.
CREDITS_SAPI4 Uma lista dos módulos API dos servidores para o PHP, e seus autores.
CREDITS_MODULES8 Uma lista dos módulos de extensão para o PHP, e seus autores.
CREDITS_DOCS16 Os créditos para a equipe de documentação.
CREDITS_FULLPAGE32 Normalmente usada em combinação com as outras opções. Indica que uma pagina HTML completa precisa ser mostrada incluindo a informação indicada pelas outras opções.
CREDITS_QA64 Os créditos para a equipe de controle de qualidade.
CREDITS_ALL-1 Todos os créditos, equivalente a usar: CREDITS_DOCS + CREDITS_GENERAL + CREDITS_GROUP + CREDITS_MODULES + CREDITS_QA CREDITS_FULLPAGE. Gera uma pagina HTML completa com as tags apropriadas. Este é o valor padrão.

Tabela 3. Constantes da função phpinfo()

ConstanteValorDescrição
INFO_GENERAL1 A linha da configuração, localização do php.ini, data de construção, servidor web, sistema e mais.
INFO_CREDITS2 Créditos do PHP 4. Veja também phpcredits().
INFO_CONFIGURATION4 Valores atuais e principais para as diretivas de configuração do PHP. Veja também ini_get().
INFO_MODULES8 Módulos carregados e suas respectivas configurações.
INFO_ENVIRONMENT16 Informações das variáveis de ambiente que também estão disponíveis em $_ENV.
INFO_VARIABLES32 Mostra todas as variáveis predefinidas a partir de EGPCS (Ambiente, GET, POST, Cookie, Server).
INFO_LICENSE64 Informação sobre a licença do PHP. Veja também a faq sobre licença.
INFO_ALL-1 Mostra tudo acima. Este é o valor padrão.

ASSERT_ACTIVE (integer)

ASSERT_CALLBACK (integer)

ASSERT_BAIL (integer)

ASSERT_WARNING (integer)

ASSERT_QUIET_EVAL (integer)

Índice
assert_options -- Define/Obtém várias opções do assert
assert -- Confere se uma afirmação é FALSE
dl -- Carrega uma extensão do PHP durante a execução
extension_loaded -- Indica quando uma extensão esta carregada
get_cfg_var --  Obtém o valor de uma opção de configuração do PHP
get_current_user --  Obtém o nome do dono do script PHP atual
get_defined_constants --  Retorna uma matriz associativa com os nomes de todas as constantes e seus valores
get_extension_funcs --  Retorna uma matriz com os nomes de funções de um módulo
get_include_path --  Obtém a opção de configuração include_path atual
get_included_files --  Retorna uma matriz com os nomes dos arquivos incluídos ou requeridos
get_loaded_extensions --  Retorna uma matriz com os nomes de todos os módulos compilados e carregados
get_magic_quotes_gpc --  Obtém a configuração atual de magic quotes gpc
get_magic_quotes_runtime --  Obtém a configuração ativa para magic_quotes_runtime
get_required_files -- Apelido para get_included_files()
getenv -- Obtém uma variável de ambiente
getlastmod -- Obtém o tempo da última modificação na pagina
getmygid -- Obtém o GID do dono do script PHP
getmyinode -- Obtém o inode do script atual
getmypid -- Obtém o ID do processo PHP
getmyuid -- Obtém o UID do dono do script PHP
getopt -- Obtém opções da lista de argumentos da linha de comando
getrusage -- Obtém a utilização de recursos
ini_alter -- Apelido para ini_set()
ini_get_all -- Obtém todas as opções de configuração
ini_get -- Obtém o valor de uma opção de configuração
ini_restore -- Restaura o valor de uma opção de configuração
ini_set -- Define o valor de uma opção de configuração
main -- Marcador para main()
memory_get_usage -- Retorna a quantidade de memória alocada para PHP
php_ini_scanned_files -- Retorna uma lista dos arquivos ini interpretados a partir do diretório ini adicional
php_logo_guid -- Obtém o guid do logo
php_sapi_name --  Retorna o tipo de interface entre o servidor web e o PHP
php_uname --  Retorna informação sobre o sistema operacional que o PHP foi construído
phpcredits -- Mostra os créditos pelo PHP
phpinfo -- Mostra muitas informações sobre o PHP
phpversion -- Obtém a versão atual do PHP
putenv -- Define o valor de uma variável de ambiente
restore_include_path --  Restaura o valor da opção de configuração include_path
set_include_path --  Define a opção de configuração include_path
set_magic_quotes_runtime --  Define a configuração atual para magic_quotes_runtime
set_time_limit -- Limita o tempo de execução do script
version_compare --  Compares two "PHP-standardized" version number strings
zend_logo_guid -- Retorna o guid zend
zend_version -- Obtém a versão da Zend engine que esta sendo executada