[ci skip] Update UG for changes

Author: MGatner

user_guide_src/source/changelogs/v4.1.2.rst

@@ -5,6 +5,13 @@ Release Date: Not released
 
 **4.1.2 release of CodeIgniter4**
 
+BREAKING:
+
+Fixed `a bug <https://github.com/codeigniter4/CodeIgniter4/issues/4116>`_ in ``current_url()`` that prevented
+configurations with an ``indexPage`` from including that value in the return value. Any installations
+using ``App::$indexPage`` should expect altered values from ``current_url()`` and all its dependencies
+(including Response Testing, Pager, Form Helper, Pager, and View Parser).
+
 Enhancements:
 
 - New HTTP classes, ``Cookie`` and ``CookieStore``, for abstracting web cookies.

user_guide_src/source/helpers/url_helper.rst

@@ -81,9 +81,10 @@ The following functions are available:
     This would give you something like:
     *http://example.com/images/icons/edit.png*
 
-.. php:function:: current_url([$returnObject = false])
+.. php:function:: current_url([$returnObject = false[, $request = null]])
 
     :param	boolean	$returnObject: True if you would like a URI instance returned, instead of a string.
+    :param	IncomingRequest|null	$request: An alternate request to use for path detection; useful for testing.
     :returns: The current URL
     :rtype:	string|\\CodeIgniter\\HTTP\\URI
 
@@ -93,7 +94,9 @@ The following functions are available:
     .. note:: Calling this function is the same as doing this:
         ::
 
-            base_url(uri_string());
+            site_url(uri_string());
+
+.. important:: Prior to **4.1.2** this function had a bug causing it to ignore the configuration on ``App::$indexPage``.
 
 .. php:function:: previous_url([$returnObject = false])
 

user_guide_src/source/libraries/uri.rst

@@ -31,17 +31,17 @@ into its appropriate sections::
 The Current URI
 ---------------
 
-Many times, all you really want is an object representing the current URL of this request. This can be accessed
-in two different ways. The first is to grab it directly from the current request object. Assuming that you're in
-a controller that extends ``CodeIgniter\Controller`` you can get it like::
-
-	$uri = $this->request->uri;
-
-Second, you can use one of the functions available in the **url_helper**::
+Many times, all you really want is an object representing the current URL of this request.
+You can use one of the functions available in the **url_helper**::
 
 	$uri = current_url(true);
-
+	
 You must pass ``true`` as the first parameter, otherwise, it will return the string representation of the current URL.
+This URI is based on the path (relative to your ``baseURL``) as determined by the current request object and
+your settings in ``Config\App`` (baseURL, indexPage, and forceGlobalSecureRequests).
+Assuming that you're in a controller that extends ``CodeIgniter\Controller`` you can get this relative path::
+
+	$path = $this->request->getPath();
 
 ===========
 URI Strings
@@ -51,7 +51,7 @@ Many times, all you really want is to get a string representation of a URI. This
 the URI as a string::
 
 	$uri = current_url(true);
-	echo (string)$uri;  // http://example.com
+	echo (string) $uri;  // http://example.com/index.php
 
 If you know the pieces of the URI and just want to ensure it's all formatted correctly, you can generate a string
 using the URI class' static ``createURIString()`` method::