PHP upgrade for 5.6 and 7.0 on RHEL/CentOS

admin_manual/installation/index.rst

@@ -12,5 +12,7 @@ Installation
    command_line_installation
    apps_management_installation
    apps_supported
+   php_56_installation
+   php_70_installation
    selinux_configuration
    nginx

admin_manual/installation/php_56_installation.rst

@@ -0,0 +1,90 @@
+.. _label-php56installation:
+
+=============================================
+Installing PHP 5.6 on RHEL 6/7 and CentOS 6/7
+=============================================
+
+Red Hat Enterprise Linux and CentOS 6 still ship with PHP 5.3. Nextcloud 
+requires PHP 5.6 or better. There are several third-party repositories that 
+supply PHP 5.6, but you must use the Software Collections (SCL) repository to 
+be in compliance with your RHEL support contract, and not any other third-party 
+repository.
+
+RHEL 6
+------
+
+Follow these steps to install PHP 5.6 from SCL. First you must use 
+your Subscription Manager to enable SCL in RHEL 6::
+
+ subscription-manager repos --enable rhel-server-rhscl-6-eus-rpms
+
+For RHEL 7::
+
+ subscription-manager repos --enable rhel-server-rhscl-7-eus-rpms
+
+Then install PHP 5.6 and these modules::
+
+ yum install rh-php56 rh-php56-php rh-php56-php-gd rh-php56-php-mbstring
+
+You must also install the updated database module for your database. This 
+installs the new PHP 5.6 module for MySQL/MariaDB:: 
+
+ yum install rh-php56-php-mysqlnd
+
+If you are using the Nextcloud LDAP app, you need this module::
+
+ yum install rh-php56-php-ldap
+
+Disable loading the old PHP 5.3 Apache module:: 
+
+ mv /etc/httpd/conf.d/php.conf /etc/httpd/conf.d/php53.off
+
+Copy the PHP 5.6 Apache modules into place::
+
+ cp /opt/rh/httpd24/root/etc/httpd/conf.d/rh-php56-php.conf /etc/httpd/conf.d/
+ cp /opt/rh/httpd24/root/etc/httpd/conf.modules.d/10-rh-php56-php.conf /etc/httpd/conf.modules.d/
+ cp /opt/rh/httpd24/root/etc/httpd/modules/librh-php56-php5.so /etc/httpd/modules/
+
+Then restart Apache::
+
+ service httpd restart
+
+Verify with :ref:`label-phpinfo` that your Apache server is using PHP 5.6 and loading 
+the correct modules.
+
+CentOS 6/7
+----------
+
+First install the SCL repo::
+
+ yum install centos-release-scl
+
+Then install PHP 5.6 and these modules:: 
+
+ yum install rh-php56 rh-php56-php rh-php56-php-gd rh-php56-php-mbstring
+
+You must also install the updated database module for your database. This 
+installs the new PHP 5.6 module for MySQL/MariaDB:: 
+
+ yum install rh-php56-php-mysqlnd
+
+If you are using the Nextcloud LDAP app, you need this module::
+
+ yum install rh-php56-php-ldap
+
+Disable loading the old PHP 5.3 Apache module:: 
+
+ mv /etc/httpd/conf.d/php.conf /etc/httpd/conf.d/php53.off
+
+Copy the PHP 5.6 Apache modules into place::
+
+ cp /opt/rh/httpd24/root/etc/httpd/conf.d/rh-php56-php.conf /etc/httpd/conf.d/
+ cp /opt/rh/httpd24/root/etc/httpd/conf.modules.d/10-rh-php56-php.conf /etc/httpd/conf.modules.d/
+ cp /opt/rh/httpd24/root/etc/httpd/modules/librh-php56-php5.so /etc/httpd/modules/
+
+Finally, restart Apache::
+
+ service httpd restart
+
+Verify with :ref:`label-phpinfo` that your Apache server is using PHP 5.6 and loading 
+the correct modules.

admin_manual/installation/php_70_installation.rst

@@ -0,0 +1,86 @@
+=========================================
+Installing PHP 7.0 on RHEL 7 and CentOS 7
+=========================================
+
+PHP 5.4 has been end-of-life since September 2015 and is no longer supported by the PHP team. RHEL 7 still ships with PHP 5.4, and Red Hat supports it. Nextcloud 11+ requires PHP 5.6 or better, so upgrading to 5.6 is required. For more information see :ref:`label-php56installation`. However, it is highly recommended to upgrade to PHP 7.0+ for best security and performance. 
+
+**Before upgrading, evaluate all of your PHP apps for compatibility with PHP 7.0.**
+
+RHEL 7 Upgrade to PHP 7.0
+-------------------------
+
+To upgrade to PHP 7.0, you must use the Software Collections (SCL) repository to be in compliance with your RHEL support contract, and not any other third-party repository. Follow these steps to install PHP 7.0 from SCL. First you must use your Subscription Manager to enable SCL::
+
+ subscription-manager repos --enable rhel-server-rhscl-7-eus-rpms
+
+Then install PHP 7.0 and these modules::
+
+ yum install rh-php70 rh-php70-php rh-php70-php-gd rh-php70-php-mbstring
+
+You must also install the updated database module for your database. This installs the new PHP 7.0 module for MySQL/MariaDB:: 
+
+ yum install rh-php70-php-mysqlnd
+
+If you are using the Nextcloud LDAP app, you need this module::
+
+ yum install rh-php70-php-ldap
+
+Disable loading the old PHP Apache modules by changing their names::
+
+ mv /etc/httpd/conf.d/php.conf /etc/httpd/conf.d/php54.off
+ mv /etc/httpd/conf.modules.d/10-php.conf /etc/httpd/conf.modules.d/10-php54.off
+
+Copy the PHP 7.0 Apache modules into place::
+
+ cp /opt/rh/httpd24/root/etc/httpd/conf.d/rh-php70-php.conf /etc/httpd/conf.d/
+ cp /opt/rh/httpd24/root/etc/httpd/conf.modules.d/15-rh-php70-php.conf /etc/httpd/conf.modules.d/
+ cp /opt/rh/httpd24/root/etc/httpd/modules/librh-php70-php7.so /etc/httpd/modules/
+
+Then restart Apache::
+
+ service httpd restart
+
+Verify with ``phpinfo`` that your Apache server is using PHP 7.0 and loading the 
+correct modules; see :ref:`label-phpinfo` to learn how to use phpinfo.
+
+
+CentOS 7 Upgrade to PHP 7.0
+---------------------------
+
+To upgrade to PHP 7.0, use the Red Hat Software Collections (SCL) repository.
+
+**Before upgrading, evaluate all of your PHP apps for compatibility with PHP 7.0.**
+
+Follow these steps to install PHP 7.0 from SCL. First install the SCL repository::
+
+ yum install centos-release-scl
+
+Then install PHP 7.0 and these modules::
+
+ yum install rh-php70 rh-php70-php rh-php70-php-gd rh-php70-php-mbstring
+
+You must also install the updated database module for your database. This installs the new PHP 7.0 module for MySQL/MariaDB:: 
+
+ yum install rh-php70-php-mysqlnd
+
+If you are using the Nextcloud LDAP app, you need this module::
+
+ yum install rh-php70-php-ldap 
+
+Disable loading the old PHP Apache modules by changing their names::
+
+ mv /etc/httpd/conf.d/php.conf /etc/httpd/conf.d/php54.off
+ mv /etc/httpd/conf.modules.d/10-php.conf /etc/httpd/conf.modules.d/10-php54.off
+
+Copy the PHP 7.0 Apache modules into place::
+
+ cp /opt/rh/httpd24/root/etc/httpd/conf.d/rh-php70-php.conf /etc/httpd/conf.d/
+ cp /opt/rh/httpd24/root/etc/httpd/conf.modules.d/15-rh-php70-php.conf /etc/httpd/conf.modules.d/
+ cp /opt/rh/httpd24/root/etc/httpd/modules/librh-php70-php7.so /etc/httpd/modules/
+
+Then restart Apache::
+
+ service httpd restart
+
+Verify with ``phpinfo`` that your Apache server is using PHP 7.0 and loading the 
+correct modules; see :ref:`label-phpinfo` to learn how to use ``phpinfo``.