PHP

This page details how to install PHP for both CentOS and Ubuntu systems.

Magento 2.3.1 supports PHP 7.2.11. All 3rd party libraries now support PHP 7.2. If you are interested in participating in Magento Community projects we welcome your help! See our ZenHub board for a full list of outstanding issues.

Supported PHP versions

  • ~7.1.3

  • ~7.2.0

Magento 2.3.1 is certified and tested on PHP 7.2.11.

If you must install both Apache and PHP, install Apache first.

PHP for CentOS

The following sections give you all the info you need to install PHP for CentOS.

Verify PHP is installed

To verify if PHP is installed already, enter php -v. If PHP is installed, a message similar to the following displays:

PHP 7.1.6 (cli) (built: Jan  9 2017 09:23:16) ( NTS )
Copyright (c) 1997-2017 The PHP Group
Zend Engine v3.1.0, Copyright (c) 1998-2017 Zend Technologies with Zend OPcache v7.1.6, Copyright (c) 1999-2017, by Zend Technologies

The preceding message confirms that the Zend OPcache is installed. We strongly recommend using the OPcache for performance reasons. If your PHP distribution does not come with the OPcache, see the PHP OPcache documentation.

If PHP is installed, continue with the next prerequisite, MySQL.

If PHP is not installed, see the PHP 7.1 on CentOS section.

CentOS repositories

Linux systems provide software like PHP in one or more repositories. CentOS, unlike Ubuntu, has a set of officially recommended repositories. Other repositories are considered less safe for the reasons stated on the CentOS wiki.

We’re not aware that you can install PHP 7.1 or 7.2 from a CentOS-recommended repository. Therefore, you must consider the following:

  • If you’re setting up a system that will be deployed in production, you should choose a hosting provider who uses repositories considered to be safe and reliable.

You should also consider upgrading to a later version of CentOS that has the desired PHP version in a recommended repository.

  • If you’re setting up a development system, you can use any repository you wish.

In this topic, we show how to install PHP using the Inline with Upstream Stable (IUS) repository, which is not on the CentOS recommended list. However, packages installed from IUS do not use the same names as CentOS-provided packages, so no existing system packages are replaced.

Before you continue, review their Getting Started topic.

Magento does not officially recommend using the IUS repository. We discuss it here for example purposes only.

PHP 7.1 on CentOS

There is more than one way to install PHP 7.1 on CentOS; the following is a suggestion only. Consult a reference for additional options.

To install PHP 7.1 on CentOS 6 or 7:

  1. CentOS 6. Enter the following commands in the order shown:

yum -y update yum -y install epel-release wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm wget https://centos6.iuscommunity.org/ius-release.rpm rpm -Uvh ius-release*.rpm yum -y update

CentOS 7. Enter the following commands:

yum install -y http://dl.iuscommunity.org/pub/ius/stable/CentOS/7/x86_64/ius-release-1.0-14.ius.centos7.noarch.rpm yum -y update

  1. Install all required PHP extensions:

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

  1. Restart Apache:

service httpd restart`

  1. Verify that PHP 7.1 is installed properly:

php -v

The following response indicates that PHP 7.1.6 is installed:

PHP 7.1.6 (cli) (built: Jan 9 2017 09:23:16) ( NTS ) Copyright (c) 1997-2017 The PHP Group Zend Engine v3.1.0, Copyright (c) 1998-2017 Zend Technologies with Zend OPcache v7.1.6, Copyright (c) 1999-2017, by Zend Technologies

The preceding message confirms that the Zend OPcache is installed. We strongly recommend using the OPcache for performance reasons. If your PHP distribution does not come with the OPcache, see the PHP OPcache documentation.

  1. Verify that all required PHP extensions were installed:
php -me

You should see output similar to the following:

[PHP Modules]
bcmath
calendar
Core
ctype
curl
date
dom
exif
fileinfo
filter
ftp
gd
gettext
hash
iconv
intl
json
libxml
mbstring
mysqli
mysqlnd
openssl
pcntl
pcre
PDO
pdo_mysql
Phar
readline
Reflection
session
SimpleXML
soap
sockets
SPL
standard
tokenizer
wddx
xml
xmlreader
xmlwriter
xsl
Zend OPcache
zip
zlib

[Zend Modules]
Zend OPcache
  1. Continue with Required PHP settings.

PHP for Ubuntu

The following sections give you all the info you need to install PHP for Ubuntu.

Verify PHP is installed

To verify if PHP is installed already, enter php -v. If PHP is installed, a message similar to the following displays:

PHP 7.1.7-1~ubuntu14.04.1+deb.sury.org+1 (cli) (built: Jul  6 2017 09:07:54) ( NTS )
Copyright (c) 1997-2017 The PHP Group
Zend Engine v3.1.0, Copyright (c) 1998-2017 Zend Technologies with Zend OPcache v7.1.7-1~ubuntu14.04.1+deb.sury.org+1, Copyright (c) 1999-2017, by Zend Technologies

The preceding message confirms that the Zend OPcache is installed. We strongly recommend using the OPcache for performance reasons. If your PHP distribution does not come with OPcache, see the PHP OPcache documentation

If PHP is installed, continue with the next prerequisite, MySQL.

If PHP is not installed see the next section, PHP 7.1 on Ubuntu.

PHP 7.1 on Ubuntu

To install PHP 7.1 on Ubuntu 14 or 16:

  1. Enter the following commands in the order shown:
sudo apt-get -y update
sudo add-apt-repository ppa:ondrej/php
sudo apt-get -y update
sudo apt-get install -y php7.1 libapache2-mod-php7.1 php7.1-common php7.1-gd php7.1-mysql php7.1-curl php7.1-intl php7.1-xsl php7.1-mbstring php7.1-zip php7.1-bcmath php7.1-iconv php7.1-soap

The last command installs all required PHP extensions.

  1. Verify that PHP 7.1 is installed properly:
php -v

The following response indicates that PHP 7.1.7 is installed:

PHP 7.1.7-1~ubuntu14.04.1+deb.sury.org+1 (cli) (built: Jul  6 2017 09:07:54) ( NTS )
Copyright (c) 1997-2017 The PHP Group
Zend Engine v3.1.0, Copyright (c) 1998-2017 Zend Technologies with Zend OPcache v7.1.7-1~ubuntu14.04.1+deb.sury.org+1,Copyright (c) 1999-2017, by Zend Technologies

The preceding message confirms that the Zend OPcache is installed. We strongly recommend using the OPcache for performance reasons. If your PHP distribution does not come with the OPcache, see the PHP OPcache documentation.

  1. Verify that all required PHP extensions were installed:
php -me

You should see output similar to the following:

[PHP Modules]
bcmath
calendar
Core
ctype
curl
date
dom
exif
fileinfo
filter
ftp
gd
gettext
hash
iconv
intl
json
libxml
mbstring
mysqli
mysqlnd
openssl
pcntl
pcre
PDO
pdo_mysql
Phar
readline
Reflection
session
SimpleXML
soap
sockets
SPL
standard
tokenizer
wddx
xml
xmlreader
xmlwriter
xsl
Zend OPcache
zip
zlib

[Zend Modules]
Zend OPcache

Next

Required PHP settings