Fix #361: Disable swoole by default

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:

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
 ===============
 

env-example

@@ -454,7 +454,7 @@ PHP_MODULES_ENABLE=
 ###
 ### PHP_MODULES_DISABLE=xdebug,imagick,swoole
 ###
-PHP_MODULES_DISABLE=
+PHP_MODULES_DISABLE=swoole
 
 
 ###