This is a beta release of documentation for Magento 2.4, published for previewing soon-to-be-released functionality. Content in this version is subject to change. Links to the v2.4 code base may not properly resolve until the code is officially released.
You must install Elasticsearch before installing Magento Commerce or Magento Open Source 2.4.0. See Elasticsearch for details.

Required PHP settings

Edit on GitHub
Log an Issue

This topic discusses how to set required PHP options.

Supported PHP versions:

  • ~7.3.0

  • ~7.4.0

Verify PHP is installed

Most flavors of Linux have PHP installed by default. This topic assumes that you have already installed PHP. To verify if PHP is installed already, in the command line, type:

1

php -v

If PHP is installed, a message similar to the following displays:

1
2
3

PHP 7.4.0 (cli) (built: Aug 14 2019 16:42:46) ( NTS )
Copyright (c) 1997-2018 The PHP Group
Zend Engine v3.1.0, Copyright (c) 1998-2018 Zend Technologies with Zend OPcache v7.1.6, Copyright (c) 1999-2018, by Zend Technologies

Magento 2.4 is compatible with PHP 7.3, but we test with, and recommend using, PHP 7.4.

If PHP is not installed, or a version upgrade is needed, install it following instructions for your particular Linux flavor. On CentOS, additional steps may be required.

Verify installed extensions

Magento requires a set of extensions to be installed:

  • ext-bcmath

  • ext-ctype

  • ext-curl

  • ext-dom

  • ext-gd

  • ext-hash

  • ext-iconv

  • ext-intl

  • ext-mbstring

  • ext-openssl

  • ext-pdo_mysql

  • ext-simplexml

  • ext-soap

  • ext-xsl

  • ext-zip

  • lib-libxml

In the command line, type:

1

php -m

to see the list of installed modules. Verify that the listed extensions are installed. If any modules are missing, they are added using the same workflow used for installing PHP. For example, if you use yum to install PHP, the PHP 7.4 modules can be added with:

1

 yum -y install php74u-pdo php74u-mysqlnd php74u-opcache php74u-xml php74u-gd php74u-devel php74u-mysql php74u-intl php74u-mbstring php74u-bcmath php74u-json php74u-iconv php74u-soap

The bcmath extension is required for Magento Commerce only.

Check PHP settings

  • Set the system time zone for PHP; otherwise, errors like the following display during the installation and time-related operations like cron might not work:
1

PHP Warning:  date(): It is not safe to rely on the system's timezone settings. [more messages follow]

  • Set the PHP memory limit.

    Our detailed recommendations are:

    • Compiling code or deploying static assets, 756M
      • Installing and updating Magento components from Magento Marketplace, 2G
      • Testing, ~3-4G

  • Enable opcache.save_comments, which is required for Magento 2.1 and later.

    We recommend you enable the PHP OPcache for performance reasons. The OPcache is enabled in many PHP distributions.

    Magento 2.1 and later use PHP code comments for code generation.

To avoid issues during installation and upgrade, we strongly recommend you apply the same PHP settings to both the PHP command-line configuration and the PHP web server plug-in’s configuration. For more information, see the next section.

Step 1: Find PHP configuration files

This section discusses how you find the configuration files necessary to update required settings.

Find php.ini configuration file

To find the web server configuration, run a phpinfo.php file in your web browser and look for the Loaded Configuration File as follows:

To locate the PHP command-line configuration, enter

1

php --ini | grep "Loaded Configuration File"

If you have only one php.ini file, make the changes in that file. If you have two php.ini files, make the changes in all files. Failure to do so might cause unpredictable performance.

Find OPcache configuration settings

PHP OPcache settings are typically located either in php.ini or opcache.ini. The location might depend on your operating system and PHP version. The OPcache configuration file might have an opcache section or settings like opcache.enable.

Use the following guidelines to find it:

  • Apache web server:

    For Ubuntu with Apache, OPcache settings are typically located in php.ini.

    For CentOS with Apache or nginx, OPcache settings are typically located in /etc/php.d/opcache.ini

    If not, use the following command to locate it:

    1

    sudo find / -name 'opcache.ini'

  • nginx web server with PHP-FPM: /etc/php/7.2/fpm/php.ini

If you have more than one opcache.ini, modify all of them.

Step 2: How to set PHP options

To set PHP options:

  1. Open a php.ini in a text editor.
  2. Locate your server’s time zone in the available time zone settings

  3. Locate the following setting and uncomment it if necessary:

    1

    date.timezone =
  4. Add the time zone setting you found in step 2.

  5. Change the value of memory_limit to one of the values at the beginning of this section.

    For example,

    1

    memory_limit=2G
  6. Save your changes and exit the text editor.
  7. Open the other php.ini (if they are different) and make the same changes in it.

Step 3: Set OPcache options

To set opcache.ini options:

  1. Open your OPcache configuration file in a text editor:

    • opcache.ini (CentOS)
    • php.ini (Ubuntu)
    • /etc/php/7.2/fpm/php.ini (nginx web server (CentOS or Ubuntu))
  2. Locate opcache.save_comments and uncomment it if necessary.
  3. Make sure its value is set to 1.
  4. Save your changes and exit the text editor.

  5. Restart your web server:

    • Apache, Ubuntu: service apache2 restart
    • Apache, CentOS: service httpd restart
    • nginx, Ubuntu and CentOS: service nginx restart
© 2020 Magento. All rights reserved.