[Validator] Add the option filenameMaxLength to the File constraint

alexandre-daubois · alexandre-daubois · commit 1a1fb8fbf236 · 2023-02-23T17:13:49.000+01:00
diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
@@ -268,6 +268,38 @@ You can find a list of existing mime types on the `IANA website`_.
     (i.e. the form type is not defined explicitly in the ``->add()`` method of
     the form builder) and when the field doesn't define its own ``accept`` value.
 
+``filenameMaxLength``
+~~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``integer`` **default**: ``null``
+
+.. versionadded:: 6.3
+
+    The ``filenameMaxLength`` was introduced in Symfony 6.3.
+
+If set, the validator will check that the filename of the underlying file
+doesn't exceed a certain length.
+
+``filenameTooLongMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``The filename is too long. It should have {{ filename_max_length }} character or less.|The filename is too long. It should have {{ filename_max_length }} characters or less.``
+
+.. versionadded:: 6.3
+
+    The ``filenameTooLongMessage`` was introduced in Symfony 6.3.
+
+The message displayed if the filename of the file exceeds the limit set
+with the ``filenameMaxLength`` option.
+
+You can use the following parameters in this message:
+
+==============================  ==============================================================
+Parameter                       Description
+==============================  ==============================================================
+``{{ filename_max_length }}``   Maximum number of characters allowed
+==============================  ==============================================================
+
 ``extensionsMessage``
 ~~~~~~~~~~~~~~~~~~~~~
 
