Configuración de PHP

Puede elegir cuál versión de PHP para ejecutar en su .magento.app.yaml archivo:

name: mymagento
type: php:<version>
TIP
Si actualiza a PHP 8.1 y versiones posteriores, elimine JSON del runtime: extensions: propiedad en el .magento.app.yaml y vuelva a implementarlo. La extensión JSON viene instalada en el entorno de la nube desde PHP 8.0.

Configuración de PHP

Puede personalizar la configuración de PHP para su entorno mediante una php.ini que se adjunta a la configuración mantenida por Adobe Commerce.

En el repositorio, agregue php.ini a la raíz de la aplicación (la raíz del repositorio).

TIP
Configurar PHP incorrectamente puede causar problemas, por lo que solo los administradores avanzados deben configurar estas opciones.

Aumentar el límite de memoria PHP

Para aumentar el límite de memoria PHP, agregue el siguiente ajuste al php.ini archivo:

memory_limit = 1G

Para la depuración, aumente el valor a 2G.

Optimizar configuración de realpath_cache

Configure lo siguiente realpath_cache configuración para mejorar el rendimiento de la aplicación.

;
; Increase realpath cache size
;
realpath_cache_size = 10M

;
; Increase realpath cache ttl
;
realpath_cache_ttl = 7200

Estos ajustes permiten a los procesos de PHP almacenar en caché las rutas a los archivos en lugar de buscarlos para cada carga de página. Consulte Ajuste del rendimiento en la documentación de PHP.

NOTE
Para ver una lista de los ajustes de configuración de PHP recomendados, consulte Configuración de PHP requerida en el Guía de instalación.

Compruebe la configuración personalizada de PHP

Después de empujar el php.ini cambios en su entorno de Cloud, puede comprobar que la configuración personalizada de PHP se ha añadido a su entorno. Por ejemplo, utilice SSH para iniciar sesión en el entorno remoto y ver el archivo con algo similar a lo siguiente:

cat /etc/php/<php-version>/fpm/php.ini
WARNING
Si utiliza Cloud Docker para Commerce para el desarrollo local, consulte Contenedores de servicio Docker para obtener información sobre el uso de un personalizado php.ini en un entorno de Docker.

Habilitar extensiones

Puede habilitar o deshabilitar las extensiones PHP en el runtime:extension sección. Además, las extensiones especificadas están disponibles en los contenedores Docker PHP.

IMPORTANT
Antes de habilitar las extensiones, es importante comprender que la versión de PHP debe ser compatible con el sistema operativo que aloja el proyecto. Es posible que el entorno del proyecto requiera una actualización del sistema operativo por parte del equipo de infraestructura para poder continuar.

Ejemplo en .magento.app.yaml archivo:

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

Utilice SSH para iniciar sesión en un entorno y enumerar las extensiones PHP.

php -m

Para obtener más información sobre una extensión PHP específica, consulte la Lista de extensiones PHP.

La siguiente tabla muestra las extensiones PHP compatibles al implementar Adobe Commerce en la plataforma Cloud.

Extensiones predeterminadas
Extensiones instaladas que no se pueden desinstalar
Extensiones que se pueden instalar y desinstalar según sea necesario
bcmath
bz2
calendario
exif
gd
gettext
intl
libxml
mysqli
opaco
lana abierta
pcntl
pdo_mysql
Reflexión
jabón
enchufes
SPL
standard
sysvmsg
sysvsem
sysvshm
zip
zlib
ctype
rizar
fecha
dba
dom
fileinfo
filter
ftp
hash
iconv
json
mstring
mysqlnd
openssl
pcre
dop
pdo_sqlite
phar
posix
readline
sesión
sqlite3
tokenizador
xml
xmlreader
xmlwriter
geoip
gmp
igbinario
imagick
imap
ldap
mailparse
mcrypt
msgpack
mysqli
oauth
pdo_mysql
propro
hechizo
gráfico
volver a codificar
redis
enchufes de chispa
sodio
ssh2
ordenado
xdebug
xmlrpc
xsl
yaml

Los requisitos del módulo PHP están vinculados a la versión de Adobe Commerce. Consulte Requisitos de PHP.

Compatibilidad con extensiones

Para proyectos Pro, las siguientes extensiones requieren compatibilidad adicional para su instalación:

  • sourceguardian

Por ejemplo, para configurar PHP para que ejecute solo scripts protegidos por SourceGuardian en todos los entornos, se debe establecer la siguiente opción en la variable php.ini archivo:

[SourceGuardian]
sourceguardian.restrict_unencoded = "1"

Consulte sección 3.5 de la documentación de SourceGuardian. Este es un vínculo a un PDF.

Enviar un ticket de asistencia de Adobe Commerce para obtener ayuda sobre la instalación de estas extensiones PHP en todos los entornos de producción y entornos de ensayo Pro. Incluya su actualizado .magento/services.yaml archivo, .magento.app.yaml archivo con la versión actualizada de PHP y cualquier extensión adicional de PHP. Para realizar cambios en un entorno de producción activo, debe proporcionar un aviso mínimo de 48 horas. El equipo de infraestructura en la nube puede tardar hasta 48 horas en actualizar el proyecto.

WARNING
PHP compilado con debug no es compatible y el Sondeo puede entrar en conflicto con XDebug o XHProf. Deshabilite esas extensiones al habilitar el sondeo. El Sondeo entra en conflicto con algunas extensiones PHP como Pinba o IonCube.
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26