1:  2:  3:  4:  5:  6:  7:  8:  9: 10: 11: 12: 13: 14: 15: 16: 17: 18: 19: 20: 21: 22: 23: 24: 25: 26: 27: 28: 29: 30: 31: 32: 33: 34: 35: 36: 37: 38: 39: 40: 41: 42: 43: 44: 45: 46: 47: 48: 49: 50: 51: 52: 53: 54: 55: 56: 57: 58: 59: 60: 61: 62: 63: 64: 65: 66: 67: 68: 69: 70: 71: 72: 73: 74: 75: 76: 77: 78: 79: 80: 81: 82: 83: 84: 85: 

<?php

/**
 * MvcCore
 *
 * This source file is subject to the BSD 3 License
 * For the full copyright and license information, please view
 * the LICENSE.md file that are distributed with this source code.
 *
 * @copyright   Copyright (c) 2016 Tom Flidr (https://github.com/mvccore)
 * @license     https://mvccore.github.io/docs/mvccore/5.0.0/LICENCE.md
 */

namespace MvcCore\Ext\Forms\Validators\Files;

/**
 * Responsibility: Complete uploaded files from request object.
 */
trait CompleteFiles {

    /**
     * Complete files array from global `$_FILES` stored in request object.
     * @return bool|NULL
     */
    protected function completeFiles () {
        
        $this->files = [];
        $filesFieldItems = $this->form
            ->GetRequest()
            ->GetFile($this->field->GetName());
        
        if (!$filesFieldItems) 
            return NULL;

        $this->completeFilesArray($filesFieldItems);
        
        $filesCount = count($this->files);
        
        if ($this->minCount !== NULL && $filesCount < $this->minCount) 
            return $this->handleUploadError(
                static::UPLOAD_ERR_MIN_FILES, [$this->minCount]
            );
        
        if ($this->maxCount !== NULL && $filesCount > $this->maxCount) 
            return $this->handleUploadError(
                static::UPLOAD_ERR_MAX_FILES, [$this->maxCount]
            );
        
        if ($filesCount > 0) 
            return TRUE;
        
        return $this->handleUploadError(UPLOAD_ERR_NO_FILE);
    }

    /**
     * Complete local `$this->files` array from given 
     * array from request object global `$_FILES`.
     * @param array $filesFieldItems 
     * @return void
     */
    protected function completeFilesArray (array & $filesFieldItems) {
        if ($this->multiple) {
            foreach ($filesFieldItems['name'] as $index => $fileName) {
                $this->files[] = (object) [
                    'name'          => basename($fileName),
                    'type'          => $filesFieldItems['type'][$index],
                    'tmpFullPath'   => $filesFieldItems['tmp_name'][$index],
                    'error'         => $filesFieldItems['error'][$index],
                    'size'          => $filesFieldItems['size'][$index],
                    //'extension' is completed later in `$this->validateSanitizeFileNameAndAddFileExt();`
                ];
            }
        } else {
            $this->files[] = (object) [
                'name'          => basename($filesFieldItems['name']),
                'type'          => $filesFieldItems['type'],
                'tmpFullPath'   => $filesFieldItems['tmp_name'],
                'error'         => $filesFieldItems['error'],
                'size'          => $filesFieldItems['size'],
                //'extension' is completed later in `$this->validateSanitizeFileNameAndAddFileExt();`
            ];
        }
    }
}