Se a Visão Geral do Administrador do Nextcloud indicar que o limite de memória do PHP está abaixo de 512 MB, aumentar esse valor aleatoriamente php.inipode não eliminar o aviso. O Nextcloud verifica o ambiente PHP que serve a interface web, enquanto o PHP executado pela linha de comando pode carregar uma configuração diferente. Defina o valor memory_limitpara o serviço PHP web ativo, reinicie esse serviço e verifique o valor na Visão Geral do Administrador do Nextcloud.
O manual de administração do Nextcloud 35, consultado em 10 de outubro de 2026, indica que o limite de memória do PHP deve ser de pelo menos 512 MB. Esse é um limite por script, não uma garantia de que todos os processos PHP usarão essa quantidade. Aumentar esse limite pode permitir que requisições que consomem muita memória sejam concluídas, mas não adiciona RAM física; em um servidor pequeno, muitos processos PHP simultâneos ainda podem esgotar a memória do sistema.
Primeiro, identifique como o Nextcloud executa o PHP.
Antes de editar a configuração, identifique sua pilha web e versão do PHP. Na Visão Geral do Administrador do Nextcloud, observe a versão do PHP, se exibida. Em um terminal, php --inisão exibidos os arquivos de configuração usados pelo binário PHP da linha de comando, mas isso não indica qual arquivo o PHP-FPM ou o Apache usa para as requisições do navegador.
php --version
php --ini
Em uma configuração típica do Debian ou Ubuntu, o PHP-FPM geralmente usa o caminho `/etc/php.php` /etc/php/<version>/fpm/php.ini, enquanto o mod_php do Apache geralmente usa o caminho `/etc/php.php` /etc/php/<version>/apache2/php.ini. A configuração da linha de comando (CLI) geralmente fica em `/etc/ php.php`. /etc/php/<version>/cli/php.iniSubstitua `< <version>versão>` pela versão do PHP instalada, como `<versão> 8.3`. Outros sistemas operacionais e painéis de controle podem usar caminhos diferentes.
O manual do Nextcloud também observa que implantações prontas para uso, como AIO, Snap, NCP ou Community Docker, fornecem ambientes PHP pré-configurados. Para essas instalações, use o método de configuração compatível com a implantação, em vez de presumir que uma configuração em nível de host php.inise aplica.
Defina o limite de memória PHP para a web para 512 MB ou superior.
PHP-FPM com Nginx ou Apache
Faça backup da configuração ativa do FPM e, em seguida, edite-a php.ini. No Debian ou Ubuntu, o comando pode ser semelhante a este; adapte a versão e o caminho para o seu servidor:
sudo cp /etc/php/8.3/fpm/php.ini /etc/php/8.3/fpm/php.ini.backup
sudo nano /etc/php/8.3/fpm/php.ini
Localize a diretiva existente memory_limite defina-a para pelo menos 512 MB:
memory_limit = 512M
Edite a diretiva existente em vez de adicionar várias cópias conflitantes. Se uma configuração de pool do PHP-FPM definir `<nome_da_configuração>` php_admin_value[memory_limit], essa configuração de nível de pool poderá ter precedência; revise o arquivo de pool ativo se o aviso persistir.
Reinicie o serviço PHP-FPM correspondente para que as novas solicitações da web usem a configuração atualizada. Por exemplo, o serviço pode ser nomeado como php8.3-fpm:
sudo systemctl restart php8.3-fpm
Quando o Apache utiliza o PHP-FPM, reinicie o PHP-FPM e recarregue ou reinicie o Apache somente se a configuração do seu servidor web também tiver sido alterada. Utilize os nomes de serviço corretos da sua distribuição.
Apache com mod_php
Se o Apache carrega o PHP como um módulo, edite a configuração do Apache SAPI, geralmente /etc/php/8.3/apache2/php.iniem Debian ou Ubuntu. Defina ` memory_limit = 512M<nome_do_serviço>`, salve o arquivo e reinicie o Apache usando o nome do serviço do seu sistema operacional:
sudo systemctl restart apache2
Não edite o arquivo FPM se o servidor web ativo estiver usando mod_php, ou vice-versa. A configuração do PHP carregada pelo servidor web é a que importa para o aviso na Visão Geral do Administrador.
Imagem oficial do Nextcloud no Docker
A documentação oficial da imagem Docker do Nextcloud descreve uma PHP_MEMORY_LIMITvariável de ambiente, cujo valor padrão é 512M. Defina-a no seu arquivo Compose ou em outra configuração de implantação de contêiner e, em seguida, recrie ou atualize o contêiner por meio desse método de implantação. Uma edição manual dentro de um contêiner em execução pode ser perdida ao ser substituído. Outras imagens e plataformas de orquestração podem usar configurações diferentes, portanto, siga a documentação da imagem que você está executando.
Verifique se a alteração foi aplicada à interface web.
Inicie sessão como administrador e abra novamente as Definições de administração > Visão geral . Confirme se o aviso de memória desapareceu e se o limite de PHP reportado é de pelo menos 512 MB. Atualize a página após reiniciar o serviço; uma página carregada anteriormente pode ainda apresentar um estado desatualizado.
Se o número continuar a ser inferior, verifique estas causas prováveis por esta ordem:
- SAPI incorreto: o arquivo CLI foi alterado, mas o PHP-FPM ou o Apache usa outra configuração.
- Versão incorreta do PHP: o serviço web ativo está executando uma versão diferente daquela que
php.inivocê editou.
- Substituição: um pool FPM, painel de controle de hospedagem ou configuração PHP local substitui a configuração global.
- O serviço não foi reiniciado: os processos PHP existentes ainda estão usando a configuração anterior.
- Configuração do contêiner: o arquivo de hosts editado não foi montado no contêiner ou o contêiner não foi recriado após a alteração de seu ambiente.
A saída da CLI php --inicontinua útil para tarefas cron e OCC, mas não consegue verificar o valor da página web por si só. Evite deixar uma phpinfo()página pública no servidor; use a Visão Geral do Administrador do Nextcloud ou os diagnósticos seguros do seu host.
Quando um limite superior não é suficiente
A recomendação de 512 MB do Nextcloud é uma configuração mínima recomendada, não uma fórmula universal de dimensionamento. Pré-visualizações grandes, importações ou operações específicas do aplicativo podem exigir mais memória, mas aumentar o limite substancialmente pode fazer com que cada processo PHP consuma mais RAM. Se o host começar a usar a memória virtual (swap) ou o sistema operacional encerrar os processos PHP, reduza a concorrência do PHP-FPM ou adicione capacidade de memória em vez de continuar aumentando o limite por processo. Verifique o uso real de RAM durante o pico de atividade normal antes de escolher um valor maior.
Se o aviso desaparecer, mas a operação original ainda falhar, procure por um erro PHP mais específico nos logs do Nextcloud e nos logs do servidor web ou do PHP-FPM. Um aviso de limite de memória diz respeito ao limite de alocação por processo do PHP; ele não diagnostica limites de upload, timeouts, pressão no disco ou erros de aplicação não relacionados.
Referências oficiais