From 0a2ff37fa145147f36deaa223ab6109a7c6a77de Mon Sep 17 00:00:00 2001
From: cytopia <cytopia@everythingcli.org>
Date: Fri, 24 Aug 2018 09:28:51 +0200
Subject: [PATCH] Fix #361: Disable swoole by default

---
 docs/configuration-files/env-file.rst |  2 +-
 docs/support/troubleshooting.rst      | 19 +++++++++++++++++++
 env-example                           |  2 +-
 3 files changed, 21 insertions(+), 2 deletions(-)

diff --git a/docs/configuration-files/env-file.rst b/docs/configuration-files/env-file.rst
index 91d3ba74..84a96583 100644
--- a/docs/configuration-files/env-file.rst
+++ b/docs/configuration-files/env-file.rst
@@ -1203,7 +1203,7 @@ Disable any PHP modules in a comma separated list.
 +-------------------------+--------------------------------------+------------------+
 | Name                    | Allowed values                       | Default value    |
 +=========================+======================================+==================+
-| ``PHP_MODULES_DISABLE`` | comma separated list of module names | empty            |
+| ``PHP_MODULES_DISABLE`` | comma separated list of module names | ``swoole``       |
 +-------------------------+--------------------------------------+------------------+
 
 Example:
diff --git a/docs/support/troubleshooting.rst b/docs/support/troubleshooting.rst
index e96c9098..f4aa3d42 100644
--- a/docs/support/troubleshooting.rst
+++ b/docs/support/troubleshooting.rst
@@ -217,6 +217,25 @@ For that to fix one must increase the PHP-FPM/Proxy timeout settings in the ``.e
    * https://github.com/cytopia/devilbox/issues/234
 
 
+PHP issues
+==========
+
+Fatal error: Cannot redeclare go()
+----------------------------------
+
+If you encounter this error, it is most likely that your current project declares the
+PHP function ``go()`` and that you have enabled the ``swoole`` module which also provides
+an implementation of that function.
+
+To mitigate that issue, make sure that the ``swoole`` module is disabled in ``.env``.
+
+
+.. seealso::
+
+   * :ref:`env_file_php_modules_disable`
+   * https://github.com/getkirby/kirby/issues/643
+
+
 Database issues
 ===============
 
diff --git a/env-example b/env-example
index 096a9eda..0a238bf0 100644
--- a/env-example
+++ b/env-example
@@ -454,7 +454,7 @@ PHP_MODULES_ENABLE=
 ###
 ### PHP_MODULES_DISABLE=xdebug,imagick,swoole
 ###
-PHP_MODULES_DISABLE=
+PHP_MODULES_DISABLE=swoole
 
 
 ###