deprecate Security::sanitizeFilename and SecurityInterface::sanitizeFilename

Author: michalsn

system/Security/Security.php

@@ -427,6 +427,8 @@ public function shouldRedirect(): bool
      * e.g. file/in/some/approved/folder.txt, you can set the second optional
      * parameter, $relativePath to TRUE.
      *
+     * @deprecated 4.6.2 Use `sanitize_filename()` instead
+     *
      * @param string $str          Input file name
      * @param bool   $relativePath Whether to preserve paths
      */

system/Security/SecurityInterface.php

@@ -66,6 +66,8 @@ public function shouldRedirect(): bool;
      * e.g. file/in/some/approved/folder.txt, you can set the second optional
      * parameter, $relativePath to TRUE.
      *
+     * @deprecated 4.6.2 Use `sanitize_filename()` instead
+     *
      * @param string $str          Input file name
      * @param bool   $relativePath Whether to preserve paths
      */

user_guide_src/source/changelogs/v4.6.2.rst

@@ -28,6 +28,9 @@ Changes
 Deprecations
 ************
 
+- **Security:** The ``Security::sanitizeFilename()`` method is deprecated. Use ``sanitize_filename()`` instead.
+- **Security:** The ``SecurityInterface::sanitizeFilename()`` method is deprecated.
+
 **********
 Bugs Fixed
 **********