Configurações do PHP

Você pode escolher qual versão do PHP para executar no seu .magento.app.yaml arquivo:

name: mymagento
type: php:<version>
TIP
Se estiver atualizando para o PHP 8.1 e posterior, remova o JSON do runtime: extensions: propriedade no .magento.app.yaml arquivo e reimplantar. A extensão JSON vem instalada no ambiente de nuvem desde o PHP 8.0.

Configurar PHP

Você pode personalizar as configurações do PHP para o seu ambiente usando um php.ini arquivo anexado à configuração mantida pelo Adobe Commerce.

No repositório, adicione o php.ini para a raiz do aplicativo (a raiz do repositório).

TIP
A configuração incorreta das configurações do PHP pode causar problemas, portanto, somente administradores avançados devem definir essas opções.

Aumentar limite de memória do PHP

Para aumentar o limite de memória do PHP, adicione a seguinte configuração ao php.ini arquivo:

memory_limit = 1G

Para depuração, aumente o valor para 2G.

Otimizar a configuração do realpath_cache

Defina o seguinte realpath_cache para melhorar o desempenho dos aplicativos.

;
; Increase realpath cache size
;
realpath_cache_size = 10M

;
; Increase realpath cache ttl
;
realpath_cache_ttl = 7200

Essas configurações permitem que processos PHP armazenem em cache caminhos para arquivos em vez de pesquisá-los para cada carregamento de página. Consulte Ajuste de desempenho na documentação do PHP.

NOTE
Para obter uma lista das definições de configuração do PHP recomendadas, consulte Configurações necessárias do PHP no Guia de instalação.

Verificar configurações personalizadas de PHP

Depois de pressionar o php.ini alterações no ambiente da nuvem, você pode verificar se a configuração personalizada do PHP foi adicionada ao seu ambiente. Por exemplo, use SSH para fazer logon no ambiente remoto e exibir o arquivo usando algo semelhante ao seguinte:

cat /etc/php/<php-version>/fpm/php.ini
WARNING
Se você usar o Cloud Docker for Commerce para desenvolvimento local, consulte Contêineres de serviço do Docker para obter informações sobre como usar um personalizado php.ini em um ambiente Docker.

Habilitar extensões

Você pode ativar ou desativar extensões PHP no runtime:extension seção. Além disso, as extensões especificadas ficam disponíveis nos contêineres PHP do Docker.

IMPORTANT
Antes de habilitar extensões, é importante entender que a versão do PHP deve ser compatível com o sistema operacional que hospeda o projeto. Seu ambiente de projeto pode exigir uma atualização do SO pela equipe de infraestrutura antes de você poder continuar.

Exemplo em .magento.app.yaml arquivo:

runtime:
    extensions:
        - sockets
        - sodium
        - ssh2
    disabled_extensions:
        - bcmath
        - bz2
        - calendar
        - exif

Use SSH para fazer login em um ambiente e listar as extensões do PHP.

php -m

Para obter detalhes sobre uma extensão específica do PHP, consulte Lista de extensões do PHP.

A tabela a seguir mostra as extensões compatíveis do PHP ao implantar o Adobe Commerce na plataforma na nuvem.

Extensões padrão
Extensões instaladas que não podem ser desinstaladas
Extensões que podem ser instaladas e desinstaladas conforme necessário
bcmath
bz2
calendário
exif
gd
gettext
intl
libxml
mysqli
opcache
openswoole
pcntl
pdo_mysql
Reflexo
soap
soquetes
SPL
padrão
sysvmsg
sistema
sysvshm
zip
zlib
ctype
curl
data
dba
dom
fileinfo
filtro
ftp
hash
iconv
json
mbstring
mysqlnd
openssl
pcre
dop
pdo_sqlite
phar
posix
readline
session
sqlite3
tokenizer
xml
xmlreader
xmlwriter
geoip
gmp
igbinary
imagick
imap
ldap
mailparse
mcrypt
msgpack
mysqli
oauth
pdo_mysql
propro
soletração
raphf
recode
redis
shmop sockets
sódio
ssh2
arrumado
xdebug
xmlrpc
xsl
yaml

Os requisitos do módulo do PHP estão vinculados à versão do Adobe Commerce. Consulte Requisitos do PHP.

Suporte à extensão

Para projetos Pro, as seguintes extensões exigem suporte adicional para instalação:

  • sourceguardian

Por exemplo, para configurar o PHP para executar somente scripts protegidos pelo SourceGuardian em todos os ambientes, a seguinte opção deve ser configurada na variável php.ini arquivo:

[SourceGuardian]
sourceguardian.restrict_unencoded = "1"

Consulte seção 3.5 da documentação do SourceGuardian. Este é um link para um PDF.

Enviar um tíquete de suporte da Adobe Commerce para obter ajuda com a instalação dessas extensões PHP em todos os ambientes de produção e ambientes de preparo profissional. Inclua o atualizado .magento/services.yaml arquivo, .magento.app.yaml arquivo com a versão atualizada do PHP e quaisquer extensões adicionais do PHP. Para alterações em um ambiente de Produção em tempo real, você deve fornecer um aviso mínimo de 48 horas. Pode levar até 48 horas para a equipe de infraestrutura da nuvem atualizar seu projeto.

WARNING
O PHP compilado com debug não é suportado e o teste pode entrar em conflito com XDebug ou XHProf. Desative essas extensões ao ativar o teste. O teste entra em conflito com algumas extensões PHP como Pinba ou IonCube.
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26