locomotivemtl / charcoal-property

src/Charcoal/Property/FileProperty.php

Doc Comments +6 added lines, -6 removed lines

@@ -277,7 +277,7 @@ 
     /**
      * Set the MIME type.
      *
-     * @param  mixed $type The file MIME type.
+     * @param  string $type The file MIME type.
      * @throws InvalidArgumentException If the MIME type argument is not a string.
      * @return FileProperty Chainable
      */
@@ -303,7 +303,7 @@ 
      *
      * @todo Refactor to support multilingual/multiple files.
      *
-     * @return integer Returns the MIME type for the first value.
+     * @return null|string Returns the MIME type for the first value.
      */
     public function getMimetype()
     {
@@ -329,7 +329,7 @@ 
      * Extract the MIME type from the given file.
      *
      * @param  string $file The file to check.
-     * @return integer|null Returns the file's MIME type,
+     * @return null|string Returns the file's MIME type,
      *     or NULL in case of an error or the file is missing.
      */
     public function getMimetypeFor($file)
@@ -501,7 +501,7 @@ 
     }
 
     /**
-     * @return array
+     * @return string[]
      */
     public function validationMethods()
     {
@@ -1148,7 +1148,7 @@ 
     /**
      * Generate a unique filename.
      *
-     * @param  string|array $filename The filename to alter.
+     * @param  string $filename The filename to alter.
      * @throws InvalidArgumentException If the given filename is invalid.
      * @return string
      */
@@ -1599,7 +1599,7 @@ 
      *
      * @param  array    $uploadedFiles  The non-normalized tree of uploaded file data.
      * @param  callable $filterCallback If specified, the callback function to used to filter files.
-     * @param  mixed    $searchKey      If specified, then only top-level keys containing these values are returned.
+     * @param  string    $searchKey      If specified, then only top-level keys containing these values are returned.
      * @return array A tree of normalized $_FILE entries.
      */
     public static function parseUploadedFiles(array $uploadedFiles, callable $filterCallback = null, $searchKey = null)

Spacing +9 added lines, -9 removed lines

@@ -489,7 +489,7 @@ 
             $factor = floor((strlen($bytes) - 1) / 3);
         }
 
-        $unit = [ 'B', 'kB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB' ];
+        $unit = ['B', 'kB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'];
 
         $factor = floor((strlen($bytes) - 1) / 3);
 
@@ -623,12 +623,12 @@ 
         }
 
         $array = $this->parseValAsMultiple($value);
-        array_walk_recursive($array, function ($item) use (&$files) {
+        array_walk_recursive($array, function($item) use (&$files) {
             $array = $this->parseValAsMultiple($item);
             $files = array_merge($files, $array);
         });
 
-        $files = array_filter($files, function ($file) {
+        $files = array_filter($files, function($file) {
             return is_string($file) && isset($file[0]);
         });
         $files = array_unique($files);
@@ -726,7 +726,7 @@ 
     {
         // Bag value if singular
         if (!is_array($values) || isset($values['id'])) {
-            $values = [ $values ];
+            $values = [$values];
         }
 
         $parsed = [];
@@ -766,7 +766,7 @@ 
     {
         // Bag value if singular
         if (isset($files['error'])) {
-            $files = [ $files ];
+            $files = [$files];
         }
 
         $parsed = [];
@@ -808,7 +808,7 @@ 
 
         if ($this['multiple']) {
             if (!is_array($values)) {
-                $values = empty($values) && !is_numeric($values) ? [] : [ $values ];
+                $values = empty($values) && !is_numeric($values) ? [] : [$values];
             }
         } else {
             if (is_array($values)) {
@@ -1065,7 +1065,7 @@ 
     public function sanitizeFilename($filename)
     {
         // Remove blacklisted caharacters
-        $blacklist = [ '/', '\\', '\0', '*', ':', '?', '"', '<', '>', '|', '#', '&', '!', '`', ' ' ];
+        $blacklist = ['/', '\\', '\0', '*', ':', '?', '"', '<', '>', '|', '#', '&', '!', '`', ' '];
         $filename  = str_replace($blacklist, '_', (string)$filename);
 
         // Avoid hidden file or trailing dot
@@ -1363,7 +1363,7 @@ 
         if (!file_exists($uploadPath)) {
             $this->logger->debug(sprintf(
                 '[%s] Upload directory [%s] does not exist; attempting to create path',
-                [ get_called_class().'::'.__FUNCTION__ ],
+                [get_called_class().'::'.__FUNCTION__],
                 $uploadPath
             ));
 
@@ -1581,7 +1581,7 @@ 
     {
         $propIdent = $this->ident();
 
-        $filterErrNoFile = function (array $file) {
+        $filterErrNoFile = function(array $file) {
             return $file['error'] !== UPLOAD_ERR_NO_FILE;
         };
         $uploadedFiles = static::parseUploadedFiles($_FILES, $filterErrNoFile, $propIdent);