Configurações em Execução

O comportamento destas funções é afetado pelas configurações do php.ini.

Embora as configurações padrão do APCu são adequadas para muitas instalações, usuários devem considerar ajustes para os parâmetros abaixo.

Existe uma decisão a ser tomada ao configurar o APCu: quanta memória será alocada ao APCu. A diretiva ini que controla isso é apc.shm_size, leia cuidadosamente as seções sobre este assunto abaixo.

Uma vez que o servidor está em execução, o script apc.php que é incluído com a extensão deve ser copiado para algum lugar dentro do diretório raiz dos documentos e visualizado com um navegador pois ele fornece uma análise detalhada do funcionamento interno do APCu. Se a GD estiver habilitada no PHP, ele irá mostrar inclusive alguns gráficos interessantes.

Se o APCu estiver funcionando, o número Cache full count (na esquerda) mostrará o número de vezes que o cache atingiu a capacidade máxima e teve que despejar entradas para liberar memória. Durante o despejo, se apc.ttl foi especificado, o APCu inicialmente tentará remover entradas expiradas, isto é, entradas cujo TTL tenha expirado ou entradas que não tenham o TTL definido e não tenham sido acessadas nos últimos apc.ttl segundos. Se apc.ttl não foi definido, ou se a remoção de entradas expiradas não liberou espaço suficiente, o APCu limpará o cache inteiro.

O número de despejos deve ser mínimo em um cache bem configurado. Se o cache está constantemente atingindo o limite, e por isso sendo liberado à força, a agitação resultante terá efeitos depreciativos no desempenho do script. A maneira mais fácil de minimizar este número é alocar mais memória para o APCu.

Quando o APCu é compilado com suporte a mmap (Mapeamento de Memória), ele usará somente um segmento de memória, ao contrário de quando for compilado com suporte a SHM (Memória Compartilhada SysV) que usa múltiplos segmentos. MMAP não tem um limite máximo como o SHM em /proc/sys/kernel/shmmax. Em geral o suporte MMAP é recomendado porque ele irá recuparar a memória mais rapidamente quando o servidor web for reiniciado e, sumazirando, reduzirá o impacto na alocação de memória na inicialização.

Opções de configuração APCu

Nome	Padrão	Modificável	Registro de Alterações
apc.enabled	1	INI_SYSTEM
apc.shm_segments	1	INI_SYSTEM
apc.shm_size	"32M"	INI_SYSTEM
apc.entries_hint	512 * apc.shm_size	INI_SYSTEM	Antes do APcu 5.1.25, o padrão era 4096
apc.ttl	0	INI_SYSTEM
apc.gc_ttl	3600	INI_SYSTEM
apc.mmap_file_mask	NULL	INI_SYSTEM
apc.slam_defense	0	INI_SYSTEM
apc.enable_cli	0	INI_SYSTEM
apc.use_request_time	0	INI_ALL	Antes do APCu 5.1.19, o padrão era 1.
apc.serializer	"php"	INI_SYSTEM	Antes do APCu 5.1.15, o padrão era "default".
apc.coredump_unmap	0	INI_SYSTEM
apc.preload_path	NULL	INI_SYSTEM

Para mais detalhes e definições dos modos INI_*, consulte os Onde uma configuração deve ser definida.

Aqui está uma breve explicação das diretivas de configuração.

apc.enabled bool

apc.enabled pode ser definido para 0 para desabilitar o APC. Isto é útil principalmente quando o APC é compilado estaticamente no PHP, já que não há outra maneira de desabilitá-lo (quando compilado como um DSO, a linha extension no php.ini pode ser simplesmente comentada).

apc.shm_segments int

O número de segmentos de memória compartilhada a alocar para o cache do compilador. Se o APC estiver com pouca memória compartilhada mas apc.shm_size estiver definido com um valor tão alto quanto o sistema permite, aumentar este valor pode evitar que o APC tenha a memória exaurida.

apc.shm_size string

O tamanho de cada segmento de memória compartilhada, informado como uma notação reduzida como descrito neste FAQ. Por padrão, alguns sistemas (incluindo a maior parte das variantes BSD) têm limites muito baixos no tamanho de um segmento de memória compartilhada.

apc.entries_hint int

Uma "pista" sobre o número de variáveis distintas que podem ser armazenadas. Defina para zero ou omita se não tiver essa informação.

apc.ttl int

Considera que entradas de cache sem um TTL explícito estão expiradas se não foram acessadas nos segundos definidos por esta diretiva. Efetivamente, isto permite que tais entradas sejam removida oportunamente durante uma inserção de cache ou antes de uma eliminação completa. Observe que devido à remoção ser oportunap, as entradas ainda podem ser lidas mesmo se forem mais antigas que apc.ttl segundos. Esta configuração não tem efeito em entradas de cache que tenham um TTL explícito especificado.

apc.gc_ttl int

O número de segundos que uma entrada de cache pode permanecer na lista de coleta de lixo após ser removida ou inicializada. Uma entrada é elegível a remoção se sua contagem de referência for zero, ou se exceder este limite de tempo. Se definido para 0, a limpeza baseada em tempo é desativada, e as entradas só serão removidas quando suas contagens de referência caírem para zero.

apc.mmap_file_mask string

Se compilado com suporte MMAP usando --enable-mmap esta é a máscara de arquivo em estilo mktemp a ser passada ao módulo mmap para determinar se a região de memória mapeada pelo MMAP será apoiada por arquivo ou apoiada por memória comparilhada. Para MMAP diretamente apoiada por arquivo, defina para algo como /tmp/apc.XXXXXX (exatamente 6 X). Oara usar shm_open/mmap em estilo POSIX, insira um .shm em algum lugar da máscara (por exemplo, /apc.shm.XXXXXX). Pode-se também defini-la para /dev/zero para usar a interface /dev/zero do kernel para memória mapeada anonimamente. Deixar este valor indefinido força um mapeamento anônimo.

apc.slam_defense bool

Em um servidor muito ocupado, toda vez que ele for reiniciado ou quando arquivos forem modificados, pode-se criar uma condição de corrida onde muitos processos tentam inserir o mesmo arquivo no cache ao mesmo tempo. Definir apc.slam_defense para 1 pode ajudar a evitar que múltiplos processos tentem fazer cache do mesmo arquivo ao mesmo tempo, através da introdução de um mecanismo probabilístico. Se a mesma chave sofrer tentativa de cache dentro de um intervalo curto de tempo por diferentes processos, ele pula a tarefa de cache do processo atual para mitigar potenciais conflitos de cache.

apc.enable_cli int

Esta diretiva serve principalmente para teste e depuração. Habilita APC para a versão CLI do PHP. Em circunstâncias normais, não é ideal criar, popular e destruir o cache APC a cada requisição CLI, mas para vários cenários de teste é útil para ser capaz de habilitar o APC para a versão CLI do PHP facilmente.

apc.serializer string

Usada para configurar o APC para usar um serializador de terceiros.

apc.coredump_unmap bool

Habilita o gerenciamento APC de sinais, tal como SIGSEGV, que grava arquivos de núcleo quando sinalizado. Quandos esses sinais são recebidos, o APC tentará desmapear o segmento de memória compartilhada para excluí-lo do arquivo de núcleo. Esta configuração pode melhorar a estabilidade do sistema quando sinais fatais são recebidos e um grande segmento de memória compartilhada APC estiver configurado.

Aviso

Este recurso é potencialmente perigoso. Desmapear o segmento de memória compartilhada em um gerenciador de sinal fatal pode causar comportamento indefinido de um erro fatal ocorrer.

Nota: Embora alguns kernels possam fornecer um recurso para ignorar vários tipos de memória compartilhada ao gerar um arquivo de despejo de núcleo, estas implementações podem também ignorar segmentos de memória compartilhada importantes tal como o Scoreboard do Apache.

apc.preload_path string

Opcionalmente, define um caminho para o diretório onde o APC irá carregar dados de cache na inicialização.

apc.use_request_time bool

Usa o horário de início da requisição SAPI para o TTL.