Fix PHP coding standards in documentation code snippets

- Add missing trailing commas in multi-line arrays (399 fixes)
- Fix 2-space and 3-space indentation to 4-space in PHP code blocks
- Manual fixes for edge cases (string keys containing '#', odd indent)

Blocks inside /* */ comments showing print_r output and non-PHP content
are intentionally left untouched.

Author: dereuromark

docs/en/appendices/glossary.md

@@ -37,7 +37,7 @@ Would point to the following value:
 [
     'Cache' => [
         'default' => [
-            'engine' => 'File'
+            'engine' => 'File',
         ]
     ]
 ]

docs/en/appendices/phpunit-upgrade.md

@@ -58,7 +58,7 @@ should be converted to:
 
 ``` php
 ->with(
-    ...self::withConsecutive(['firstCallArg'], ['secondCallArg'])
+    ...self::withConsecutive(['firstCallArg'], ['secondCallArg']),
 )
 ```
 

docs/en/console-commands/commands.md

@@ -173,7 +173,7 @@ class UserCommand extends Command
     {
         $parser
             ->addArgument('name', [
-                'help' => 'What is your name'
+                'help' => 'What is your name',
             ]);
 
         return $parser;
@@ -392,7 +392,7 @@ class UpdateTableCommand extends Command
             ->setDescription('My cool console app')
             ->addArgument('table', [
                 'help' => 'Table to update',
-                'required' => true
+                'required' => true,
             ]);
 
         return $parser;
@@ -403,7 +403,7 @@ class UpdateTableCommand extends Command
         $table = $args->getArgument('table');
         $this->fetchTable($table)->updateQuery()
             ->set([
-                'modified' => new DateTime()
+                'modified' => new DateTime(),
             ])
             ->execute();
 
@@ -492,7 +492,7 @@ class UpdateTableCommand extends Command
             ->setDescription('My cool console app')
             ->addArgument('table', [
                 'help' => 'Table to update',
-                'required' => true
+                'required' => true,
             ]);
 
         return $parser;
@@ -507,7 +507,7 @@ class UpdateTableCommand extends Command
         }
         $this->fetchTable($table)->updateQuery()
             ->set([
-                'modified' => new DateTime()
+                'modified' => new DateTime(),
             ])
             ->execute();
 

docs/en/console-commands/option-parsers.md

@@ -202,7 +202,7 @@ are set to `true`, when they are absent they are set to `false`:
 ``` php
 $parser->addOption('verbose', [
     'help' => 'Enable verbose output.',
-    'boolean' => true
+    'boolean' => true,
 ]);
 ```
 
@@ -228,7 +228,7 @@ public function getOptionParser()
         'description' => [
             __("Use this command to grant ACL permissions. Once executed, the "),
             __("ARO specified (and its children, if any) will have ALLOW access "),
-            __("to the specified ACO action (and the ACO's children, if any).")
+            __("to the specified ACO action (and the ACO's children, if any)."),
         ],
         'arguments' => [
             'aro' => ['help' => __('ARO to check.'), 'required' => true],

docs/en/contributing/cakephp-coding-conventions.md

@@ -75,7 +75,7 @@ Use this instead:
 $matches = array_intersect_key(
     $this->_listeners,
     array_flip(
-        preg_grep($matchPattern, array_keys($this->_listeners), 0)
+        preg_grep($matchPattern, array_keys($this->_listeners), 0),
     )
 );
 ```

docs/en/controllers.md

@@ -427,9 +427,9 @@ return $this->redirect([
     $order->id,
     '?' => [
         'product' => 'pizza',
-        'quantity' => 5
+        'quantity' => 5,
     ],
-    '#' => 'top'
+    '#' => 'top',
 ]);
 ```
 
@@ -438,7 +438,7 @@ Or using a relative or absolute URL:
 ``` php
 return $this->redirect('/orders/confirm');
 
-return $this->redirect('http://www.example.com');
+return $this->redirect('https://www.example.com');
 ```
 
 Or to the referer page:
@@ -471,7 +471,7 @@ the controller's default one:
 // In a controller method.
 $recentArticles = $this->fetchTable('Articles')->find('all',
         limit: 5,
-        order: 'Articles.created DESC'
+        order: 'Articles.created DESC',
     )
     ->all();
 ```

docs/en/controllers/components.md

@@ -198,7 +198,7 @@ class SsoComponent extends Component
     public function __construct(
         ComponentRegistry $registry,
         array $config = [],
-        UserService $users
+        UserService $users,
     ) {
         parent::__construct($registry, $config);
         $this->users = $users;

docs/en/controllers/middleware.md

@@ -118,15 +118,15 @@ $middlewareQueue->insertAt(2, $layer);
 // an exception will be raised.
 $middlewareQueue->insertBefore(
     'Cake\Error\Middleware\ErrorHandlerMiddleware',
-    $layer
+    $layer,
 );
 
 // Insert after another middleware.
 // If the named class cannot be found, the
 // middleware will added to the end.
 $middlewareQueue->insertAfter(
     'Cake\Error\Middleware\ErrorHandlerMiddleware',
-    $layer
+    $layer,
 );
 ```
 
@@ -189,7 +189,7 @@ class TrackingCookieMiddleware implements MiddlewareInterface
 {
     public function process(
         ServerRequestInterface $request,
-        RequestHandlerInterface $handler
+        RequestHandlerInterface $handler,
     ): ResponseInterface
     {
         // Calling $handler->handle() delegates control to the *next* middleware
@@ -201,7 +201,7 @@ class TrackingCookieMiddleware implements MiddlewareInterface
             $response = $response->withCookie(new Cookie(
                 'landing_page',
                 $request->getRequestTarget(),
-                $expiry
+                $expiry,
             ));
         }
 
@@ -265,7 +265,7 @@ use Cake\Http\Middleware\EncryptedCookieMiddleware;
 $cookies = new EncryptedCookieMiddleware(
     // Names of cookies to protect
     ['secrets', 'protected'],
-    Configure::read('Security.cookieKey')
+    Configure::read('Security.cookieKey'),
 );
 
 $middlewareQueue->add($cookies);

docs/en/controllers/pagination.md

@@ -79,7 +79,7 @@ class ArticlesController extends AppController
         $tags = $this->request->getParam('pass');
 
         $customFinderOptions = [
-            'tags' => $tags
+            'tags' => $tags,
         ];
         // We're using the $settings argument to paginate() here.
         // But the same structure could be used in $this->paginate
@@ -90,7 +90,7 @@ class ArticlesController extends AppController
         // public function findTagged(Query $query, array $tagged = [])
         $settings = [
             'finder' => [
-                'tagged' => $customFinderOptions
+                'tagged' => $customFinderOptions,
             ]
         ];
         $articles = $this->paginate($this->Articles, $settings);
@@ -153,7 +153,7 @@ call to the `paginate()` method:
 // Paginate property
 protected array $paginate = [
     'Articles' => ['scope' => 'article'],
-    'Tags' => ['scope' => 'tag']
+    'Tags' => ['scope' => 'tag'],
 ];
 
 // In a controller action
@@ -197,7 +197,7 @@ $this->paginate = [
 
 $publishedArticles = $this->paginate(
     $this->Articles->find('all', scope: 'published_articles')
-        ->where(['published' => true])
+        ->where(['published' => true]),
 );
 
 // Load an additional table object to allow differentiating in the paginator
@@ -209,7 +209,7 @@ $unpublishedArticlesTable = $this->fetchTable('UnpublishedArticles', [
 
 $unpublishedArticles = $this->paginate(
     $unpublishedArticlesTable->find('all', scope: 'unpublished_articles')
-        ->where(['published' => false])
+        ->where(['published' => false]),
 );
 ```
 
@@ -355,7 +355,7 @@ example reducing it to `10`:
 ``` php
 protected array $paginate = [
     // Other keys here.
-    'maxLimit' => 10
+    'maxLimit' => 10,
 ];
 ```
 

docs/en/controllers/request-response.md

@@ -238,9 +238,9 @@ Returns all uploaded files in a normalized array structure. For the above exampl
 
 ``` php
 [
-      'attachment' => object(Laminas\Diactoros\UploadedFile) {
-          // ...
-      }
+        'attachment' => object(Laminas\Diactoros\UploadedFile) {
+            // ...
+        }
 ]
 ```
 
@@ -258,14 +258,14 @@ $files = [
             $size,
             $errorStatus,
             $clientFilename,
-            $clientMediaType
+            $clientMediaType,
         ),
         'anotherAttachment' => new \Laminas\Diactoros\UploadedFile(
             '/tmp/hfz6dbn.tmp',
             123,
             \UPLOAD_ERR_OK,
             'attachment.txt',
-            'text/plain'
+            'text/plain',
         ),
     ],
 ];
@@ -411,34 +411,34 @@ Some examples would be:
 // Add an environment detector.
 $this->request->addDetector(
     'post',
-    ['env' => 'REQUEST_METHOD', 'value' => 'POST']
+    ['env' => 'REQUEST_METHOD', 'value' => 'POST'],
 );
 
 // Add a pattern value detector.
 $this->request->addDetector(
     'iphone',
-    ['env' => 'HTTP_USER_AGENT', 'pattern' => '/iPhone/i']
+    ['env' => 'HTTP_USER_AGENT', 'pattern' => '/iPhone/i'],
 );
 
 // Add an option detector
 $this->request->addDetector('internalIp', [
     'env' => 'CLIENT_IP',
-    'options' => ['192.168.0.101', '192.168.0.100']
+    'options' => ['192.168.0.101', '192.168.0.100'],
 ]);
 
 
 // Add a header detector with value comparison
 $this->request->addDetector('fancy', [
     'env' => 'CLIENT_IP',
-    'header' => ['X-Fancy' => 1]
+    'header' => ['X-Fancy' => 1],
 ]);
 
 // Add a header detector with callable comparison
 $this->request->addDetector('fancy', [
     'env' => 'CLIENT_IP',
     'header' => ['X-Fancy' => function ($value, $header) {
         return in_array($value, ['1', '0', 'yes', 'no'], true);
-    }]
+    }],
 ]);
 
 // Add a callback detector. Must be a valid callable.
@@ -782,7 +782,7 @@ the browser by specifying the options:
 ``` php
 $response = $this->response->withFile(
     $file['path'],
-    ['download' => true, 'name' => 'foo']
+    ['download' => true, 'name' => 'foo'],
 );
 ```
 
@@ -1149,7 +1149,7 @@ $this->response = $this->response->withCookie(Cookie::create(
         'domain' => '',
         'secure' => false,
         'httponly' => false,
-        'samesite' => null // Or one of CookieInterface::SAMESITE_* constants
+        'samesite' => null, // Or one of CookieInterface::SAMESITE_* constants
     ]
 ));
 ```
@@ -1273,7 +1273,7 @@ class CorsMiddleware implements MiddlewareInterface
 {
     public function process(
         ServerRequestInterface $request,
-        RequestHandlerInterface $handler
+        RequestHandlerInterface $handler,
     ): ResponseInterface {
         // Handle preflight requests
         if ($request->getMethod() === 'OPTIONS') {
@@ -1385,7 +1385,7 @@ $cookie = new Cookie(
     '/', // path, if applicable
     'example.com', // domain, if applicable
     false, // secure only?
-    true // http only ?
+    true, // http only ?
 );
 
 // Using the builder methods