Configurações do PHP

Introdução

PHP é uma linguagem interpretada que permite que sejam configuradas várias diretivas, tanto do core da linguagem quanto das suas extensões. A lista com todas as diretivas da linguagem são mostradas no manual.

Cada diretiva possui um "modo de mudança", que define onde e quando ela pode ser modificada. Por exemplo, algumas só podem ser definidas no arquivo de configurações gerenciado pelo administrador do servidor, por questões de segurança, enquanto outras podem ser alteradas pelo programador na própria aplicação.

Os modos de mudança das diretivas são:

• PHP_INI_USER - Pode ser modificada com a função ini_set, arquivo .user.ini ou no Registro do Windows.
• PHP_INI_PERDIR - Pode ser modificada no arquivo php.ini, .htaccess, httpd.conf ou .user.ini.
• PHP_INI_SYSTEM - Pode ser modificada no arquivo php.ini ou httpd.conf.
• PHP_INI_ALL - Pode ser modificada em qualquer lugar.

Observação: algumas diretivas pertenciam a um modo de mudança até determinada versão do PHP, mas mudaram para outro modo em outra versão do PHP. Estas informações são apresentadas na lista de diretivas da linguagem.

---

Arquivos de configuração (php.ini)

As configurações padrão do PHP são definidas em arquivos "ini", que possuem a sintaxe bem simples baseada em chave/valor. Elas são carregadas assim que um script inicia a execução, mas os valores podem ser guardados em cache e re-carregados periodicamente por questões de performance.

O nome do arquivo pode variar de acordo com a sapi utilizada. Por exemplo, o arquivo padrão é o php.ini, mas se você executa a sapi CLI (PHP no terminal de comandos), é procurado o arquivo php-cli.ini e, caso este não seja encontrado, usa-se o arquivo padrão.

Estes arquivos ficam num diretório de configurações do servidor (no Linux normalmente ficam no diretório "/etc/", embora este local possa ser modificado durante a compilação do PHP ou com algumas alternativas, embora não seja comum). Normalmente apenas o administrador do servidor tem acesso a estes arquivos para mudanças, por questões de segurança. Isso é especialmente útil em servidores de provedores de hospedagem, em que os scripts de um domínio não podem interferir nos de outro.

Configurações pelo Programador

Existem basicamente 3 formas do programador sobrescrever as configurações do PHP: através da função ini_set (em tempo de execução), do arquivo .htaccess (caso use servidor Apache) ou do arquivo .user.ini (uma alternativa criada no PHP 5.3). Note que, nestes casos, o comportamento é modificado especificamente para um script ou conjunto de scripts e não a todos os arquivos PHP, como ocorre com o arquivo php.ini.

---

Usando a função ini_set, basta especificar dois parâmetros: o primeiro é o nome da diretiva e o segundo é o valor que deseja aplicar a ela (na forma de string). Para obter o valor atual da diretiva, existe a função ini_get (basta informar o nome da diretiva). Para obter o valor de todas diretivas, ou de todas diretivas de uma extensão, existe a função ini_get_all. E para retornar o valor da diretiva para o seu valor inicial (quando iniciou o script), basta usar a função ini_restore informando qual diretiva deve ser restaurada. Exemplo:

ini_set('memory_limit', '128M');
ini_set('display_errors', '0');

---

Usar o arquivo .htaccess é permitido para servidores Apache em que o PHP esteja sendo usado como módulo. O Apache precisa estar devidamente configurados para aceitar este tipo de arquivo no diretório da aplicação. Neste caso, uma diretiva pode ser definida utilizando duas sintaxes. Uma para definir valores não booleanos e outra para definir valores booleanos (que podem assumir "on" ou "off"), conforme os exemplos:

php_value memory_limit 128M
php_flag display_errors off

Observação: no arquivo httpd.conf as diretivas podem ser modificadas com php_admin_value e php_admin_flag. Isso pode ser útil para aplicar configurações diferentes para diretórios diferentes (ou hosts virtuais diferentes).

---

Usar o arquivo .user.ini é uma alternativa para o arquivo .htaccess, e foi incorporado ao PHP na versão 5.3. Por enquanto, ele só pode ser usado pelas sapis CGI ou Fast CGI. A sintaxe usada nestes arquivos é idêntica a usada no arquivo php.ini.

O nome do arquivo usado para este tipo de configuração (".user.ini") pode ser modificado no arquivo php.ini através da diretiva user_ini.filename. Isso normalmente é necessário quando a aplicação já utiliza este nome para outra finalidade.

Observação: recomenda-se esconder o acesso a este arquivo, assim como (normalmente) é feito com o .htaccess para prevenir que ele possa ser lido por qualquer usuário que acessa o sistema.

---

Configurações úteis de se conhecer

• display_errors e display_startup_errors - Indica se os erros devem ser exibidos ou omitidos (normalmente "on" no ambiente de desenvolvimento e "off" no ambiente de produção).
• log_errors - Indica se os erros devem ser registrados em um arquivo de log (normalmente "off", quando "display_errors" está "on", e vice-versa).
• report_memleaks - Indica se os estouros de memória devem ser mostrados/registrados em log (normalmente "on").
• memory_limit - Quantidade de memória reservada para o PHP durante a execução do script. Normalmente um script simples não precisa de mais de 10M, mas alguns exigem muito mais que isso. A diretiva deve ser configurada com um valor razoável para a aplicação e expandida, em casos de ferramentas que exigem mais memória. Para avaliar o uso de memória, veja as funções memory_get_peak_usage e memory_get_usage.
• max_execution_time - Define o tempo máximo que o script pode ser executado antes de ser abortado automaticamente pelo PHP (normalmente "30", mas pode ser configurado com valores maiores para ferramentas mais pesadas).
• precision - Define a precisão de casas decimais para números reais (normalmente 14).
• date.timezone - Define o timezone padrão da aplicação (por exemplo "America/Sao_Paulo")
• default_mimetype - Define o mimetype dos arquivos gerados pelo PHP que não deixaram explícitos com a chamada à header('Content-type: ...') (por exemplo: "text/html" ou "application/xhtml+xml").
• default_charset - Define o charset padrão dos arquivos gerados pelo PHP que não deixaram explícitos com a chamada à header('Content-type: ...; charset=...').
• short_open_tag - Define se a aplicação aceitará a notação abreviada de tags PHP: "<?" e "?>" (recomenda-se "on" apenas em aplicações fechadas, cuja portabilidade não é importante).
• aps_tags - Define se a aplicação aceitará a notação ASP para tags PHP "<%" e "%>" (recomenda-se "on" apenas em aplicações fechadas, cuja portabilidade não é importante).
• register_globals - Define se a aplicação criará variáveis globais para valores oriundos de EGPCS (Environment, GET, POST, Cookies e Server). Recomenda-se fortemente usar "off", pois é um recurso depreciado e que torna a aplicação mais propícia a falhas de segurança.
• magic_quotes_runtime e magic_quotes_gpc - Define se será aplicada a função addslashes automaticamente sobre os dados submetidos. Recomenda-se fortemente usar "off", pois é um recurso depreciado e que caracteriza um comportamento inconveniente.
• arg_separator.output - Separador padrão usado por funções do PHP que constroem URL. Recomenda-se "&amp;", especialmente para aplicações XHTML).
• session.auto_start - Iniciar a sessão automaticamente (normalmente "off")
• session.use_cookies - Indica se as sessões podem usar cookies para guardar as chaves de sessão (recomenda-se "on").
• session.use_only_cookies - Indica se as sessões só podem usar cookies para trafegar as chaves de sessão, ao invés de informá-las via GET (recomenda-se fortemente "on", por questões de segurança).
• session.use_trans_sid - Indica se as sessões podem usar o mecanismo de "transparent sid" para trafegar as chaves de sessão (dados passados por GET) (recomenda-se fortemente "off", por questões de segurança).