#270 #263 Enable/Disable PHP Modules

docker-compose.yml

@@ -125,6 +125,12 @@ services:
       ##
       - TIMEZONE
 
+      ##
+      ## Enable/Disable PHP Modules
+      ##
+      - ENABLE_MODULES=${PHP_MODULES_ENABLE}
+      - DISABLE_MODULES=${PHP_MODULES_DISABLE}
+
       ##
       ## Mail-catching
       ##

docs/configuration-files/env-file.rst

@@ -1127,6 +1127,51 @@ Container settings
 PHP
 ---
 
+PHP_MODULES_ENABLE
+^^^^^^^^^^^^^^^^^^
+
+Enable any non-standard PHP modules in a comma separated list.
+
++------------------------+--------------------------------------+------------------+
+| Name                   | Allowed values                       | Default value    |
++========================+======================================+==================+
+| ``PHP_MODULES_ENABLE`` | comma separated list of module names | empty            |
++------------------------+--------------------------------------+------------------+
+
+.. note::
+    Currently only ``ioncube`` is available to enable.
+
+Example:
+
+.. code-block:: bash
+   :caption: .env
+   :name: .env
+   :emphasize-lines: 2
+
+   # Enable ionCube
+   PHP_MODULES_ENABLE=ioncube
+
+PHP_MODULES_DISABLE
+^^^^^^^^^^^^^^^^^^^
+
+Disable any PHP modules in a comma separated list.
+
++-------------------------+--------------------------------------+------------------+
+| Name                    | Allowed values                       | Default value    |
++=========================+======================================+==================+
+| ``PHP_MODULES_DISABLE`` | comma separated list of module names | empty            |
++-------------------------+--------------------------------------+------------------+
+
+Example:
+
+.. code-block:: bash
+   :caption: .env
+   :name: .env
+   :emphasize-lines: 2
+
+   # Disable Xdebug, Imagick and Swoole
+   PHP_MODULES_DISABLE=xdebug,imagick,swoole
+
 Custom variables
 ^^^^^^^^^^^^^^^^
 

env-example

@@ -149,7 +149,6 @@ TIMEZONE=Europe/Berlin
 DNS_CHECK_TIMEOUT=1
 
 
-
 ###
 ### Devilbox UI SSL Certificate generation
 ###
@@ -164,7 +163,6 @@ DNS_CHECK_TIMEOUT=1
 DEVILBOX_UI_SSL_CN=localhost,*.localhost,devilbox,*.devilbox
 
 
-
 ###
 ### Devilbox UI Password protection enable/disable (1/0)
 ###
@@ -341,6 +339,7 @@ MONGO_SERVER=3.7
 ###
 HOST_PATH_HTTPD_DATADIR=./data/www
 
+
 ###
 ### Local filesystem path to mysql/mariadb datadir.
 ###
@@ -412,9 +411,30 @@ HOST_PATH_MONGO_DATADIR=./data/mongo
 ###
 ################################################################################
 
-# None
+###
-#
+### Enable certain PHP modules which are not enabled by default
-# Configure everything about PHP in cfg/php-fpm-X.X/*.ini
+###
+### Currently the only module that can be enabled is 'ioncube'
+###
+### PHP_MODULES_ENABLE=ioncube
+###
+PHP_MODULES_ENABLE=
+
+
+###
+### Disable any PHP modules that you don't require
+###
+### Specify a comma separated list without spaces of modules to disable
+###
+### PHP_MODULES_DISABLE=xdebug,imagick,swoole
+###
+PHP_MODULES_DISABLE=
+
+
+###
+### Configure everything else about PHP in
+### * cfg/php-ini-X.X/*.ini
+### * cfg/php-fpm-X.X/*.conf
 
 
 
@@ -430,6 +450,7 @@ HOST_PATH_MONGO_DATADIR=./data/mongo
 HOST_PORT_HTTPD=80
 HOST_PORT_HTTPD_SSL=443
 
+
 ###
 ### Document Root Subdirectory
 ###
@@ -440,6 +461,7 @@ HOST_PORT_HTTPD_SSL=443
 ###
 HTTPD_DOCROOT_DIR=htdocs
 
+
 ###
 ### Per vHost Config Subdirectory
 ###
@@ -469,11 +491,13 @@ HTTPD_TEMPLATE_DIR=.devilbox
 ###
 MYSQL_ROOT_PASSWORD=
 
+
 ###
 ### Custom MySQL Runtime Settings
 ###
 MYSQL_GENERAL_LOG=0
 
+
 ###
 ### Expose MySQL Port to Host
 ###
@@ -492,11 +516,13 @@ HOST_PORT_MYSQL=3306
 ###
 PGSQL_ROOT_USER=postgres
 
+
 ###
 ### PostgreSQL 'root' user password
 ###
 PGSQL_ROOT_PASSWORD=
 
+
 ###
 ### Expose PostgreSQL Port to Host
 ###
@@ -570,6 +596,7 @@ BIND_DNS_RESOLVER=8.8.8.8,8.8.4.4
 ###
 BIND_DNSSEC_VALIDATE=no
 
+
 ###
 ### Bind timing options (time in seconds)
 ###
@@ -582,6 +609,7 @@ BIND_RETRY_TIME=
 BIND_EXPIRY_TIME=
 BIND_MAX_CACHE_TIME=
 
+
 ###
 ### Show DNS Queries in Docker logs output?
 ###
@@ -605,6 +633,7 @@ BIND_LOG_DNS_QUERIES=0
 ### them via: <?php getenv('MY_APPLICATION_ENV'); ?>
 ###
 
+
 ###
 ### Example:
 ### <?php echo getenv('Foo'); ?> would produce: 'some value'