PHP设置

您可以选择在.magento.app.yaml文件中运行的PHP🔗的版本:

name: mymagento
type: php:<version>
TIP
如果升级到PHP 8.1及更高版本,请从.magento.app.yaml文件中的runtime: extensions:属性中删除JSON并重新部署。 JSON扩展自PHP 8.0起即安装在云环境中。

配置PHP

您可以使用附加到Adobe Commerce维护的配置的php.ini文件自定义环境的PHP设置。

在存储库中,将php.ini文件添加到应用程序的根目录(存储库根目录)。

TIP
不正确配置PHP设置可能会导致问题,因此只有高级管理员才应该设置这些选项。

增加PHP内存限制

要增加PHP内存限制,请将以下设置添加到php.ini文件中:

memory_limit = 1G

对于调试,请将该值增加到2G。

优化real路径缓存配置

设置以下realpath_cache设置以提高应用程序性能。

;
; Increase realpath cache size
;
realpath_cache_size = 10M

;
; Increase realpath cache ttl
;
realpath_cache_ttl = 7200

这些设置允许PHP进程缓存文件的路径,而不是在每次加载页时查找这些路径。 请参阅PHP文档中的性能调整

NOTE
有关推荐的PHP配置设置列表,请参阅​_安装指南_​中的必需的PHP设置

检查自定义PHP设置

php.ini更改推送到云环境后,您可以检查自定义PHP配置是否已添加到环境中。 例如,使用SSH登录到远程环境,并使用类似于以下内容的内容查看文件:

cat /etc/php/<php-version>/fpm/php.ini
WARNING
如果您使用Cloud Docker for Commerce进行本地开发,请参阅Docker服务容器,以了解有关在Docker环境中使用自定义php.ini文件的信息。

启用扩展

您可以在runtime:extension部分中启用或禁用PHP扩展。 此外,指定的扩展在Docker PHP容器中可用。

IMPORTANT
在启用扩展之前,请务必了解PHP版本必须与托管项目的操作系统兼容。 您的项目环境可能需要基础架构团队升级操作系统,然后才能继续。

.magento.app.yaml文件中的示例:

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

使用SSH登录到环境并列出PHP扩展。

php -m

有关特定PHP扩展的详细信息,请参阅PHP扩展列表

下表显示了在Cloud平台上部署Adobe Commerce时支持的PHP扩展。

默认扩展
安装的扩展无法卸载
可以根据需要安装和卸载的扩展
bcmath
bz2
日历
exif
gd
gettext
intl
libxml
mysqli
opcache
openswoole
pcntl
pdo_mysql
反射
soap
套接字
SPL
standard
sysvmsg
sysvsem
sysvshm
zip
zlib
ctype
curl
日期
dba
dom
文件信息
筛选器
ftp
哈希
iconv
json
mbstring
mysqlnd
openssl
pcre
pdo
pdo_sqlite
phar
posix
读取行
会话
sqlite3
tokenizer
xml
xmlreader
xmlwriter
geoip
gmp
igbinary
imagick
imap
ldap
mailparse
mcrypt
msgpack
mysqli
oauth
pdo_mysql
propro
拼写
raphf
recode
redis
shmop插座

ssh2
整齐
xdebug
xmlrpc
xsl
yaml

PHP模块要求与Adobe Commerce版本相关联。 请参阅PHP要求

扩展支持

对于Pro项目,需要其他支持才能安装以下扩展:

  • sourceguardian

例如,要将PHP设置为在所有环境中仅执行受SourceGuardian保护的脚本,必须在php.ini文件中设置以下选项:

[SourceGuardian]
sourceguardian.restrict_unencoded = "1"

请参阅SourceGuardian文档的第3.5节这是指向PDF ​的链接。

提交Adobe Commerce支持票证,以获得在所有生产环境和Pro暂存环境中安装这些PHP扩展的帮助。 包含更新的.magento/services.yaml文件、.magento.app.yaml文件(包含更新的PHP版本和任何其他PHP扩展名)。 对于实时生产环境的更改,您必须至少提供48小时的通知。 Cloud Infrastructure团队更新项目最多可能需要48小时。

WARNING
不支持使用调试编译的PHP,并且探测器可能与XDebug或XHProf冲突。 启用Probe时禁用这些扩展。 探测与某些PHP扩展冲突,如Pinba或IonCube。
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26