Merge pull request #6296 from kenjis/improve-docs-server-config

docs: improve Web server config page

Author: kenjis

user_guide_src/source/general/environments.rst

@@ -41,6 +41,8 @@ The simplest method to set the variable is in your :doc:`.env file </general/con
 
     > php spark env production
 
+.. _environment-apache:
+
 Apache
 ------
 
@@ -51,6 +53,9 @@ config using `SetEnv <https://httpd.apache.org/docs/2.2/mod/mod_env.html#setenv>
 
     SetEnv CI_ENVIRONMENT development
 
+
+.. _environment-nginx:
+
 nginx
 -----
 

user_guide_src/source/general/urls.rst

@@ -60,6 +60,8 @@ By default, the **index.php** file will be included in your URLs::
 If your server supports rewriting URLs you can easily remove this file with URL rewriting. This is handled differently
 by different servers, but we will show examples for the two most common web servers here.
 
+.. _urls-remove-index-php-apache:
+
 Apache Web Server
 -----------------
 
@@ -81,6 +83,8 @@ request for your index.php file.
 
 .. note:: Make sure to also exclude from the above rules any assets that you might need to be accessible from the outside world.
 
+.. _urls-remove-index-php-nginx:
+
 NGINX
 -----
 

user_guide_src/source/installation/index.rst

@@ -26,7 +26,7 @@ However you choose to install and run CodeIgniter4, the
     installing_composer
     installing_manual
     running
+    troubleshooting
     ../changelogs/index
     upgrading
-    troubleshooting
     repositories

user_guide_src/source/installation/running.rst

@@ -99,6 +99,11 @@ in the "AllowOverride" setting::
         Require all granted
     </Directory>
 
+Removing the index.php
+----------------------
+
+See :ref:`CodeIgniter URLs <urls-remove-index-php-apache>`.
+
 Virtual Hosting
 ---------------
 
@@ -195,6 +200,11 @@ Be sure to specify options and permissions for the CodeIgniter public directory
         </Directory>
     </IfModule>
 
+Setting Environment
+-------------------
+
+See :ref:`Handling Multiple Environments <environment-apache>`.
+
 Testing
 -------
 
@@ -204,9 +214,13 @@ Apache needs to be restarted whenever you change its configuration.
 
 Hosting with Nginx
 ==================
+
 Nginx is the second most widely used HTTP server for web hosting.
 Here you can find an example configuration using PHP 7.3 FPM (unix sockets) under Ubuntu Server.
 
+default.conf
+------------
+
 This configuration enables URLs without "index.php" in them and using CodeIgniter's "404 - File Not Found" for URLs ending with ".php".
 
 .. code-block:: nginx
@@ -241,6 +255,11 @@ This configuration enables URLs without "index.php" in them and using CodeIgnite
         }
     }
 
+Setting Environment
+-------------------
+
+See :ref:`Handling Multiple Environments <environment-nginx>`.
+
 Hosting with Vagrant
 ====================
 

user_guide_src/source/installation/troubleshooting.rst

@@ -4,6 +4,10 @@ Troubleshooting
 
 Here are some common installation problems, and suggested workarounds.
 
+.. contents::
+    :local:
+    :depth: 2
+
 How do I know if my install is working?
 ---------------------------------------