Files
2025-05-28 11:57:07 -03:00

519 lines
20 KiB
XML
Raw Permalink Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d4d5216e7a965ca194f6b1c9dee84cecab2674e5 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<section xml:id="wincache.configuration" xmlns="http://docbook.org/ns/docbook">
&reftitle.runtime;
&extension.runtime;
<para>
A tabela a seguir lista e explica as configurações
fornecidas pela extensão WinCache:
</para>
<para>
<table>
<title>Opções de configuração do WinCache</title>
<tgroup cols="6">
<thead>
<row>
<entry>&Name;</entry>
<entry>&Default;</entry>
<entry>Mínimo</entry>
<entry>Máximo</entry>
<entry>&Changeable;</entry>
<entry>&Changelog;</entry>
</row>
</thead>
<tbody>
<row>
<entry><link linkend="ini.wincache.fcenabled">wincache.fcenabled</link></entry>
<entry>"1"</entry>
<entry>"0"</entry>
<entry>"1"</entry>
<entry><constant>INI_ALL</constant></entry>
<entry>Disponível a partir do WinCache 1.0.0</entry>
</row>
<row>
<entry><link linkend="ini.wincache.fcenabledfilter">wincache.fcenabledfilter</link></entry>
<entry>"NULL"</entry>
<entry>"NULL"</entry>
<entry>"NULL"</entry>
<entry><constant>INI_SYSTEM</constant></entry>
<entry>Disponível a partir do WinCache 1.0.0</entry>
</row>
<row>
<entry><link linkend="ini.wincache.fcachesize">wincache.fcachesize</link></entry>
<entry>"24"</entry>
<entry>"5"</entry>
<entry>"255"</entry>
<entry><constant>INI_SYSTEM</constant></entry>
<entry>Disponível a partir do WinCache 1.0.0</entry>
</row>
<row>
<entry><link linkend="ini.wincache.fcndetect">wincache.fcndetect</link></entry>
<entry>"1"</entry>
<entry>"0"</entry>
<entry>"1"</entry>
<entry><constant>INI_SYSTEM</constant></entry>
<entry>Disponível a partir do WinCache 1.1.0</entry>
</row>
<row>
<entry><link linkend="ini.wincache.maxfilesize">wincache.maxfilesize</link></entry>
<entry>"256"</entry>
<entry>"10"</entry>
<entry>"2048"</entry>
<entry><constant>INI_SYSTEM</constant></entry>
<entry>Disponível a partir do WinCache 1.0.0</entry>
</row>
<row>
<entry><link linkend="ini.wincache.ocenabled">wincache.ocenabled</link></entry>
<entry>"1"</entry>
<entry>"0"</entry>
<entry>"1"</entry>
<entry><constant>INI_ALL</constant></entry>
<entry>Disponível a partir do WinCache 1.0.0. Removida a partir do 2.0.0.0</entry>
</row>
<row>
<entry><link linkend="ini.wincache.ocenabledfilter">wincache.ocenabledfilter</link></entry>
<entry>"NULL"</entry>
<entry>"NULL"</entry>
<entry>"NULL"</entry>
<entry><constant>INI_SYSTEM</constant></entry>
<entry>Disponível a partir do WinCache 1.0.0. Removida a partir do 2.0.0.0</entry>
</row>
<row>
<entry><link linkend="ini.wincache.ocachesize">wincache.ocachesize</link></entry>
<entry>"96"</entry>
<entry>"15"</entry>
<entry>"255"</entry>
<entry><constant>INI_SYSTEM</constant></entry>
<entry>Disponível a partir do WinCache 1.0.0. Removida a partir do 2.0.0.0</entry>
</row>
<row>
<entry><link linkend="ini.wincache.filecount">wincache.filecount</link></entry>
<entry>"4096"</entry>
<entry>"1024"</entry>
<entry>"16384"</entry>
<entry><constant>INI_SYSTEM</constant></entry>
<entry>Disponível a partir do WinCache 1.0.0</entry>
</row>
<row>
<entry><link linkend="ini.wincache.chkinterval">wincache.chkinterval</link></entry>
<entry>"30"</entry>
<entry>"0"</entry>
<entry>"300"</entry>
<entry><constant>INI_SYSTEM</constant></entry>
<entry>Disponível a partir do WinCache 1.0.0</entry>
</row>
<row>
<entry><link linkend="ini.wincache.ttlmax">wincache.ttlmax</link></entry>
<entry>"1200"</entry>
<entry>"0"</entry>
<entry>"7200"</entry>
<entry><constant>INI_SYSTEM</constant></entry>
<entry>Disponível a partir do WinCache 1.0.0</entry>
</row>
<row>
<entry><link linkend="ini.wincache.enablecli">wincache.enablecli</link></entry>
<entry>0</entry>
<entry>0</entry>
<entry>1</entry>
<entry><constant>INI_SYSTEM</constant></entry>
<entry>Disponível a partir do WinCache 1.0.0</entry>
</row>
<row>
<entry><link linkend="ini.wincache.ignorelist">wincache.ignorelist</link></entry>
<entry>NULL</entry>
<entry>NULL</entry>
<entry>NULL</entry>
<entry><constant>INI_ALL</constant></entry>
<entry>Disponível a partir do WinCache 1.0.0</entry>
</row>
<row>
<entry><link linkend="ini.wincache.namesalt">wincache.namesalt</link></entry>
<entry>NULL</entry>
<entry>NULL</entry>
<entry>NULL</entry>
<entry><constant>INI_SYSTEM</constant></entry>
<entry>Disponível a partir do WinCache 1.0.0</entry>
</row>
<row>
<entry><link linkend="ini.wincache.ucenabled">wincache.ucenabled</link></entry>
<entry>1</entry>
<entry>0</entry>
<entry>1</entry>
<entry><constant>INI_SYSTEM</constant></entry>
<entry>Disponível a partir do WinCache 1.1.0</entry>
</row>
<row>
<entry><link linkend="ini.wincache.ucachesize">wincache.ucachesize</link></entry>
<entry>8</entry>
<entry>5</entry>
<entry>85</entry>
<entry><constant>INI_SYSTEM</constant></entry>
<entry>Disponível a partir do WinCache 1.1.0</entry>
</row>
<row>
<entry><link linkend="ini.wincache.scachesize">wincache.scachesize</link></entry>
<entry>8</entry>
<entry>5</entry>
<entry>85</entry>
<entry><constant>INI_SYSTEM</constant></entry>
<entry>Disponível a partir do WinCache 1.1.0</entry>
</row>
<row>
<entry><link linkend="ini.wincache.rerouteini">wincache.rerouteini</link></entry>
<entry>NULL</entry>
<entry>NULL</entry>
<entry>NULL</entry>
<entry><constant>INI_SYSTEM</constant></entry>
<entry>Disponível a partir do WinCache 1.2.0. Removida a partir do 1.3.7</entry>
</row>
<row>
<entry><link linkend="ini.wincache.reroute_enabled">wincache.reroute_enabled</link></entry>
<entry>1</entry>
<entry>0</entry>
<entry>1</entry>
<entry><constant>INI_SYSTEM</constant>|<constant>INI_PERDIR</constant></entry>
<entry>Disponível a partir do WinCache 1.3.7</entry>
</row>
<row>
<entry><link linkend="ini.wincache.srwlocks">wincache.srwlocks</link></entry>
<entry>1</entry>
<entry>0</entry>
<entry>1</entry>
<entry><constant>INI_SYSTEM</constant></entry>
<entry>Disponível a partir do WinCache 1.3.6.3. Removida a partir do 2.0.0.0</entry>
</row>
<row>
<entry><link linkend="ini.wincache.filemapdir">wincache.filemapdir</link></entry>
<entry>NULL</entry>
<entry>NULL</entry>
<entry>NULL</entry>
<entry><constant>INI_SYSTEM</constant></entry>
<entry>Disponível a partir do WinCache 1.3.7.4</entry>
</row>
</tbody>
</tgroup>
</table>
&ini.php.constants;
</para>
&ini.descriptions.title;
<para>
<variablelist>
<varlistentry xml:id="ini.wincache.fcenabled">
<term>
<parameter>wincache.fcenabled</parameter>
<type>bool</type>
</term>
<listitem>
<simpara>Habilita ou desabilita a funcionalidade de cache de arquivos.</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.wincache.fcenabledfilter">
<term>
<parameter>wincache.fcenabledfilter</parameter>
<type>string</type>
</term>
<listitem>
<simpara>
Define uma lista separada por vírgulas de identificadores de sites do IIS onde o cache de arquivos
deve ser habilitado ou desabilitado. Esta configuração funciona em conjunto
com <literal>wincache.fcenabled</literal>: se <literal>wincache.fcenabled</literal>
for definido como 1, os sites listados em <literal>wincache.fcenabledfilter</literal>
terão o cache de arquivos desativado; se <literal>wincache.fcenabled</literal>
for definido como 0, os sites listados em <literal>wincache.fcenabledfilter</literal>
terão o cache de arquivos ativado.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.wincache.fcachesize">
<term>
<parameter>wincache.fcachesize</parameter>
<type>int</type>
</term>
<listitem>
<simpara>
Define o tamanho máximo de memória (em megabytes) alocado para o cache de arquivos.
Se o tamanho total de todos os arquivos em cache exceder o valor especificado nesta configuração,
a maioria dos arquivos obsoletos será removida do cache de arquivos.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.wincache.fcndetect">
<term>
<parameter>wincache.fcndetect</parameter>
<type>bool</type>
</term>
<listitem>
<simpara>
Habilita ou desabilita a funcionalidade de detecção de notificação de alteração de arquivo. Se a notificação de alteração de arquivo
for suportada, ela será usada para atualizar o opcode e as entradas de cache de arquivos
assim que os arquivos correspondentes forem modificados em um sistema de arquivos. Se a notificação de alteração de arquivo
não for suportada, por exemplo, ao usar compartilhamentos de arquivos de rede, o wincache verificará
as alterações de arquivo em intervalos regulares especificados por <literal>wincache.chkinterval</literal>.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.wincache.maxfilesize">
<term>
<parameter>wincache.maxfilesize</parameter>
<type>int</type>
</term>
<listitem>
<simpara>
Define o tamanho máximo permitido (em quilobytes) para que um único arquivo seja armazenado em cache.
Se o tamanho de um arquivo exceder o valor especificado, ele não será armazenado em cache.
Esta configuração se aplica apenas ao cache de arquivos.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.wincache.ocenabled">
<term>
<parameter>wincache.ocenabled</parameter>
<type>bool</type>
</term>
<listitem>
<warning xmlns="http://docbook.org/ns/docbook"><simpara>Esta opção foi <emphasis>REMOVIDA</emphasis> a partir do 2.0.0.0</simpara></warning>
<simpara>Habilita ou desabilita a funcionalidade de cache do opcode</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.wincache.ocenabledfilter">
<term>
<parameter>wincache.ocenabledfilter</parameter>
<type>string</type>
</term>
<listitem>
<warning xmlns="http://docbook.org/ns/docbook"><simpara>Esta opção foi <emphasis>REMOVIDA</emphasis> a partir do 2.0.0.0</simpara></warning>
<simpara>
Define uma lista separada por vírgulas de identificadores de sites do IIS onde o cache de opcode
deve ser habilitado ou desabilitado. Esta configuração funciona em conjunto
com <literal>wincache.ocenabled</literal>: se <literal>wincache.ocenabled</literal>
for definido como 1, os sites listados no <literal>wincache.ocenabledfilter</literal>
terão o cache de opcode desativado; se <literal>wincache.ocenabled</literal>
for definido como 0, os sites listados no <literal>wincache.ocenabledfilter</literal>
terão o cache de opcode ativado.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.wincache.ocachesize">
<term>
<parameter>wincache.ocachesize</parameter>
<type>int</type>
</term>
<listitem>
<warning xmlns="http://docbook.org/ns/docbook"><simpara>Esta opção foi <emphasis>REMOVIDA</emphasis> a partir do 2.0.0.0</simpara></warning>
<simpara>
Define o tamanho máximo de memória (em megabytes) alocado para o cache do opcode.
Se o tamanho do opcode armazenado em cache exceder o valor especificado,
a maior parte do opcode obsoleto será removida do cache. Observe que o tamanho do cache
do opcode deve ser pelo menos 3 vezes maior que o tamanho do cache do arquivo.
Caso contrário, o tamanho do cache do opcode será aumentado automaticamente.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.wincache.filecount">
<term>
<parameter>wincache.filecount</parameter>
<type>int</type>
</term>
<listitem>
<simpara>
Define quantos arquivos devem ser armazenados em cache pela extensão, para que o tamanho de memória
apropriado seja alocado na inicialização. Se o número de arquivos exceder o valor
especificado, o WinCache realocará mais memória conforme necessário.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.wincache.chkinterval">
<term>
<parameter>wincache.chkinterval</parameter>
<type>int</type>
</term>
<listitem>
<simpara>
Define a frequência (em segundos) em que a extensão verifica se há alterações no arquivo para
atualizar o cache. Definir como 0 desabilitará a atualização do cache.
As alterações no arquivo não serão refletidas no cache, a menos que a entrada de cache para
esse arquivo seja removida pelo scavenger ou o pool de aplicativos do IIS seja reciclado ou
a função wincache_refresh_if_changed seja chamada.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.wincache.ttlmax">
<term>
<parameter>wincache.ttlmax</parameter>
<type>int</type>
</term>
<listitem>
<simpara>
Define o tempo máximo de vida (em segundos) para uma entrada em cache sem ser utilizada.
Definir como 0 desabilitará a limpeza de cache, de forma que as entradas em cache nunca
serão removidas do cache durante o tempo de vida do processo de trabalho do IIS.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.wincache.enablecli">
<term>
<parameter>wincache.enablecli</parameter>
<type>bool</type>
</term>
<listitem>
<simpara>
Define se o cache está habilitado quando o PHP está sendo executado no modo de linha de comando (CLI).
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.wincache.ignorelist">
<term>
<parameter>wincache.ignorelist</parameter>
<type>string</type>
</term>
<listitem>
<para>
Define uma lista de arquivos que não devem ser armazenados em cache pela extensão.
A lista de arquivos é especificada usando apenas nomes de arquivos, separados
pelo símbolo de barra vertical - "|".
<example>
<title>Exemplo de <literal>wincache.ignorelist</literal></title>
<programlisting role="ini">
<![CDATA[
wincache.ignorelist = "index.php|misc.php|admin.php"
]]>
</programlisting>
</example>
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.wincache.namesalt">
<term>
<parameter>wincache.namesalt</parameter>
<type>string</type>
</term>
<listitem>
<simpara>
Define uma string que será usada ao nomear a extensão
de objetos específicos armazenados na memória compartilhada. Isso é usado
para evitar conflitos que podem ser causados se outros aplicativos dentro
de um processo de trabalho do IIS tentarem acessar a memória compartilhada. O comprimento da
string namesalt não pode exceder 8 caracteres.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.wincache.ucenabled">
<term>
<parameter>wincache.ucenabled</parameter>
<type>bool</type>
</term>
<listitem>
<simpara>
Habilita ou desabilita a funcionalidade de cache do usuário.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.wincache.ucachesize">
<term>
<parameter>wincache.ucachesize</parameter>
<type>int</type>
</term>
<listitem>
<simpara>
Define o tamanho máximo de memória em megabytes alocado para o cache do usuário. Se o tamanho total
das variáveis armazenadas no cache do usuário exceder o valor especificado, as variáveis mais obsoletas
serão removidas do cache.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.wincache.scachesize">
<term>
<parameter>wincache.scachesize</parameter>
<type>int</type>
</term>
<listitem>
<simpara>
Define o tamanho máximo de memória em megabytes alocado para o cache de sessão. Se o tamanho total
dos dados armazenados no cache de sessão exceder o valor especificado, os dados mais obsoletos
serão removidos do cache.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.wincache.rerouteini">
<term>
<parameter>wincache.rerouteini</parameter>
<type>string</type>
</term>
<listitem>
<warning xmlns="http://docbook.org/ns/docbook"><simpara>
Esta opção foi <emphasis>REMOVIDA</emphasis> a partir do 1.3.7. Veja <literal>wincache.reroute_enabled</literal> para funcionalidade similar a partir do 1.3.7.
</simpara></warning>
<simpara>
Especifica um caminho absoluto ou relativo para o arquivo reroute.ini que contém a lista de funções PHP
cuja implementação deve ser substituída pelos equivalentes da função WinCache. Se um caminho relativo for especificado
então, presume-se que seja relativo à localização do arquivo php-cgi.exe.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.wincache.reroute_enabled">
<term>
<parameter>wincache.reroute_enabled</parameter>
<type>bool</type>
</term>
<listitem>
<simpara>
Habilita ou desabilita o redirecionamento de determinadas funções de E/S de arquivo por meio do cache de arquivo.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.wincache.srwlocks">
<term>
<parameter>wincache.srwlocks</parameter>
<type>bool</type>
</term>
<listitem>
<warning xmlns="http://docbook.org/ns/docbook"><simpara>Esta opção foi <emphasis>REMOVIDA</emphasis> a partir do 2.0.0.0</simpara></warning>
<simpara>
Habilita ou desabilita o uso de bloqueios compartilhados de leitor/gravador. Desabilitar é útil na solução de condições de impasse no WinCache.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.wincache.filemapdir">
<term>
<parameter>wincache.filemapdir</parameter>
<type>string</type>
</term>
<listitem>
<simpara>
Especifica um caminho absoluto para um diretório onde o WinCache armazenará os arquivos temporários usados para segmentos de memória compartilhada.
</simpara>
<simpara>
Este diretório deve estar na máquina local e não em um sistema de arquivos em rede.
</simpara>
<simpara>
Se o diretório não for especificado, o WinCache usará o arquivo de paginação do sistema Windows para todos os segmentos de memória compartilhada.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
</section>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->