minor #15819 [CS] Add missing commas (sebpacz)

This PR was merged into the 4.4 branch.

Discussion
----------

[CS] Add missing commas

This PR adds missing commas to examples with multi-line arrays. Maybe it would be a good idea to add a new rule to https://github.com/OskarStark/doctor-rst?

Commits
-------

00583e4 [CS] Add missing commas

Author: javiereguiluz

components/form.rst

@@ -686,7 +686,7 @@ option when building each field:
                 'constraints' => [
                     new NotBlank(),
                     new Type(\DateTime::class),
-                ]
+                ],
             ])
             ->getForm();
 
@@ -713,7 +713,7 @@ option when building each field:
                         'constraints' => [
                             new NotBlank(),
                             new Type(\DateTime::class),
-                        ]
+                        ],
                     ])
                     ->getForm();
                 // ...

components/property_access.rst

@@ -72,7 +72,7 @@ You can also use multi dimensional arrays::
         ],
         [
             'first_name' => 'Ryan',
-        ]
+        ],
     ];
 
     var_dump($propertyAccessor->getValue($persons, '[0][first_name]')); // 'Wouter'

components/var_dumper/advanced.rst

@@ -200,7 +200,7 @@ method::
     $dumper->dump($var, $output, [
         // 1 and 160 are the default values for these options
         'maxDepth' => 1,
-        'maxStringLength' => 160
+        'maxStringLength' => 160,
     ]);
 
 The output format of a dumper can be fine tuned by the two flags
@@ -223,7 +223,7 @@ next to its content::
 
     $varCloner = new VarCloner();
     $var = ['test'];
-    
+
     $dumper = new CliDumper();
     echo $dumper->dump($varCloner->cloneVar($var), true);
 
@@ -248,7 +248,7 @@ similar to PHP's short array notation::
 
     $varCloner = new VarCloner();
     $var = ['test'];
-    
+
     $dumper = new CliDumper();
     echo $dumper->dump($varCloner->cloneVar($var), true);
 
@@ -273,7 +273,7 @@ using the logical OR operator ``|``::
 
     $varCloner = new VarCloner();
     $var = ['test'];
-    
+
     $dumper = new CliDumper(null, null, AbstractDumper::DUMP_STRING_LENGTH | AbstractDumper::DUMP_LIGHT_ARRAY);
     echo $dumper->dump($varCloner->cloneVar($var), true);
 

components/var_exporter.rst

@@ -120,12 +120,12 @@ created by using the special ``"\0"`` property name to define their internal val
 
     // Creates an SplObjectHash where $info1 is associated to $object1, etc.
     $theObject = Instantiator::instantiate(SplObjectStorage::class, [
-        "\0" => [$object1, $info1, $object2, $info2...]
+        "\0" => [$object1, $info1, $object2, $info2...],
     ]);
 
     // creates an ArrayObject populated with $inputArray
     $theObject = Instantiator::instantiate(ArrayObject::class, [
-        "\0" => [$inputArray]
+        "\0" => [$inputArray],
     ]);
 
 .. _`OPcache`: https://www.php.net/opcache

configuration.rst

@@ -521,7 +521,7 @@ This example shows how you could configure the database connection using an env
                 'dbal' => [
                     // by convention the env var names are always uppercase
                     'url' => '%env(resolve:DATABASE_URL)%',
-                ]
+                ],
             ]);
         };
 
@@ -888,7 +888,7 @@ whenever a service/controller defines a ``$projectDir`` argument, use this:
                     // pass this value to any $projectDir argument for any service
                     // that's created in this file (including controller arguments)
                     ->bind('$projectDir', '%kernel.project_dir%');
-            
+
             // ...
         };
 

configuration/secrets.rst

@@ -145,7 +145,7 @@ If you stored a ``DATABASE_PASSWORD`` secret, you can reference it by:
         $container->loadFromExtension('doctrine', [
             'dbal' => [
                 'password' => '%env(DATABASE_PASSWORD)%',
-            ]
+            ],
         ]);
 
 The actual value will be resolved at runtime: container compilation and cache

create_framework/unit_testing.rst

@@ -26,7 +26,7 @@ using `PHPUnit`_. Create a PHPUnit configuration file in
                 <directory suffix=".php">./src</directory>
             </include>
         </coverage>
-        
+
         <testsuites>
             <testsuite name="Test Suite">
                 <directory>./tests</directory>
@@ -167,7 +167,7 @@ Response::
             ->will($this->returnValue([
                 '_route' => 'is_leap_year/{year}',
                 'year' => '2000',
-                '_controller' => [new LeapYearController(), 'index']
+                '_controller' => [new LeapYearController(), 'index'],
             ]))
         ;
         $matcher

doctrine/multiple_entity_managers.rst

@@ -161,7 +161,7 @@ The following configuration code shows how you can configure two entity managers
                                 'dir' => '%kernel.project_dir%/src/Entity/Main',
                                 'prefix' => 'App\Entity\Main',
                                 'alias' => 'Main',
-                            ]
+                            ],
                         ],
                     ],
                     'customer' => [
@@ -173,7 +173,7 @@ The following configuration code shows how you can configure two entity managers
                                 'dir' => '%kernel.project_dir%/src/Entity/Customer',
                                 'prefix' => 'App\Entity\Customer',
                                 'alias' => 'Customer',
-                            ]
+                            ],
                         ],
                     ],
                 ],

mailer.rst

@@ -61,7 +61,7 @@ over SMTP by configuring the DSN in your ``.env`` file (the ``user``,
             $containerConfigurator->extension('framework', [
                 'mailer' => [
                     'dsn' => '%env(MAILER_DSN)%',
-                ]
+                ],
             ]);
         };
 

mercure.rst

@@ -400,7 +400,7 @@ Add your JWT secret to the configuration as follow:
                     'url' => 'https://mercure-hub.example.com/.well-known/mercure',
                     'jwt' => [
                         'secret' => '!ChangeMe!',
-                    ]
+                    ],
                 ],
             ],
         ]);
@@ -498,7 +498,7 @@ Then, reference this service in the bundle configuration:
                     'url' => 'https://mercure-hub.example.com/.well-known/mercure',
                     'jwt' => [
                         'provider' => MyJwtProvider::class,
-                    ]
+                    ],
                 ],
             ],
         ]);

reference/configuration/framework.rst

@@ -3126,9 +3126,9 @@ recipients set in the code.
                         'recipients' => [
                             '[email protected]',
                             '[email protected]',
-                        ]
-                    ]
-                ]
+                        ],
+                    ],
+                ],
             ]);
         };
 

reference/forms/types/birthday.rst

@@ -95,7 +95,7 @@ values for the year, month and day fields::
     $builder->add('birthdate', BirthdayType::class, [
         'placeholder' => [
             'year' => 'Year', 'month' => 'Month', 'day' => 'Day',
-        ]
+        ],
     ]);
 
 .. include:: /reference/forms/types/options/date_format.rst.inc

reference/forms/types/date.rst

@@ -164,7 +164,7 @@ values for the year, month and day fields::
     $builder->add('dueDate', DateType::class, [
         'placeholder' => [
             'year' => 'Year', 'month' => 'Month', 'day' => 'Day',
-        ]
+        ],
     ]);
 
 .. _reference-forms-type-date-format:

reference/forms/types/dateinterval.rst

@@ -108,7 +108,7 @@ add a "blank" entry to the top of each select box::
 Alternatively, you can specify a string to be displayed for the "blank" value::
 
     $builder->add('remindEvery', DateIntervalType::class, [
-        'placeholder' => ['years' => 'Years', 'months' => 'Months', 'days' => 'Days']
+        'placeholder' => ['years' => 'Years', 'months' => 'Months', 'days' => 'Days'],
     ]);
 
 ``hours``

reference/forms/types/datetime.rst

@@ -131,7 +131,7 @@ values for the year, month, day, hour, minute and second fields::
         'placeholder' => [
             'year' => 'Year', 'month' => 'Month', 'day' => 'Day',
             'hour' => 'Hour', 'minute' => 'Minute', 'second' => 'Second',
-        ]
+        ],
     ]);
 
 format

reference/forms/types/range.rst

@@ -45,7 +45,7 @@ Basic Usage
         'attr' => [
             'min' => 5,
             'max' => 50
-        ]
+        ],
     ]);
 
 Inherited Options

reference/forms/types/time.rst

@@ -111,7 +111,7 @@ values for the hour, minute and second fields::
     $builder->add('startTime', 'time', [
         'placeholder' => [
             'hour' => 'Hour', 'minute' => 'Minute', 'second' => 'Second',
-        ]
+        ],
     ]);
 
 .. include:: /reference/forms/types/options/hours.rst.inc

reference/forms/types/week.rst

@@ -79,7 +79,7 @@ values for the year and week fields::
         'placeholder' => [
             'year' => 'Year',
             'week' => 'Week',
-        ]
+        ],
     ]);
 
 .. include:: /reference/forms/types/options/html5.rst.inc

security.rst

@@ -214,7 +214,7 @@ command will pre-configure this for you:
                 User::class => [
                     'algorithm' => 'auto',
                     'cost' => 12,
-                ]
+                ],
             ],
 
             // ...

security/form_login_setup.rst

@@ -352,7 +352,7 @@ a traditional HTML form that submits to ``/login``:
                     'guard' => [
                         'authenticators' => [
                             LoginFormAuthenticator::class,
-                        ]
+                        ],
                     ],
                     'logout' => [
                         'path' => 'app_logout',
@@ -507,7 +507,7 @@ whenever the user browses a page::
         public static function getSubscribedEvents(): array
         {
             return [
-                KernelEvents::REQUEST => ['onKernelRequest']
+                KernelEvents::REQUEST => ['onKernelRequest'],
             ];
         }
     }

security/ldap.rst

@@ -413,7 +413,7 @@ Configuration example for form login
                         // ...
                     ],
                 ],
-            ]
+            ],
         ]);
 
 Configuration example for HTTP Basic
@@ -533,7 +533,7 @@ Configuration example for form login and query_string
                         'search_password' => 'the-raw-password',
                     ],
                 ],
-            ]
+            ],
         ]);
 
 .. deprecated:: 4.4

service_container/tags.rst

@@ -490,7 +490,7 @@ use this, update the compiler::
                 foreach ($tags as $attributes) {
                     $definition->addMethodCall('addTransport', [
                         new Reference($id),
-                        $attributes['alias']
+                        $attributes['alias'],
                     ]);
                 }
             }

testing/http_authentication.rst

@@ -72,7 +72,7 @@ encoders configuration to generate password hashes as fast as possible:
                     'cost' => 4, // Lowest possible value for bcrypt
                     'time_cost' => 3, // Lowest possible value for argon
                     'memory_cost' => 10, // Lowest possible value for argon
-                ]
+                ],
             ],
         ]);