O PHP-FPM pode ser configurado no Plesk por domínio, mas um maior número de workers não significa automaticamente um melhor desempenho. Verifica primeiro o handler utilizado, o pool em questão e os recursos disponíveis. Um limite mais elevado de trabalhadores pode ajudar quando o pool está sobrecarregado e há reservas suficientes; no entanto, em caso de escassez de CPU, pouca RAM ou uma base de dados lenta, pode agravar os problemas. Para o Plesk Obsidian no Linux, mostramos como documentar as configurações, alterá-las com cuidado e observar o seu efeito.
O PHP-FPM e o verdadeiro gargalo
No Plesk Obsidian em Linux, um handler FPM pode encaminhar pedidos PHP para um conjunto de processos de trabalho. Cada processo de trabalho disponível processa uma solicitação; a existência de vários processos de trabalho permite, assim, o processamento paralelo. A configuração do conjunto limita o número de processos disponíveis para esse fim. Estas relações não podem ser facilmente transpostas para o Windows ou para outros manipuladores PHP.
A fila de espera Mostra, numa primeira fase, apenas que as solicitações estão à espera de serem processadas. Não prova que o limite de workers, por si só, seja demasiado baixo: mesmo um pico de tráfego de curta duração ou solicitações com tempo de execução invulgarmente longo podem ocupar todos os workers disponíveis. O que é decisivo é o que acontece, durante esse período, no pool e no resto do servidor.
O tempo de execução da aplicação influencia a rapidez com que um worker fica disponível para o próximo pedido. Se, por exemplo, uma loja estiver à espera de uma interface externa ou se um CMS estiver a realizar um processamento complexo, o processo permanece ocupado durante mais tempo. Um maior número de workers pode reduzir o tempo de espera no pool, mas não resolve, por si só, a lentidão do processamento.
Se a CPU já estiver muito ocupada, os trabalhadores adicionais disputam o tempo de processamento. Nessa situação, podem até atrasar o processamento, em vez de concluírem rapidamente mais pedidos. Por isso, verifica a utilização da CPU durante a fase de carga em questão e não apenas o valor limite nos Definições do PHP.
A memória RAM e a base de dados também impõem limites ao paralelismo. Os processos adicionais requerem memória; quando as reservas são escassas, o recurso à área de troca (swap) pode agravar a situação. Uma base de dados já sobrecarregada pode ficar ainda mais sob pressão devido a mais pedidos PHP simultâneos. Para uma alteração em Plesk PHP-FPM Por isso, precisas de ter uma visão geral da utilização total, e não apenas dos valores do pool.
Distinguir entre handlers, servidores Web e isolamento
Uma configuração por domínio não constitui, automaticamente, um orçamento de recursos totalmente isolado. O Plesk distingue o manipulador FPM normal do handlers FPM dedicados. No caso do handler normal, os sites que utilizam a mesma versão do PHP partilham uma infraestrutura comum de processos e de cache. O handler dedicado disponibiliza conjuntos de processos separados e um OPcache distinto.
Os conjuntos de processos separados melhoram a separação entre os sites. No entanto, não reservam nem CPU nem RAM para um site: outros domínios e serviços continuam a competir pelos recursos partilhados. Uma base de dados partilhada continua também a ser um possível ponto de estrangulamento.
No caso do handler dedicado, é adicionado um OPcache próprio. Isto pode melhorar a delimitação da cache, mas aumenta as necessidades de memória. Por isso, especialmente num servidor com muitos sites pequenos, deves ponderar a ocupação adicional em relação aos benefícios do isolamento, em vez de escolheres o handler dedicado de forma generalizada para todos os domínios.
Nem todas as versões do PHP e nem todos os handlers estão instalados no teu servidor ou estão disponíveis na tua subscrição. Verifica na configuração do domínio quais as combinações que o teu fornecedor disponibiliza efetivamente e quais as opções a que tens acesso. Caso faltem opções, a administração do servidor ou o fornecedor de alojamento podem ajudar-te.
A escolha do gestor PHP e a sua gestão pelo servidor web devem ser consideradas separadamente: no Linux, o FPM pode ser gerido através do Apache ou do nginx. Ao mudar para a gestão pelo nginx, verifica, em particular, os redirecionamentos, a proteção de acesso e outras regras da aplicação. O nginx analisa os conteúdos .htaccess não é suficiente; as regras necessárias têm de ser incluídas numa configuração adequada para o nginx.
Compreender os gestores de processos e os limites dos trabalhadores
O gestor de processos FPM determina a forma como o pool gere os seus trabalhadores. A configuração pm distingue os modos static, dynamic e ondemand. A escolha do modo mais adequado depende, entre outros fatores, da regularidade com que as solicitações chegam e da quantidade de memória que deve permanecer disponível, mesmo quando o sistema está inativo.
Em static o número de trabalhadores é fixo: pm.max_children É este número fixo que determina isso. Isso torna o número de processos em espera bastante previsível, mas mantém processos disponíveis mesmo quando o tráfego é reduzido. Por isso, um valor elevado deve corresponder à capacidade disponível, mesmo que o site esteja a ser pouco utilizado nesse momento.
Em dynamic o FPM altera o número de processos dentro dos limites configurados. pm.start_servers define o número no início; pm.min_spare_servers e pm.max_spare_servers controlam o intervalo pretendido de trabalhadores independentes. Estes valores iniciais e de reserva pertencem ao modo «dynamic», e não ao controlo «ondemand».
Em ondemand Inicia o FPM Worker quando necessário e encerra os processos inativos após o tempo de inatividade definido. Isto pode reduzir o número de processos mantidos em espera no caso de sites raramente utilizados. No entanto, se forem recebidas várias solicitações demoradas em simultâneo, o pool pode necessitar de muitos workers mesmo neste modo e, consequentemente, ocupar memória.
Em «dynamic» e «ondemand» é pm.max_children o Limite superior o worker. Se chegarem ao pool um número suficiente de pedidos em paralelo, os pedidos adicionais não poderão ser processados simultaneamente por um único worker. Um limite mais elevado só proporciona uma margem de manobra significativa se os restantes recursos e a aplicação conseguirem suportar esse paralelismo adicional.
Configurar o PHP-FPM por domínio
No Plesk, abre o domínio em questão e acede a „PHP“ ou „Configurações de PHP“. O nome exato do menu pode variar consoante a interface. É necessário que a tua conta tenha permissão para alterar as configurações de PHP; as opções disponíveis dependem também dos direitos de acesso e do fornecedor de alojamento.
Verifica primeiro a versão do PHP apresentada e o manipulador. Os parâmetros do FPM são relevantes para um handler do FPM; a versão do PHP apresentada, por si só, não indica qual o processo que processa os pedidos. Verifica também qual o pool afetado pela alteração. Caso não tenhas as informações necessárias, contacta o fornecedor ou a administração do servidor.
Antes de proceder à alteração, registe a versão do Plesk e do PHP, o handler e os valores existentes em „PHP-FPM Settings“. Regista também quando e por que motivo pretendes efetuar a alteração, por exemplo, devido a avisos recorrentes apesar de existirem reservas de recursos. Desta forma, poderás comparar o estado posteriormente e reverter uma alteração de forma específica.
Para começar, altere apenas um parâmetro devidamente justificado e, se possível, aplique-o primeiro num ambiente de teste adequado. Em seguida, verifique as funções importantes do site, como o registo e as páginas dinâmicas mais comuns. Por fim, observe os tempos de resposta, os erros e a carga do servidor durante um período de tempo comparável; o simples facto de a alteração ter sido guardada com sucesso ainda não comprova, por si só, que haja qualquer benefício.
Caso surjam erros ou uma carga inesperadamente elevada, restabeleça o valor inicial documentado e verifique novamente o funcionamento. Se faltar uma configuração necessária na interface, não deves partir do princípio de que os direitos são idênticos em todos os sistemas Plesk: se for o caso, pede ao fornecedor que verifique a alteração e os seus efeitos.
Comparação de parâmetros importantes do FPM
Os parâmetros não atuam de forma independente uns dos outros. Em particular, os valores iniciais e de reserva aplicam-se a dynamic, enquanto pm.max_children que determina a dimensão do conjunto em todos os três modos. A tabela seguinte ajuda a avaliar o efeito pretendido de uma alteração e os seus possíveis efeitos secundários.
| Parâmetros | Modo e função | Benefícios e risco de configuração incorreta |
|---|---|---|
| pm | estático, dinâmico ou sob demanda; a gestão de processos é que decide. | Determina se os workers são mantidos de forma fixa, ajustados dinamicamente ou iniciados quando necessário; um modo inadequado pode manter processos desnecessários ou exigir o seu arranque sob carga. |
| pm.max_children | static: número fixo de workers; dynamic e ondemand: limite máximo. | Limita o processamento paralelo; se o valor for demasiado baixo, as solicitações podem ficar em espera; se for demasiado alto, pode sobrecarregar os recursos. |
| pm.iniciar_servidores | dynamic: Número de trabalhadores no arranque. | Fornece a capacidade inicial; um valor elevado inicia, inicialmente, um número correspondente de processos. |
| pm.min_servidores_sobressalentes | dynamic: Número mínimo de trabalhadores disponíveis pretendido. | Reserva capacidade para novos pedidos; um valor elevado pode significar mais processos inativos. |
| pm.max_spare_servers | dynamic: Número máximo de trabalhadores disponíveis pretendido. | Número limitado de workers disponíveis; um valor muito baixo pode favorecer o arranque mais frequente de processos. |
| pm.max_requests | Todos os modos: número de pedidos processados antes da substituição de um worker; 0 significa ilimitado. | É possível limitar o espaço de armazenamento acumulado através da reciclagem; a substituição frequente implica um esforço adicional. |
Em dynamic Os valores iniciais e de reserva devem ser considerados como uma configuração interligada. Estes valores não determinam quantos visitantes um site pode atender simultaneamente: entre outros fatores, o que é determinante é o tempo que cada pedido PHP ocupa um worker e quais os recursos de que necessita durante esse período.
O Reciclagem de trabalhadores através de pm.max_requests pode ajudar quando uma biblioteca integrada perde memória ao longo de várias solicitações. No entanto, isso não resolve o problema da fuga de memória. Um valor mais baixo também não significa automaticamente um melhor desempenho: os workers são substituídos com maior frequência, enquanto a causa real continua a ter de ser investigada.
Estimar o limite de trabalhadores com reserva de memória
Um cálculo de memória pode fornecer uma ordem de grandeza, mas não prova um valor-limite seguro. Em primeiro lugar, tens de determinar qual é o pool afetado e quanta RAM fica efetivamente disponível para trabalhadores adicionais, depois de ter em conta o sistema operativo, a base de dados, o servidor web, outras aplicações e uma reserva de segurança. Tens também de ter em conta os picos de carga de outros domínios.
Exemplo de cálculo ilustrativo, não se trata de uma medição. Suponhamos que, após as deduções mencionadas, fiquem disponíveis 600 MiB para trabalhadores adicionais e que cada trabalhador adicional necessite, segundo uma estimativa conservadora, de 75 MiB. Nesse caso, o cálculo 600 ÷ 75 resulta, no máximo, em oito trabalhadores adicionais. Este número não constitui nem um valor de configuração recomendado nem uma garantia de funcionamento estável.
Neste exemplo, os oito referem-se à necessidade adicional estimada, não necessariamente ao conjunto total. Os workers já existentes e o seu consumo de memória devem ser tidos em conta no cálculo inicial. Antes de deduzir um possível novo limite máximo a partir disso, verifica também se a CPU e a base de dados têm capacidade para suportar o paralelismo adicional.
A necessidade adicional real não é constante: as consultas podem exigir quantidades variáveis de memória e, por vezes, os processos utilizam áreas de memória partilhadas. Também o OPcache e os domínios ativos em simultâneo influenciam o orçamento total. Uma simples multiplicação do número de processos pode contar várias vezes as áreas partilhadas; por outro lado, consultas complexas podem exceder a estimativa inicial.
O PHP-memory_limit limita a memória que um script pode ocupar. Não corresponde à memória total do sistema operativo de um worker do FPM e, por isso, não serve diretamente como valor de memória medida por worker. Além disso, um limite mais elevado não elimina um estrangulamento da CPU.
Para definir uma configuração robusta, observe as necessidades de memória sob uma carga representativa e compare-as com a reserva disponível. Uma alteração cautelosa em pm.max_children Deve, em seguida, ser novamente avaliado com base na memória, no espaço de swap, nos tempos de resposta e nos erros. Se o servidor ou a base de dados continuar sobrecarregado, um maior nível de paralelismo não é necessariamente a medida correta.
Monitorizar a utilização e os valores de estado
Só é possível avaliar uma alteração no PHP-FPM se conheceres a situação anterior. Regista os tempos de resposta e as taxas de erro durante um período representativo e compara-os, após a alteração, com um período o mais semelhante possível. Tenha em conta as diferenças no volume de pedidos, nas tarefas agendadas e em ações mais complexas, como as importações.
Observe em paralelo a utilização da CPU, a memória disponível, a atividade de swap e a carga da base de dados. Se, após um aumento do limite de workers, o número de pedidos processados em simultâneo aumentar, mas a taxa de erros ou a carga da base de dados também aumentarem significativamente, é possível que o gargalo se tenha deslocado. Os alertas do FPM ajudam a interpretar a situação: uma mensagem a indicar que foi atingido um max_children- O limite indica, numa primeira fase, apenas que o pool atingiu a sua capacidade configurada.
Uma área protegida Página de estado do FPM complementa estas observações com valores do pool consultado. Mostra, entre outras coisas, os processos ativos e livres, bem como a fila. Atribua o acesso ao estado ao pool que efetivamente serve o domínio e restrinja-o a acessos autorizados: a saída pode conter informações sensíveis sobre pedidos e processos.
Uma única consulta é apenas um instantâneo; podem ocorrer picos de curta duração entre duas consultas. Outros valores de estado contabilizam os eventos desde o arranque do FPM e são reiniciados aquando do reinício. Registe esses reinícios ao efetuar a comparação, para que um valor de contagem baixo não seja erroneamente interpretado como uma melhoria.
Analisa os valores no seu contexto: um número elevado de workers ativos e uma fila crescente são indícios de que a capacidade do pool está esgotada, mas não explicam, por si só, a causa das consultas demoradas. Para saberes como interpretar os indicadores individuais ao longo do tempo e garantir o acesso, consulta o artigo sobre Página de estado do PHP-FPM para análise de desempenho.
Analisar picos de carga e pedidos lentos
Começa por um pico de carga em que se observe o sintoma e verifica qual o recurso ou qual a parte da aplicação que está a limitar os pedidos. A síntese que se segue apresenta algumas verificações iniciais; não substitui, contudo, uma análise da aplicação concreta nem uma comparação dos valores medidos antes e depois de uma alteração.
| Sintoma | Verificação cruzada | Próxima medida de baixo risco |
|---|---|---|
| Aviso sobre max_children | Verificar a utilização do pool, o comportamento das solicitações e os recursos disponíveis | Se as reservas forem suficientes, considerar um aumento moderado e acompanhar a situação |
| Falta de recursos em condições de carga elevada | Comparar a carga da CPU, da memória, do espaço de swap e da base de dados ao longo do tempo com as consultas | Analisar a fonte da carga, em vez de aumentar o limite de trabalhadores sem mais delongas |
| Pedidos extensos relativos a lojas online ou CMS | Verificar as partes lentas da aplicação, a base de dados e as interfaces externas | Identificar pedidos suspeitos e resolver a causa dos mesmos |
A Aviso relativo a max_children pode ocorrer porque muitas solicitações legítimas chegam simultaneamente ou porque determinadas solicitações ocupam os workers durante muito tempo. Por isso, verifica também padrões de acesso invulgares e possíveis ataques. Se a CPU, a memória e a base de dados já estiverem sob forte carga, a adição de workers pode agravar a situação, em vez de melhorar os tempos de resposta.
No caso de uma loja online, por exemplo, uma consulta lenta à base de dados ou uma interface externa em espera pode ocupar vários workers em simultâneo. Compare os períodos em questão com as observações da aplicação e da base de dados. Só quando o limite do pool estiver efetivamente atingido e os recursos envolvidos tiverem reservas é que faz sentido considerar um aumento cauteloso.
A Slowlog Se o FPM estiver devidamente configurado, pode fornecer um rastreio da pilha para consultas de longa duração. Mostra um ponto de execução no momento do registo, mas não revela automaticamente a causa completa do atraso. Deverás comparar as indicações recorrentes com dados adicionais antes de alterares o código ou os limites do pool.
Para uma análise mais aprofundada, o artigo aborda o tema Análise do registo de lentidão do PHP-FPM, como se pode interpretar essas indicações. Regista, para cada medida, o valor inicial, a data e as observações: assim, poderás atribuir uma deterioração a uma alteração específica e revertê-la de forma direcionada.
Gerir e verificar as configurações de forma sustentável
No caso de muitos sites pequenos, é possível ondemand ajuda a não ter de manter recursos disponíveis permanentemente para cada Pool Worker. No entanto, para o planeamento da capacidade, têm de ser tidos em conta os picos de carga simultâneos de todos os domínios e as necessidades de memória de outros serviços. Um handler FPM dedicado melhora a segregação dos sites, mas requer, entre outras coisas, memória adicional para um OPcache separado.
Uma importação rara e complexa apresenta requisitos diferentes dos das visualizações normais de páginas. O PHP-memory_limit limita a memória de um script e não deve ser confundida com a memória total do sistema operativo de um worker. Verifica primeiro se a importação atinge efetivamente esse limite e quais são as reservas disponíveis, antes de o aumentares.
O OPcache pode reutilizar código PHP compilado. Antes de efetuar qualquer alteração, verifique se o código está ativo para o handler efetivamente utilizado e qual é a configuração aplicável. A cache e os workers competem com outros serviços pela memória; por isso, uma maior atribuição de cache não é uma decisão isolada.
No caso de várias subscrições, as definições de PHP podem ser geridas através de um Plano de serviços gerir e sincronizar. Não confies no facto de todas as subscrições existentes adotarem um valor alterado: os bloqueios e as autorizações podem afetar a sincronização. Verifica individualmente os domínios afetados após a atualização.
Distinga, além disso, as predefinições globais do PHP, as configurações específicas do domínio e os valores efetivamente carregados. Após alterações diretas num ficheiro de configuração, a interface do Plesk pode apresentar valores diferentes dos que estão efetivamente em vigor. Por isso, documente as alterações e verifique o seu efeito no handler em questão; se uma alteração causar problemas, restabeleça de forma controlada o valor previamente guardado e volte a observar o domínio.
Fontes e estado atual dos conhecimentos
Estado da pesquisa:
Âmbito técnico: Plesk Obsidian no Linux; a versão do PHP, o handler e as definições disponíveis dependem da instalação específica e das autorizações. Data da pesquisa: 16 de novembro de 2026.
https://docs.plesk.com/en-US/obsidian/administrator-guide/web-hosting/php-management/php-handlers.75145/
https://www.php.net/install.fpm.configuration
https://support.plesk.com/hc/en-us/articles/12377661896343-Websites-on-PHP-FPM-are-unavailable-or-loading-slowly-server-reached-max-children-setting-consider-raising-it
https://support.plesk.com/hc/en-us/articles/12377519572887-How-to-customize-PHP-settings-in-Plesk
https://support.plesk.com/hc/en-us/articles/12377800927127-How-to-find-and-edit-PHP-configuration-files-in-Plesk-for-a-domain-or-for-global-PHP-handler
https://support.plesk.com/hc/en-us/articles/12388475473303-What-does-the-PHP-memory-limit-setting-do
https://www.php.net/manual/en/fpm.status.php
https://support.plesk.com/hc/en-us/articles/12389216713367-Default-value-of-PHP-Settings-for-domains-are-different-from-values-in-global-php-ini




