update v1.0.7.9 R.C.

This is a Release Candidate. We are still testing.

vendor/zendframework/zend-validator/src/File/Exists.php

@@ -0,0 +1,196 @@
+<?php
+/**
+ * Zend Framework (http://framework.zend.com/)
+ *
+ * @link      http://github.com/zendframework/zf2 for the canonical source repository
+ * @copyright Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com)
+ * @license   http://framework.zend.com/license/new-bsd New BSD License
+ */
+
+namespace Zend\Validator\File;
+
+use Zend\Validator\AbstractValidator;
+use Zend\Validator\Exception;
+
+/**
+ * Validator which checks if the file already exists in the directory
+ */
+class Exists extends AbstractValidator
+{
+    /**
+     * @const string Error constants
+     */
+    const DOES_NOT_EXIST = 'fileExistsDoesNotExist';
+
+    /**
+     * @var array Error message templates
+     */
+    protected $messageTemplates = [
+        self::DOES_NOT_EXIST => "File does not exist",
+    ];
+
+    /**
+     * Options for this validator
+     *
+     * @var array
+     */
+    protected $options = [
+        'directory' => null,  // internal list of directories
+    ];
+
+    /**
+     * @var array Error message template variables
+     */
+    protected $messageVariables = [
+        'directory' => ['options' => 'directory'],
+    ];
+
+    /**
+     * Sets validator options
+     *
+     * @param  string|array|\Traversable $options
+     */
+    public function __construct($options = null)
+    {
+        if (is_string($options)) {
+            $options = explode(',', $options);
+        }
+
+        if (is_array($options) && !array_key_exists('directory', $options)) {
+            $options = ['directory' => $options];
+        }
+
+        parent::__construct($options);
+    }
+
+    /**
+     * Returns the set file directories which are checked
+     *
+     * @param  bool $asArray Returns the values as array; when false, a concatenated string is returned
+     * @return string|null
+     */
+    public function getDirectory($asArray = false)
+    {
+        $asArray   = (bool) $asArray;
+        $directory = $this->options['directory'];
+        if ($asArray && isset($directory)) {
+            $directory = explode(',', (string) $directory);
+        }
+
+        return $directory;
+    }
+
+    /**
+     * Sets the file directory which will be checked
+     *
+     * @param  string|array $directory The directories to validate
+     * @return Extension Provides a fluent interface
+     */
+    public function setDirectory($directory)
+    {
+        $this->options['directory'] = null;
+        $this->addDirectory($directory);
+        return $this;
+    }
+
+    /**
+     * Adds the file directory which will be checked
+     *
+     * @param  string|array $directory The directory to add for validation
+     * @return Extension Provides a fluent interface
+     * @throws Exception\InvalidArgumentException
+     */
+    public function addDirectory($directory)
+    {
+        $directories = $this->getDirectory(true);
+        if (!isset($directories)) {
+            $directories = [];
+        }
+
+        if (is_string($directory)) {
+            $directory = explode(',', $directory);
+        } elseif (!is_array($directory)) {
+            throw new Exception\InvalidArgumentException('Invalid options to validator provided');
+        }
+
+        foreach ($directory as $content) {
+            if (empty($content) || !is_string($content)) {
+                continue;
+            }
+
+            $directories[] = trim($content);
+        }
+        $directories = array_unique($directories);
+
+        // Sanity check to ensure no empty values
+        foreach ($directories as $key => $dir) {
+            if (empty($dir)) {
+                unset($directories[$key]);
+            }
+        }
+
+        $this->options['directory'] = (!empty($directory))
+            ? implode(',', $directories) : null;
+
+        return $this;
+    }
+
+    /**
+     * Returns true if and only if the file already exists in the set directories
+     *
+     * @param  string|array $value Real file to check for existence
+     * @param  array        $file  File data from \Zend\File\Transfer\Transfer (optional)
+     * @return bool
+     */
+    public function isValid($value, $file = null)
+    {
+        if (is_string($value) && is_array($file)) {
+            // Legacy Zend\Transfer API support
+            $filename = $file['name'];
+            $file     = $file['tmp_name'];
+            $this->setValue($filename);
+        } elseif (is_array($value)) {
+            if (!isset($value['tmp_name']) || !isset($value['name'])) {
+                throw new Exception\InvalidArgumentException(
+                    'Value array must be in $_FILES format'
+                );
+            }
+            $file     = $value['tmp_name'];
+            $filename = basename($file);
+            $this->setValue($value['name']);
+        } else {
+            $file     = $value;
+            $filename = basename($file);
+            $this->setValue($filename);
+        }
+
+        $check = false;
+        $directories = $this->getDirectory(true);
+        if (!isset($directories)) {
+            $check = true;
+            if (!file_exists($file)) {
+                $this->error(self::DOES_NOT_EXIST);
+                return false;
+            }
+        } else {
+            foreach ($directories as $directory) {
+                if (!isset($directory) || '' === $directory) {
+                    continue;
+                }
+
+                $check = true;
+                if (!file_exists($directory . DIRECTORY_SEPARATOR . $filename)) {
+                    $this->error(self::DOES_NOT_EXIST);
+                    return false;
+                }
+            }
+        }
+
+        if (!$check) {
+            $this->error(self::DOES_NOT_EXIST);
+            return false;
+        }
+
+        return true;
+    }
+}