Diretivas de configuração

Opções Httpd

Tabela 4-2 . Opções Httpd

Nome Padrão Alterável


Opções da Linguagem

Tabela 4-3 . Opções gerais da linguagem

Nome Padrão Alterável


Descrição resumida das diretivas de configuração .

short_open_tag boolean

Informa quando a tag reduzida ( ? ? ) do PHP pode ser permitida . Se você quiser usar o PHP em combinação com XML , você pode desligar essa opção para poder utilizar ?xml ? inline . De outra forma , você pode imprimir com o PHP , por exemplo : ?php echo ' ?xml version="1.0"' ; ? . Se desligado , você precisará utilizar a forma longa da tag de abertura do PHP ( ?php ? ) .

Nota : Esta diretiva também afeta o atalho ?= , que é idêntico a ? echo . A utilização desse atalho requer short_open_tag ligado .

asp_tags boolean

Ativa a utilização das tags estilo ASP % % em adição as tags ?php ? . Isto inclui o atalho de impressão de valores %= $var % . Para mais informações , veja Alternando do HTML .

Nota : O suporte a tags estilo APS foi acrescentado no 3.0.4 .

precision integer

O número de dígitos significantes exibidos em números de ponto flutuante .

y2k_compliance boolean

Força a especificação Ano 2002 ( poderá causar problemas com browsers não compatíveis )

allow_call_time_pass_reference boolean

Especifica a habilidade em forçar que argumentos possam ser passados por referência na chamada de uma função . Este método é obsoleto e logo não será mais suportado nas futuras versões do PHP / Zend . O método recomendado para especificar que argumentos devem ser passados por referência é pela declaração da função . Você é encorajado em tentar desligar essa opção e verificar se seus scripts trabalham adequadamente de forma a garantir que elas irã funcionar nas futuras versões da linguagem ( você receberá um alerta cada vez que utilizar esse recurso , e o argumento será passado por valor em vez de por referência ) .

Veja também Referências Explicadas .

expose_php boolean

Decide se o PHP poderá expor o fato de que ele está instalado no servidor ( acrescentando sua assinatura no header do servidor web ) . Isto não causa problemas de segurança de qualquer forma , mas torna possível determinar se você usa o PHP em seu servidor ou não .



Limitação de recursos

Tabela 4-4 . Limitação de recursos

Nome Padrão Alterável


Descrição resumida das diretivas de configuração .

memory_limit integer

Isto configura a quantidade máxima de memória , em bytes , que um script poderá alocar . Isto ajuda a prevenir que scripts mal escritos acabem com toda a memória disponível do servidor .



Veja também max_execution_time .

Manipulação de dados

Tabela 4-5 . Opções configuráveis para manipulação de dados

Nome Padrão Alterável


Descrição resumida das diretivas de configuração .

track_vars boolean

Se ativado , quaisquer variáveis Environment , GET , POST , Cookie e Server encontradas poderão ser acessadas nos arrays globais associativos $_ENV , $_GET , $_POST , $_COOKIE e $_SERVER .

Note que a partir do PHP 4.0.3 , track_vars está sempre ativado .

arg_separator.output string

O separador de parâmetros em URLs geradas pelo PHP .

arg_separator.input string

Lista dos separador( es ) utilizados pelo PHP para interpretar URLs em variáveis .

Nota : Cada caracter nesta diretiva é considerado como um separador !

variables_order string

Configura a ordem de interpretação das variáveis EGPCS ( Environment , GET , POST , Cookie e Server ) . O default dessa diretiva é " EGPCS " . Configurando para " GP" , por exemplo , fará com que o PHP ignore completamente variáveis de ambiente (E) , cookies (C ) e do servidor (S ) , sendo que qualquer variável GET será sobrescrita por qualquer variável do método POST com o mesmo nome .

Veja também register_globals .

register_globals boolean

Ativa ou não o registro de variáveis EGPCS ( Environment , GET , POST , Cookie e Server ) como variáveis globais . Por exemplo : se register_globals = on , a URL http : / /www.example.com / test.php?id=3 irá criar a variável $id . Ou , $DOCUMENT_ROOT de $_SERVER[ 'DOCUMENT_ROOT' ] . Você pode desligar essa diretiva se você não deseja sujar o escopo global de seus scripts com dados do usuário . Desde o PHP 4.2.0 , o padrão dessa diretiva é off . É preferível utilizar as variáveis predefinidas do PHP , como as superglobals : $_ENV , $_GET , $_POST , $_COOKIE e $_SERVER . Leia cuidadosamente o capitulo de segurança em Utilizando register_globals para mais informações .

Veja que register_globals não pode ser alterado em tempo de execução ( ini_set( ) ) . Entretanto , você pode utilizar o .htaccess Entretanto , você pode utilizar o .htaccess se seu host permitir como descrito anteriormente . Um exemplo de entrada do .htaccess : php_flag register_globals on .

Nota: register_globals é afetada pela diretiva variables_order .

register_argc_argv boolean

Configura quando o PHP deve declarar ou não as variáveis argv e argc ( que podem conter dados do método GET ) .

Veja também Utilizando o PHP em linha de comando . Além , essa diretiva foi criada no PHP 4.0.0 e sempre foi " ativa " antes disso .

post_max_size integer

Configura o tamanho máximo dos dados postados . Esta configuração também afeta o upload de arquivos . Para receber arquivos grandes , esse valor precisa ser maior que upload_max_filesize .

Se o limite de memória estiver ativado em seu script de configuração , memory_limit também afeta o upload de arquivos . Falando diretamente , memory_limit precisa ser maior que post_max_size .

gpc_order string

Informa a ordem de interpretação das variáveis GET / POST / COOKIE . O padrão dessa diretiva é " GPC " . Configurando para " GP " , por exemplo , fará com que o PHP ignore completamente cookies e que sobrescreva qualquer dado postado via GET por variáveis postados via POST que tenham o mesmo nome .

Nota : Esta opção não está disponível no PHP 4 . Utilize variables_order no seu lugar .

auto_prepend_file string

Especifica o nome do arquivo que será automaticamente interpretado antes do arquivo principal . O arquivo é incluído como se ele fosse chamado com a função include( ) , então include_path é utilizado .

O valor especial none desabilita a auto inclusão .

auto_append_file string

Especifica se o nome do arquivo que será automaticamente interpretado depois do arquivo principal . O arquivo é incluído como se ele fosse chamada a função include( ) , então include_path é utilizado .

O valor especial none desabilita a auto inclusão .

Nota : Se o script é terminado com exit( ) , a auto inclusão não irá ocorrer .



default_mimetype string

default_charset string

A partir da versão 4.0b4 , o PHP sempre emite a codificação de caracter por padrão no header Content-type: . Para desabilitar o envio do código de página , simplesmente deixe a diretiva em branco .

always_populate_raw_post_data boolean

Sempre preenche a variável $HTTP_RAW_POST_DATA .

allow_webdav_methods boolean

Permite a manipulação de headers HTTP com scripts PHP ( com PROPFIND , PROPPATCH , MOVE , COPY , etc ) . Se você quiser obter os dados postados dessas requisições , ative always_populate_raw_post_data para isso .



Veja também magic_quotes_gpc , magic-quotes-runtime , e magic_quotes_sybase .

Paths and Directories

Tabela 4-6 . Opções de configuração de caminhos e diretórios

Nome Padrão Alterável


Descrição resumida das diretivas de configuração .

include_path string

Especifica a lista de diretórios onde as funções require( ) , include( ) and fopen_with_path( ) procurarão por arquivos . O formato é o mesmo que o da variável ambiente PATH : uma lista de diretórios , separador por vírgula no UNIX ou ponto e vírgula no Windows .

Exemplo 4-3 . include_path UNIX

 
include_path=.

 
:

 
/

 
home

 
/

 
httpd

 
/

 
php-lib



Exemplo 4-4 . include_path Windows

 
include_path="

 
.;c:\www\phplib

 
"



O default dessa diretiva é . (somente o diretório atual).

doc_root string

O " diretório root " do PHP no servidor . Utilizado somente se for preenchido . Se o PHP estiver configurado com safe mode , nenhum arquivo acima desse diretório será acessível . Se o PHP não estiver compilado com FORCE_REDIRECT , você DEVE configurar doc_root se estiver rodando o PHP como CGI sob qualquer servidor web ( que não o IIS ) Outra alternativa é configurar a diretiva cgi.force_redirect , abaixo .

user_dir string

O caminho base do usado como diretório home do usuário para arquivos PHP , por exemplo public_html .

extension_dir string

Diretório de onde o PHP poderá carregar dinamicamente as extensões . Veja também enable_dl e dl( ) .

extension string

Que extensões dinamicamente carregáveis devem ser carregadas quando o PHP inicia .

cgi.force_redirect boolean

cgi.force_redirect é necessário para prover segurança quando rodando o PHP como módulo sob a maioria dos servidores web . Se deixado indefinido , o PHP assume como ativo . Você pode desligá-lo SOB SEU RISCO .

Nota : Usuários Windows : Você PODE desligar isso no ISS , e de fato , você DEVE fazê-lo . Para que o OmniHTTPD ou Xitami funcionem , você PRECISA desligá-lo .

cgi.cgi.redirect_status_env string

Se cgi.force_redirect estiver ativado , e se não estiver rodando o PHP sob os servidores web Apache ou Netscape ( iPlanet ) , você PRECISARÁ configurar uma variável de ambiente que o PHP procurará para saber se ele pode continuar a execução .

Nota : Configurar essa variável PODERÁ causar problemas de segurança , POR ISSO SAIBA QUE ESTEJA FAZENDO PRIMEIRO .

fastcgi.impersonate string

FastCGI sob o IIS ( em sistemas baseados em WinNT ) suporta a habilidade de despersonalizar tokens de segurança da chamado do cliente . Isto permite ao ISS definir o contexto de segurança da requisição que está rodando . mod_fastcgi sob o Apache ainda não suporta esse recurso ( 17 / 03 / 2002 ) . Configure 1 se estiver rodando sob o ISS . O padrão é zero .



Upload de arquivos

Tabela 4-7 . Opções de configuração para upload de arquivos

Nome Padrão Alterável


Descrição resumida das diretivas de configuração .

file_uploads boolean

Permite ou não upload de arquivos HTTP . Veja também upload_max_filesize , upload_tmp_dir e post_max_size directives .

upload_tmp_dir string

O diretório temporário utilizado para armazenar arquivos quando realizando o upload de arquivos . Ele precisa ter permissão de escrita para qualquer usuário que for rodar o PHP . Se não especificado , o PHP utilizará o default do sistema .

upload_max_filesize integer

O tamanho máximo de um arquivo para upload .



SQL Geral

Tabela 4-8 . Opções de configuração SQL gerais

Nome Padrão Alterável


Descrição resumida das diretivas de configuração .

sql.safe_mode boolean



Diretivas de configuração do debugador

debugger.host string

Nome DNS ou endereço IP do host utilizado pelo debugador .

debugger.port string

Porta utilizado pelo debugador .

debugger.enabled boolean

Controle de ativação do debugador .