docs: add docs

codeigniter4 · Dec 25, 2023 · 2715695 · 2715695
1 parent 0c01fbc
commit 2715695
Show file tree

Hide file tree

Showing 2 changed files with 13 additions and 4 deletions.
diff --git a/user_guide_src/source/changelogs/v4.5.0.rst b/user_guide_src/source/changelogs/v4.5.0.rst
@@ -346,6 +346,9 @@ Others
   existing CSP directives. See :ref:`csp-clear-directives`.
 - **HTTP:** Added ``Message::addHeader()`` method to add another header with
   the same name. See :php:meth:`CodeIgniter\\HTTP\\Message::addHeader()`.
+- **Web Page Caching:** ``ResponseCache`` has been improved to include the request
+  HTTP method in the cache key. This means that the same URI will be cached separately
+  if the HTTP method is different.
 
 Message Changes
 ***************

diff --git a/user_guide_src/source/general/caching.rst b/user_guide_src/source/general/caching.rst
@@ -20,11 +20,17 @@ How Does Caching Work?
 ======================
 
 Caching can be enabled on a per-page basis, and you can set the length
-of time that a page should remain cached before being refreshed. When a
-page is loaded for the first time, the page will be cached using the
+of time that a page should remain cached before being refreshed.
+
+.. note:: Per-page means per URI. Since v4.5.0, the HTTP method of the
+    request is also taken into account. This means that the same URI will be
+    cached separately if the HTTP method is different.
+
+When a page is loaded for the first time, the page will be cached using the
 currently configured cache engine. On subsequent page loads, the cache
-will be retrieved and sent to the requesting user's browser. If it has
-expired, it will be deleted and refreshed before being sent to the
+will be retrieved and sent to the requesting user's browser.
+
+If it has expired, it will be deleted and refreshed before being sent to the
 browser.
 
 .. note:: The Benchmark tag is not cached so you can still view your page