Add missing 5.3 feature documentation to topic pages (#8197)

* Add missing 5.3 feature documentation to topic pages

Several 5.3 features were only documented in the migration guide
without corresponding coverage in their topic pages. This adds
documentation with examples and version annotations for:

- Validation: ipOrRange() rule, existsInNullable() application rule
- Database: TypeFactory::getMapped(), Query::getDriver(), Entra auth
- Console: TreeHelper, CommandCollection::replace()
- Routing: RedirectTrait for custom redirect route classes
- I18n: DateTimePeriod, DatePeriod, Date::getTimestamp()
- View: ViewBuilder::setConfigMergeStrategy()

* Fix truncated code example in database-basics.md

The toPHP() method in the PointMutationType example was missing
the closing parenthesis, semicolon, and closing brace.

---------

Co-authored-by: Jasper Smet <josbeir@users.noreply.github.com>

Author: dereuromark

docs/en/console-commands/commands.md

@@ -313,6 +313,56 @@ class CleanupCommand extends Command
 Custom grouping support was added.
 :::
 
+## Replacing Commands
+
+`CommandCollection::replace()` allows you to replace an existing command in the
+collection without needing to remove and re-add it. This is particularly useful
+when using `autoDiscover` and you want to replace a command with a customized
+version:
+
+``` php
+// In your Application::console() method
+public function console(CommandCollection $commands): CommandCollection
+{
+    $commands = parent::console($commands);
+    $commands->replace('some_plugin_command', MyCustomCommand::class);
+
+    return $commands;
+}
+```
+
+::: info Added in version 5.3.0
+`CommandCollection::replace()` was added.
+:::
+
+## Tree Output Helper
+
+The `TreeHelper` outputs an array as a tree structure. This is useful for
+displaying filesystem directories or any hierarchical data:
+
+``` php
+public function execute(Arguments $args, ConsoleIo $io): int
+{
+    $helper = $io->helper('Tree');
+    $helper->output([
+        'src' => [
+            'Controller',
+            'Model',
+            'View',
+        ],
+        'tests' => [
+            'TestCase',
+        ],
+    ]);
+
+    return static::CODE_SUCCESS;
+}
+```
+
+::: info Added in version 5.3.0
+The `TreeHelper` was added.
+:::
+
 <a id="console-integration-testing"></a>
 
 ## Testing Commands

docs/en/controllers.md

@@ -202,6 +202,31 @@ $this->viewBuilder()
 The above shows how you can load custom helpers, set the theme and use a custom
 view class.
 
+#### Config Merge Strategy
+
+By default, view options set via `ViewBuilder` are deep-merged with the View
+class's default configuration. You can control this behavior using
+`setConfigMergeStrategy()`:
+
+``` php
+use Cake\View\ViewBuilder;
+
+$this->viewBuilder()
+    ->setConfigMergeStrategy(ViewBuilder::MERGE_SHALLOW)
+    ->setOption('customArray', ['a', 'b', 'c']);
+```
+
+Available strategies are:
+
+- `ViewBuilder::MERGE_DEEP` - Recursive merge (default). Nested arrays are merged together.
+- `ViewBuilder::MERGE_SHALLOW` - Simple array merge. Array values are replaced rather than deep-merged.
+
+You can retrieve the current strategy using `getConfigMergeStrategy()`.
+
+::: info Added in version 5.3.0
+`ViewBuilder::setConfigMergeStrategy()` and `ViewBuilder::getConfigMergeStrategy()` were added.
+:::
+
 ### Rendering a View
 
 `method` Cake\\Controller\\Controller::**render**(string $view, string $layout): Response

docs/en/core-libraries/time.md

@@ -495,6 +495,50 @@ time and timezones. The `Date` class wraps the `Cake\Chronos\ChronosDate` class.
 > So you cannot cannot directly compare a `Date` instance with a `DateTime` instance.
 > But you can do comparisons like `$dateTime->toNative() > $date->toNative()`.
 
+### Date::getTimestamp()
+
+`method` Cake\\I18n\\Date::**getTimestamp**(): int
+
+Returns an integer timestamp for the date:
+
+``` php
+$date = new Date('2021-01-31');
+echo $date->getTimestamp();
+```
+
+::: info Added in version 5.3.0
+`Date::getTimestamp()` was added.
+:::
+
+## DateTimePeriod and DatePeriod
+
+`class` Cake\\I18n\\**DateTimePeriod**
+
+`class` Cake\\I18n\\**DatePeriod**
+
+CakePHP provides `DateTimePeriod` and `DatePeriod` classes that wrap PHP's
+`DatePeriod`. When iterating, `DateTimePeriod` returns `DateTime` instances
+and `DatePeriod` returns `Date` instances:
+
+``` php
+use Cake\I18n\DateTime;
+use Cake\I18n\DateTimePeriod;
+
+$start = new DateTime('2021-01-01');
+$end = new DateTime('2021-01-05');
+$interval = new \DateInterval('P1D');
+
+$period = new DateTimePeriod($start, $interval, $end);
+foreach ($period as $date) {
+    // $date is a Cake\I18n\DateTime instance
+    echo $date->i18nFormat('yyyy-MM-dd');
+}
+```
+
+::: info Added in version 5.3.0
+`DateTimePeriod` and `DatePeriod` were added.
+:::
+
 ## Time
 
 `class` Cake\\I18n\\**Time**

docs/en/core-libraries/validation.md

@@ -675,3 +675,19 @@ $validator
 Core rules that take additional parameters should have an array for the
 `rule` key that contains the rule as the first element, and the additional
 parameters as the remaining parameters.
+
+### IP and Range Validation
+
+You can validate that a value is a valid IP address or an IP range (subnet)
+using the `ipOrRange()` rule:
+
+``` php
+$validator->add('ip_address', 'validRange', [
+    'rule' => 'ipOrRange',
+    'message' => 'Please provide a valid IP or IP range.',
+]);
+```
+
+::: info Added in version 5.3.0
+The `ipOrRange()` validation rule was added.
+:::

docs/en/development/routing.md

@@ -1779,6 +1779,28 @@ Router::url(['_name' => 'articles:view', '_entity' => $article]);
 This will extract both the `id` property and the `slug` property out of the
 provided entity.
 
+### Redirect Trait
+
+CakePHP provides a `RedirectTrait` that can be used to create custom redirect
+route classes. If you need redirect behavior with custom logic, you can create
+a route class that uses this trait:
+
+``` php
+namespace App\Routing\Route;
+
+use Cake\Routing\Route\RedirectTrait;
+use Cake\Routing\Route\Route;
+
+class MyRedirectRoute extends Route
+{
+    use RedirectTrait;
+}
+```
+
+::: info Added in version 5.3.0
+`RedirectTrait` was added.
+:::
+
 <a id="custom-route-classes"></a>
 
 ## Custom Route Classes

docs/en/orm/database-basics.md

@@ -279,6 +279,16 @@ The `cache` flag to send to SQLite.
 mode
 The `mode` flag value to send to SQLite.
 
+### SqlServer Entra Authentication
+
+The SqlServer driver supports Entra authentication (formerly Azure Active
+Directory authentication). This allows you to authenticate using Azure-managed
+identities instead of traditional username/password credentials.
+
+::: info Added in version 5.3.0
+Entra authentication support was added to the SqlServer driver.
+:::
+
 At this point, you might want to take a look at the
 [CakePHP Conventions](../intro/conventions). The correct naming for your tables (and the addition
 of some columns) can score you some free functionality and help you avoid
@@ -648,6 +658,21 @@ Geospatial schema types were added.
 
 `static` Cake\\Database\\TypeFactory::**map**(string $name, string $class): void
 
+`static` Cake\\Database\\TypeFactory::**getMapped**(string $type): ?string
+
+You can retrieve the mapped class name for a specific type using `getMapped()`:
+
+``` php
+use Cake\Database\TypeFactory;
+
+// Returns the class name mapped to the 'datetime' type
+$className = TypeFactory::getMapped('datetime');
+```
+
+::: info Added in version 5.3.0
+`TypeFactory::getMapped()` was added.
+:::
+
 If you need to use vendor specific types that are not built into CakePHP you can
 add additional new types to CakePHP's type system. Type classes are expected to
 implement the following methods:
@@ -678,7 +703,8 @@ class PointMutationType extends BaseType
             return null;
         }
 
-        return $this->pmDecode($valu
+        return $this->pmDecode($value);
+    }
 
     public function marshal(mixed $value): mixed
     {

docs/en/orm/query-builder.md

@@ -1620,6 +1620,20 @@ extension).
 `Query::optimizerHint()` was added.
 :::
 
+### Getting the Driver
+
+`method` Cake\\Database\\Query::**getDriver**(): Driver
+
+You can get the `Driver` instance for the current connection role from a query:
+
+``` php
+$driver = $query->getDriver();
+```
+
+::: info Added in version 5.3.0
+`Query::getDriver()` was added.
+:::
+
 ## Getting Results
 
 Once you've made your query, you'll want to retrieve rows from it. There are

docs/en/orm/validation.md

@@ -433,6 +433,25 @@ $rules->add($rules->existsIn(
 $rules->add($rules->existsIn(['site_id'], 'Sites'));
 ```
 
+You can also use `existsInNullable()` for nullable composite foreign keys.
+This rule allows `null` values in nullable foreign key columns, which is
+semantically correct for optional relationships:
+
+``` php
+// Allow null values in nullable composite foreign keys.
+$rules->add($rules->existsInNullable(
+    ['author_id', 'site_id'],
+    'SiteAuthors',
+));
+```
+
+Use `existsInNullable()` instead of `existsIn()` when you want to permit null
+values in foreign keys without requiring the `allowNullableNulls` option.
+
+::: info Added in version 5.3.0
+The `existsInNullable()` rule was added.
+:::
+
 In most SQL databases multi-column `UNIQUE` indexes allow multiple null values
 to exist as `NULL` is not equal to itself. While, allowing multiple null
 values is the default behavior of CakePHP, you can include null values in your