Changeset 44677

Timestamp:

01/21/2019 09:51:29 PM (6 years ago)

Author:

pento

Message:

Media: Add a $real_mime parameter to the wp_check_filetype_and_ext filter.

This allows more accurate filtering of the filename and extension given to uploaded files.

Props desrosj, Tkama.
Fixes #45707.

File:

• trunk/src/wp-includes/functions.php (modified) (1 diff)

trunk/src/wp-includes/functions.php

@@ -2639 +2639 @@
      *
      * @since 3.0.0
-     *
-     * @param array  $wp_check_filetype_and_ext File data array containing 'ext', 'type', and
-     *                                          'proper_filename' keys.
-     * @param string $file                      Full path to the file.
-     * @param string $filename                  The name of the file (may differ from $file due to
-     *                                          $file being in a tmp directory).
-     * @param array  $mimes                     Key is the file extension with value as the mime type.
+     * @since 5.1.0 The $real_mime parameter was added.
+     *
+     * @param array       $wp_check_filetype_and_ext File data array containing 'ext', 'type', and
+     *                                               'proper_filename' keys.
+     * @param string      $file                      Full path to the file.
+     * @param string      $filename                  The name of the file (may differ from $file due to
+     *                                               $file being in a tmp directory).
+     * @param array       $mimes                     Key is the file extension with value as the mime type.
+     * @param string|bool $real_mime                 The actual mime type or false if the type cannot be determined.
      */
-    return apply_filters( 'wp_check_filetype_and_ext', compact( 'ext', 'type', 'proper_filename' ), $file, $filename, $mimes );
+    return apply_filters( 'wp_check_filetype_and_ext', compact( 'ext', 'type', 'proper_filename' ), $file, $filename, $mimes, $real_mime );
 }