devilbox/docs/configuration-files/php-ini.rst

124 lines
3.6 KiB
ReStructuredText
Raw Normal View History

2018-04-01 15:15:49 +00:00
.. _php_ini:
*******
php.ini
*******
2018-04-04 06:55:55 +00:00
``php.ini`` changes are global to all projects, but will only affect the currently selected
PHP version.
2018-04-01 15:15:49 +00:00
**Table of Contents**
.. contents:: :local:
2018-04-01 19:46:56 +00:00
General
=======
2018-04-01 15:15:49 +00:00
You can set custom php.ini configuration options for each PHP version separately.
2018-04-05 07:09:38 +00:00
See the directory structure for PHP configuration directories inside ``./cfg/`` directory:
2018-04-01 15:15:49 +00:00
2018-04-05 07:09:38 +00:00
.. code-block:: bash
2018-06-03 18:45:01 +00:00
host> ls -l path/to/devilbox/cfg/ | grep 'php-ini'
2018-04-05 07:09:38 +00:00
2018-08-04 11:59:31 +00:00
drwxr-xr-x 2 cytopia cytopia 4096 Mar 5 21:53 php-ini-5.2/
2018-06-03 18:45:01 +00:00
drwxr-xr-x 2 cytopia cytopia 4096 Mar 5 21:53 php-ini-5.3/
drwxr-xr-x 2 cytopia cytopia 4096 Mar 5 21:53 php-ini-5.4/
drwxr-xr-x 2 cytopia cytopia 4096 Mar 5 21:53 php-ini-5.5/
drwxr-xr-x 2 cytopia cytopia 4096 Apr 3 22:04 php-ini-5.6/
drwxr-xr-x 2 cytopia cytopia 4096 Mar 5 21:53 php-ini-7.0/
drwxr-xr-x 2 cytopia cytopia 4096 Mar 5 21:53 php-ini-7.1/
drwxr-xr-x 2 cytopia cytopia 4096 Mar 5 21:53 php-ini-7.2/
drwxr-xr-x 2 cytopia cytopia 4096 Mar 5 21:53 php-ini-7.3/
2018-11-02 21:55:15 +00:00
drwxr-xr-x 2 cytopia cytopia 4096 Mar 5 21:53 php-ini-7.4/
2018-04-05 07:09:38 +00:00
2018-04-07 16:46:37 +00:00
Customization is achieved by placing a file into ``cfg/php-ini-X.X/`` (where ``X.X`` stands for
2018-04-05 07:09:38 +00:00
your PHP version). The file must end by ``.ini`` in order to be sourced by the PHP-FPM server.
2018-04-01 15:15:49 +00:00
Each of the PHP ini configuration directories already contains two example files:
``devilbox-php.ini-default`` and ``devilbox-php.ini-xdebug``.
**devilbox-php.ini-default**
This file holds the exact settings that are currently in place by each PHP-FPM container.
Copy it (do not simply rename it) to a different file ending by ``.ini`` and start adjusting it.
**devilbox-php.ini-xdebug**
This file holds some sane example configuration to get you started with Xdebug.
Copy it (do not simply rename it) to a different file ending by ``.ini`` and start adjusting it.
.. important:: For Xdebug to work, there are other changes requires as well: :ref:`configure_php_xdebug`
**How to apply the settings**
2018-04-01 15:15:49 +00:00
In order for the changes to be applied, you will have to restart the Devilbox.
Examples
========
Change memory_limit for PHP 7.1
-------------------------------
The following examples shows you how to change the
`memory_limit <https://secure.php.net/manual/en/ini.core.php#ini.memory-limit>`_ of PHP 7.1 to
4096 MB.
.. code-block:: bash
2018-06-03 18:45:01 +00:00
# Navigate to the Devilbox directory
host> cd path/to/devilbox
2018-04-01 15:15:49 +00:00
2018-06-03 18:45:01 +00:00
# Navigate to PHP 7.1 config directory
host> cd cfg/php-ini-7.1
2018-04-01 15:15:49 +00:00
2018-06-03 18:45:01 +00:00
# Create new ini file
host> touch memory_limit.ini
2018-04-01 15:15:49 +00:00
Now add the following content to the file:
.. code-block:: ini
2018-06-03 18:45:01 +00:00
:caption: memory_limit.ini
2018-04-01 15:15:49 +00:00
2018-06-03 18:45:01 +00:00
[PHP]
memory_limit = 4096M
2018-04-01 15:15:49 +00:00
In order to apply the changes you need to restart the Devilbox.
You can validate that the changes have taken place by visiting the Devilbox intranet phpinfo page.
Change timeout values for PHP 5.6
---------------------------------
The following examples shows you how to change the
`max_execution_time <https://secure.php.net/manual/en/info.configuration.php#ini.max-execution-time>`_
and `max_input_time <https://secure.php.net/manual/en/info.configuration.php#ini.max-input-time>`_
of PHP 5.6.
.. code-block:: bash
2018-06-03 18:45:01 +00:00
# Navigate to the Devilbox directory
host> cd path/to/devilbox
2018-04-01 15:15:49 +00:00
2018-06-03 18:45:01 +00:00
# Navigate to PHP 5.6 config directory
host> cd cfg/php-ini-5.6
2018-04-01 15:15:49 +00:00
2018-06-03 18:45:01 +00:00
# Create new ini file
host> touch timeouts.ini
2018-04-01 15:15:49 +00:00
Now add the following content to the file:
.. code-block:: ini
2018-06-03 18:45:01 +00:00
:caption: timeouts.ini
2018-04-01 15:15:49 +00:00
2018-06-03 18:45:01 +00:00
[PHP]
max_execution_time = 180
max_input_time = 180
2018-04-01 15:15:49 +00:00
In order to apply the changes you need to restart the Devilbox.
You can validate that the changes have taken place by visiting the Devilbox intranet phpinfo page.