1504 lines
46 KiB
PHP
1504 lines
46 KiB
PHP
<?php
|
|
/**
|
|
* Zend Framework
|
|
*
|
|
* LICENSE
|
|
*
|
|
* This source file is subject to the new BSD license that is bundled
|
|
* with this package in the file LICENSE.txt.
|
|
* It is also available through the world-wide-web at this URL:
|
|
* http://framework.zend.com/license/new-bsd
|
|
* If you did not receive a copy of the license and are unable to
|
|
* obtain it through the world-wide-web, please send an email
|
|
* to license@zend.com so we can send you a copy immediately.
|
|
*
|
|
* @category Zend
|
|
* @package Zend_File_Transfer
|
|
* @copyright Copyright (c) 2005-2009 Zend Technologies USA Inc. (http://www.zend.com)
|
|
* @license http://framework.zend.com/license/new-bsd New BSD License
|
|
* @version $Id: Abstract.php 17616 2009-08-15 03:28:29Z yoshida@zend.co.jp $
|
|
*/
|
|
|
|
/**
|
|
* Abstract class for file transfers (Downloads and Uploads)
|
|
*
|
|
* @category Zend
|
|
* @package Zend_File_Transfer
|
|
* @copyright Copyright (c) 2005-2009 Zend Technologies USA Inc. (http://www.zend.com)
|
|
* @license http://framework.zend.com/license/new-bsd New BSD License
|
|
*/
|
|
abstract class Zend_File_Transfer_Adapter_Abstract
|
|
{
|
|
/**@+
|
|
* Plugin loader Constants
|
|
*/
|
|
const FILTER = 'FILTER';
|
|
const VALIDATE = 'VALIDATE';
|
|
/**@-*/
|
|
|
|
/**
|
|
* Internal list of breaks
|
|
*
|
|
* @var array
|
|
*/
|
|
protected $_break = array();
|
|
|
|
/**
|
|
* Internal list of filters
|
|
*
|
|
* @var array
|
|
*/
|
|
protected $_filters = array();
|
|
|
|
/**
|
|
* Plugin loaders for filter and validation chains
|
|
*
|
|
* @var array
|
|
*/
|
|
protected $_loaders = array();
|
|
|
|
/**
|
|
* Internal list of messages
|
|
*
|
|
* @var array
|
|
*/
|
|
protected $_messages = array();
|
|
|
|
/**
|
|
* @var Zend_Translate
|
|
*/
|
|
protected $_translator;
|
|
|
|
/**
|
|
* Is translation disabled?
|
|
*
|
|
* @var bool
|
|
*/
|
|
protected $_translatorDisabled = false;
|
|
|
|
/**
|
|
* Internal list of validators
|
|
* @var array
|
|
*/
|
|
protected $_validators = array();
|
|
|
|
/**
|
|
* Internal list of files
|
|
* This array looks like this:
|
|
* array(form => array( - Form is the name within the form or, if not set the filename
|
|
* name, - Original name of this file
|
|
* type, - Mime type of this file
|
|
* size, - Filesize in bytes
|
|
* tmp_name, - Internalally temporary filename for uploaded files
|
|
* error, - Error which has occured
|
|
* destination, - New destination for this file
|
|
* validators, - Set validator names for this file
|
|
* files - Set file names for this file
|
|
* ))
|
|
*
|
|
* @var array
|
|
*/
|
|
protected $_files = array();
|
|
|
|
/**
|
|
* TMP directory
|
|
* @var string
|
|
*/
|
|
protected $_tmpDir;
|
|
|
|
/**
|
|
* Available options for file transfers
|
|
*/
|
|
protected $_options = array(
|
|
'ignoreNoFile' => false,
|
|
'useByteString' => true,
|
|
'magicFile' => null
|
|
);
|
|
|
|
/**
|
|
* Send file
|
|
*
|
|
* @param mixed $options
|
|
* @return bool
|
|
*/
|
|
abstract public function send($options = null);
|
|
|
|
/**
|
|
* Receive file
|
|
*
|
|
* @param mixed $options
|
|
* @return bool
|
|
*/
|
|
abstract public function receive($options = null);
|
|
|
|
/**
|
|
* Is file sent?
|
|
*
|
|
* @param array|string|null $files
|
|
* @return bool
|
|
*/
|
|
abstract public function isSent($files = null);
|
|
|
|
/**
|
|
* Is file received?
|
|
*
|
|
* @param array|string|null $files
|
|
* @return bool
|
|
*/
|
|
abstract public function isReceived($files = null);
|
|
|
|
/**
|
|
* Has a file been uploaded ?
|
|
*
|
|
* @param array|string|null $files
|
|
* @return bool
|
|
*/
|
|
abstract public function isUploaded($files = null);
|
|
|
|
/**
|
|
* Has the file been filtered ?
|
|
*
|
|
* @param array|string|null $files
|
|
* @return bool
|
|
*/
|
|
abstract public function isFiltered($files = null);
|
|
|
|
/**
|
|
* Retrieve progress of transfer
|
|
*
|
|
* @return float
|
|
*/
|
|
public static function getProgress()
|
|
{
|
|
require_once 'Zend/File/Transfer/Exception.php';
|
|
throw new Zend_File_Transfer_Exception('Method must be implemented within the adapter');
|
|
}
|
|
|
|
/**
|
|
* Set plugin loader to use for validator or filter chain
|
|
*
|
|
* @param Zend_Loader_PluginLoader_Interface $loader
|
|
* @param string $type 'filter', or 'validate'
|
|
* @return Zend_File_Transfer_Adapter_Abstract
|
|
* @throws Zend_File_Transfer_Exception on invalid type
|
|
*/
|
|
public function setPluginLoader(Zend_Loader_PluginLoader_Interface $loader, $type)
|
|
{
|
|
$type = strtoupper($type);
|
|
switch ($type) {
|
|
case self::FILTER:
|
|
case self::VALIDATE:
|
|
$this->_loaders[$type] = $loader;
|
|
return $this;
|
|
default:
|
|
require_once 'Zend/File/Transfer/Exception.php';
|
|
throw new Zend_File_Transfer_Exception(sprintf('Invalid type "%s" provided to setPluginLoader()', $type));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Retrieve plugin loader for validator or filter chain
|
|
*
|
|
* Instantiates with default rules if none available for that type. Use
|
|
* 'filter' or 'validate' for $type.
|
|
*
|
|
* @param string $type
|
|
* @return Zend_Loader_PluginLoader
|
|
* @throws Zend_File_Transfer_Exception on invalid type.
|
|
*/
|
|
public function getPluginLoader($type)
|
|
{
|
|
$type = strtoupper($type);
|
|
switch ($type) {
|
|
case self::FILTER:
|
|
case self::VALIDATE:
|
|
$prefixSegment = ucfirst(strtolower($type));
|
|
$pathSegment = $prefixSegment;
|
|
if (!isset($this->_loaders[$type])) {
|
|
$paths = array(
|
|
'Zend_' . $prefixSegment . '_' => 'Zend/' . $pathSegment . '/',
|
|
'Zend_' . $prefixSegment . '_File' => 'Zend/' . $pathSegment . '/File',
|
|
);
|
|
|
|
require_once 'Zend/Loader/PluginLoader.php';
|
|
$this->_loaders[$type] = new Zend_Loader_PluginLoader($paths);
|
|
} else {
|
|
$loader = $this->_loaders[$type];
|
|
$prefix = 'Zend_' . $prefixSegment . '_File_';
|
|
if (!$loader->getPaths($prefix)) {
|
|
$loader->addPrefixPath($prefix, str_replace('_', '/', $prefix));
|
|
}
|
|
}
|
|
return $this->_loaders[$type];
|
|
default:
|
|
require_once 'Zend/File/Transfer/Exception.php';
|
|
throw new Zend_File_Transfer_Exception(sprintf('Invalid type "%s" provided to getPluginLoader()', $type));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Add prefix path for plugin loader
|
|
*
|
|
* If no $type specified, assumes it is a base path for both filters and
|
|
* validators, and sets each according to the following rules:
|
|
* - filters: $prefix = $prefix . '_Filter'
|
|
* - validators: $prefix = $prefix . '_Validate'
|
|
*
|
|
* Otherwise, the path prefix is set on the appropriate plugin loader.
|
|
*
|
|
* @param string $prefix
|
|
* @param string $path
|
|
* @param string $type
|
|
* @return Zend_File_Transfer_Adapter_Abstract
|
|
* @throws Zend_File_Transfer_Exception for invalid type
|
|
*/
|
|
public function addPrefixPath($prefix, $path, $type = null)
|
|
{
|
|
$type = strtoupper($type);
|
|
switch ($type) {
|
|
case self::FILTER:
|
|
case self::VALIDATE:
|
|
$loader = $this->getPluginLoader($type);
|
|
$loader->addPrefixPath($prefix, $path);
|
|
return $this;
|
|
case null:
|
|
$prefix = rtrim($prefix, '_');
|
|
$path = rtrim($path, DIRECTORY_SEPARATOR);
|
|
foreach (array(self::FILTER, self::VALIDATE) as $type) {
|
|
$cType = ucfirst(strtolower($type));
|
|
$pluginPath = $path . DIRECTORY_SEPARATOR . $cType . DIRECTORY_SEPARATOR;
|
|
$pluginPrefix = $prefix . '_' . $cType;
|
|
$loader = $this->getPluginLoader($type);
|
|
$loader->addPrefixPath($pluginPrefix, $pluginPath);
|
|
}
|
|
return $this;
|
|
default:
|
|
require_once 'Zend/File/Transfer/Exception.php';
|
|
throw new Zend_File_Transfer_Exception(sprintf('Invalid type "%s" provided to getPluginLoader()', $type));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Add many prefix paths at once
|
|
*
|
|
* @param array $spec
|
|
* @return Zend_File_Transfer_Exception
|
|
*/
|
|
public function addPrefixPaths(array $spec)
|
|
{
|
|
if (isset($spec['prefix']) && isset($spec['path'])) {
|
|
return $this->addPrefixPath($spec['prefix'], $spec['path']);
|
|
}
|
|
foreach ($spec as $type => $paths) {
|
|
if (is_numeric($type) && is_array($paths)) {
|
|
$type = null;
|
|
if (isset($paths['prefix']) && isset($paths['path'])) {
|
|
if (isset($paths['type'])) {
|
|
$type = $paths['type'];
|
|
}
|
|
$this->addPrefixPath($paths['prefix'], $paths['path'], $type);
|
|
}
|
|
} elseif (!is_numeric($type)) {
|
|
if (!isset($paths['prefix']) || !isset($paths['path'])) {
|
|
foreach ($paths as $prefix => $spec) {
|
|
if (is_array($spec)) {
|
|
foreach ($spec as $path) {
|
|
if (!is_string($path)) {
|
|
continue;
|
|
}
|
|
$this->addPrefixPath($prefix, $path, $type);
|
|
}
|
|
} elseif (is_string($spec)) {
|
|
$this->addPrefixPath($prefix, $spec, $type);
|
|
}
|
|
}
|
|
} else {
|
|
$this->addPrefixPath($paths['prefix'], $paths['path'], $type);
|
|
}
|
|
}
|
|
}
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Adds a new validator for this class
|
|
*
|
|
* @param string|array $validator Type of validator to add
|
|
* @param boolean $breakChainOnFailure If the validation chain should stop an failure
|
|
* @param string|array $options Options to set for the validator
|
|
* @param string|array $files Files to limit this validator to
|
|
* @return Zend_File_Transfer_Adapter
|
|
*/
|
|
public function addValidator($validator, $breakChainOnFailure = false, $options = null, $files = null)
|
|
{
|
|
if ($validator instanceof Zend_Validate_Interface) {
|
|
$name = get_class($validator);
|
|
} elseif (is_string($validator)) {
|
|
$name = $this->getPluginLoader(self::VALIDATE)->load($validator);
|
|
$validator = new $name($options);
|
|
if (is_array($options) && isset($options['messages'])) {
|
|
if (is_array($options['messages'])) {
|
|
$validator->setMessages($options['messages']);
|
|
} elseif (is_string($options['messages'])) {
|
|
$validator->setMessage($options['messages']);
|
|
}
|
|
|
|
unset($options['messages']);
|
|
}
|
|
} else {
|
|
require_once 'Zend/File/Transfer/Exception.php';
|
|
throw new Zend_File_Transfer_Exception('Invalid validator provided to addValidator; must be string or Zend_Validate_Interface');
|
|
}
|
|
|
|
$this->_validators[$name] = $validator;
|
|
$this->_break[$name] = $breakChainOnFailure;
|
|
$files = $this->_getFiles($files, true, true);
|
|
foreach ($files as $file) {
|
|
$this->_files[$file]['validators'][] = $name;
|
|
$this->_files[$file]['validated'] = false;
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Add Multiple validators at once
|
|
*
|
|
* @param array $validators
|
|
* @param string|array $files
|
|
* @return Zend_File_Transfer_Adapter_Abstract
|
|
*/
|
|
public function addValidators(array $validators, $files = null)
|
|
{
|
|
foreach ($validators as $name => $validatorInfo) {
|
|
if ($validatorInfo instanceof Zend_Validate_Interface) {
|
|
$this->addValidator($validatorInfo, null, null, $files);
|
|
} else if (is_string($validatorInfo)) {
|
|
if (!is_int($name)) {
|
|
$this->addValidator($name, null, $validatorInfo, $files);
|
|
} else {
|
|
$this->addValidator($validatorInfo, null, null, $files);
|
|
}
|
|
} else if (is_array($validatorInfo)) {
|
|
$argc = count($validatorInfo);
|
|
$breakChainOnFailure = false;
|
|
$options = array();
|
|
if (isset($validatorInfo['validator'])) {
|
|
$validator = $validatorInfo['validator'];
|
|
if (isset($validatorInfo['breakChainOnFailure'])) {
|
|
$breakChainOnFailure = $validatorInfo['breakChainOnFailure'];
|
|
}
|
|
|
|
if (isset($validatorInfo['options'])) {
|
|
$options = $validatorInfo['options'];
|
|
}
|
|
|
|
$this->addValidator($validator, $breakChainOnFailure, $options, $files);
|
|
} else {
|
|
if (is_string($name)) {
|
|
$validator = $name;
|
|
$options = $validatorInfo;
|
|
$this->addValidator($validator, $breakChainOnFailure, $options, $files);
|
|
} else {
|
|
switch (true) {
|
|
case (0 == $argc):
|
|
break;
|
|
case (1 <= $argc):
|
|
$validator = array_shift($validatorInfo);
|
|
case (2 <= $argc):
|
|
$breakChainOnFailure = array_shift($validatorInfo);
|
|
case (3 <= $argc):
|
|
$options = array_shift($validatorInfo);
|
|
case (4 <= $argc):
|
|
$files = array_shift($validatorInfo);
|
|
default:
|
|
$this->addValidator($validator, $breakChainOnFailure, $options, $files);
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
} else {
|
|
require_once 'Zend/File/Transfer/Exception.php';
|
|
throw new Zend_File_Transfer_Exception('Invalid validator passed to addValidators()');
|
|
}
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Sets a validator for the class, erasing all previous set
|
|
*
|
|
* @param string|array $validator Validator to set
|
|
* @param string|array $files Files to limit this validator to
|
|
* @return Zend_File_Transfer_Adapter
|
|
*/
|
|
public function setValidators(array $validators, $files = null)
|
|
{
|
|
$this->clearValidators();
|
|
return $this->addValidators($validators, $files);
|
|
}
|
|
|
|
/**
|
|
* Determine if a given validator has already been registered
|
|
*
|
|
* @param string $name
|
|
* @return bool
|
|
*/
|
|
public function hasValidator($name)
|
|
{
|
|
return (false !== $this->_getValidatorIdentifier($name));
|
|
}
|
|
|
|
/**
|
|
* Retrieve individual validator
|
|
*
|
|
* @param string $name
|
|
* @return Zend_Validate_Interface|null
|
|
*/
|
|
public function getValidator($name)
|
|
{
|
|
if (false === ($identifier = $this->_getValidatorIdentifier($name))) {
|
|
return null;
|
|
}
|
|
return $this->_validators[$identifier];
|
|
}
|
|
|
|
/**
|
|
* Returns all set validators
|
|
*
|
|
* @param string|array $files (Optional) Returns the validator for this files
|
|
* @return null|array List of set validators
|
|
*/
|
|
public function getValidators($files = null)
|
|
{
|
|
$files = $this->_getFiles($files, true, true);
|
|
|
|
if (empty($files)) {
|
|
return $this->_validators;
|
|
}
|
|
|
|
$validators = array();
|
|
foreach ($files as $file) {
|
|
if (!empty($this->_files[$file]['validators'])) {
|
|
$validators += $this->_files[$file]['validators'];
|
|
}
|
|
}
|
|
$validators = array_unique($validators);
|
|
|
|
$result = array();
|
|
foreach ($validators as $validator) {
|
|
$result[$validator] = $this->_validators[$validator];
|
|
}
|
|
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* Remove an individual validator
|
|
*
|
|
* @param string $name
|
|
* @return Zend_File_Transfer_Adapter_Abstract
|
|
*/
|
|
public function removeValidator($name)
|
|
{
|
|
if (false === ($key = $this->_getValidatorIdentifier($name))) {
|
|
return $this;
|
|
}
|
|
|
|
unset($this->_validators[$key]);
|
|
foreach (array_keys($this->_files) as $file) {
|
|
if (empty($this->_files[$file]['validators'])) {
|
|
continue;
|
|
}
|
|
|
|
$index = array_search($key, $this->_files[$file]['validators']);
|
|
if ($index === false) {
|
|
continue;
|
|
}
|
|
|
|
unset($this->_files[$file]['validators'][$index]);
|
|
$this->_files[$file]['validated'] = false;
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Remove all validators
|
|
*
|
|
* @return Zend_File_Transfer_Adapter_Abstract
|
|
*/
|
|
public function clearValidators()
|
|
{
|
|
$this->_validators = array();
|
|
foreach (array_keys($this->_files) as $file) {
|
|
$this->_files[$file]['validators'] = array();
|
|
$this->_files[$file]['validated'] = false;
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Sets Options for adapters
|
|
*
|
|
* @param array $options Options to set
|
|
* @param array $files (Optional) Files to set the options for
|
|
*/
|
|
public function setOptions($options = array(), $files = null) {
|
|
$file = $this->_getFiles($files, false, true);
|
|
|
|
if (is_array($options)) {
|
|
foreach ($options as $name => $value) {
|
|
foreach ($file as $key => $content) {
|
|
switch ($name) {
|
|
case 'magicFile' :
|
|
$this->_files[$key]['options'][$name] = (string) $value;
|
|
break;
|
|
|
|
case 'ignoreNoFile' :
|
|
case 'useByteString' :
|
|
$this->_files[$key]['options'][$name] = (boolean) $value;
|
|
break;
|
|
|
|
default:
|
|
require_once 'Zend/File/Transfer/Exception.php';
|
|
throw new Zend_File_Transfer_Exception("Unknown option: $name = $value");
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Returns set options for adapters or files
|
|
*
|
|
* @param array $files (Optional) Files to return the options for
|
|
* @return array Options for given files
|
|
*/
|
|
public function getOptions($files = null) {
|
|
$file = $this->_getFiles($files, false, true);
|
|
|
|
foreach ($file as $key => $content) {
|
|
if (isset($this->_files[$key]['options'])) {
|
|
$options[$key] = $this->_files[$key]['options'];
|
|
} else {
|
|
$options[$key] = array();
|
|
}
|
|
}
|
|
|
|
return $options;
|
|
}
|
|
|
|
/**
|
|
* Checks if the files are valid
|
|
*
|
|
* @param string|array $files (Optional) Files to check
|
|
* @return boolean True if all checks are valid
|
|
*/
|
|
public function isValid($files = null)
|
|
{
|
|
$check = $this->_getFiles($files, false, true);
|
|
if (empty($check)) {
|
|
return false;
|
|
}
|
|
|
|
$translator = $this->getTranslator();
|
|
$this->_messages = array();
|
|
$break = false;
|
|
foreach($check as $key => $content) {
|
|
if (array_key_exists('validators', $content) &&
|
|
in_array('Zend_Validate_File_Count', $content['validators'])) {
|
|
$validator = $this->_validators['Zend_Validate_File_Count'];
|
|
$validator->addFile($content['tmp_name']);
|
|
$count = $content;
|
|
}
|
|
}
|
|
|
|
if (isset($count)) {
|
|
if (!$validator->isValid($count['tmp_name'], $count)) {
|
|
$this->_messages += $validator->getMessages();
|
|
}
|
|
}
|
|
|
|
foreach ($check as $key => $content) {
|
|
$fileerrors = array();
|
|
if (array_key_exists('validators', $content) && $content['validated']) {
|
|
continue;
|
|
}
|
|
|
|
if (array_key_exists('validators', $content)) {
|
|
foreach ($content['validators'] as $class) {
|
|
$validator = $this->_validators[$class];
|
|
if (method_exists($validator, 'setTranslator')) {
|
|
$validator->setTranslator($translator);
|
|
}
|
|
|
|
if (($class === 'Zend_Validate_File_Upload') and (empty($content['tmp_name']))) {
|
|
$tocheck = $key;
|
|
} else {
|
|
$tocheck = $content['tmp_name'];
|
|
}
|
|
|
|
if (!$validator->isValid($tocheck, $content)) {
|
|
$fileerrors += $validator->getMessages();
|
|
}
|
|
|
|
if (!empty($content['options']['ignoreNoFile']) and (isset($fileerrors['fileUploadErrorNoFile']))) {
|
|
unset($fileerrors['fileUploadErrorNoFile']);
|
|
break;
|
|
}
|
|
|
|
if (($class === 'Zend_Validate_File_Upload') and (count($fileerrors) > 0)) {
|
|
break;
|
|
}
|
|
|
|
if (($this->_break[$class]) and (count($fileerrors) > 0)) {
|
|
$break = true;
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
if (count($fileerrors) > 0) {
|
|
$this->_files[$key]['validated'] = false;
|
|
} else {
|
|
$this->_files[$key]['validated'] = true;
|
|
}
|
|
|
|
$this->_messages += $fileerrors;
|
|
if ($break) {
|
|
break;
|
|
}
|
|
}
|
|
|
|
if (count($this->_messages) > 0) {
|
|
return false;
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Returns found validation messages
|
|
*
|
|
* @return array
|
|
*/
|
|
public function getMessages()
|
|
{
|
|
return $this->_messages;
|
|
}
|
|
|
|
/**
|
|
* Retrieve error codes
|
|
*
|
|
* @return array
|
|
*/
|
|
public function getErrors()
|
|
{
|
|
return array_keys($this->_messages);
|
|
}
|
|
|
|
/**
|
|
* Are there errors registered?
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public function hasErrors()
|
|
{
|
|
return (!empty($this->_messages));
|
|
}
|
|
|
|
/**
|
|
* Adds a new filter for this class
|
|
*
|
|
* @param string|array $filter Type of filter to add
|
|
* @param string|array $options Options to set for the filter
|
|
* @param string|array $files Files to limit this filter to
|
|
* @return Zend_File_Transfer_Adapter
|
|
*/
|
|
public function addFilter($filter, $options = null, $files = null)
|
|
{
|
|
if ($filter instanceof Zend_Filter_Interface) {
|
|
$class = get_class($filter);
|
|
} elseif (is_string($filter)) {
|
|
$class = $this->getPluginLoader(self::FILTER)->load($filter);
|
|
$filter = new $class($options);
|
|
} else {
|
|
require_once 'Zend/File/Transfer/Exception.php';
|
|
throw new Zend_File_Transfer_Exception('Invalid filter specified');
|
|
}
|
|
|
|
$this->_filters[$class] = $filter;
|
|
$files = $this->_getFiles($files, true, true);
|
|
foreach ($files as $file) {
|
|
$this->_files[$file]['filters'][] = $class;
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Add Multiple filters at once
|
|
*
|
|
* @param array $filters
|
|
* @param string|array $files
|
|
* @return Zend_File_Transfer_Adapter_Abstract
|
|
*/
|
|
public function addFilters(array $filters, $files = null)
|
|
{
|
|
foreach ($filters as $key => $spec) {
|
|
if ($spec instanceof Zend_Filter_Interface) {
|
|
$this->addFilter($spec, null, $files);
|
|
continue;
|
|
}
|
|
|
|
if (is_string($key)) {
|
|
$this->addFilter($key, $spec, $files);
|
|
continue;
|
|
}
|
|
|
|
if (is_int($key)) {
|
|
if (is_string($spec)) {
|
|
$this->addFilter($spec, null, $files);
|
|
continue;
|
|
}
|
|
|
|
if (is_array($spec)) {
|
|
if (!array_key_exists('filter', $spec)) {
|
|
continue;
|
|
}
|
|
|
|
$filter = $spec['filter'];
|
|
unset($spec['filter']);
|
|
$this->addFilter($filter, $spec, $files);
|
|
continue;
|
|
}
|
|
|
|
continue;
|
|
}
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Sets a filter for the class, erasing all previous set
|
|
*
|
|
* @param string|array $filter Filter to set
|
|
* @param string|array $files Files to limit this filter to
|
|
* @return Zend_File_Transfer_Adapter
|
|
*/
|
|
public function setFilters(array $filters, $files = null)
|
|
{
|
|
$this->clearFilters();
|
|
return $this->addFilters($filters, $files);
|
|
}
|
|
|
|
/**
|
|
* Determine if a given filter has already been registered
|
|
*
|
|
* @param string $name
|
|
* @return bool
|
|
*/
|
|
public function hasFilter($name)
|
|
{
|
|
return (false !== $this->_getFilterIdentifier($name));
|
|
}
|
|
|
|
/**
|
|
* Retrieve individual filter
|
|
*
|
|
* @param string $name
|
|
* @return Zend_Filter_Interface|null
|
|
*/
|
|
public function getFilter($name)
|
|
{
|
|
if (false === ($identifier = $this->_getFilterIdentifier($name))) {
|
|
return null;
|
|
}
|
|
return $this->_filters[$identifier];
|
|
}
|
|
|
|
/**
|
|
* Returns all set filters
|
|
*
|
|
* @param string|array $files (Optional) Returns the filter for this files
|
|
* @return array List of set filters
|
|
* @throws Zend_File_Transfer_Exception When file not found
|
|
*/
|
|
public function getFilters($files = null)
|
|
{
|
|
if ($files === null) {
|
|
return $this->_filters;
|
|
}
|
|
|
|
$files = $this->_getFiles($files, true, true);
|
|
$filters = array();
|
|
foreach ($files as $file) {
|
|
if (!empty($this->_files[$file]['filters'])) {
|
|
$filters += $this->_files[$file]['filters'];
|
|
}
|
|
}
|
|
|
|
$filters = array_unique($filters);
|
|
$result = array();
|
|
foreach ($filters as $filter) {
|
|
$result[] = $this->_filters[$filter];
|
|
}
|
|
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* Remove an individual filter
|
|
*
|
|
* @param string $name
|
|
* @return Zend_File_Transfer_Adapter_Abstract
|
|
*/
|
|
public function removeFilter($name)
|
|
{
|
|
if (false === ($key = $this->_getFilterIdentifier($name))) {
|
|
return $this;
|
|
}
|
|
|
|
unset($this->_filters[$key]);
|
|
foreach (array_keys($this->_files) as $file) {
|
|
if (empty($this->_files[$file]['filters'])) {
|
|
continue;
|
|
}
|
|
|
|
$index = array_search($key, $this->_files[$file]['filters']);
|
|
if ($index === false) {
|
|
continue;
|
|
}
|
|
|
|
unset($this->_files[$file]['filters'][$index]);
|
|
}
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Remove all filters
|
|
*
|
|
* @return Zend_File_Transfer_Adapter_Abstract
|
|
*/
|
|
public function clearFilters()
|
|
{
|
|
$this->_filters = array();
|
|
foreach (array_keys($this->_files) as $file) {
|
|
$this->_files[$file]['filters'] = array();
|
|
}
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Returns all set files
|
|
*
|
|
* @return array List of set files
|
|
* @throws Zend_File_Transfer_Exception Not implemented
|
|
*/
|
|
public function getFile()
|
|
{
|
|
require_once 'Zend/File/Transfer/Exception.php';
|
|
throw new Zend_File_Transfer_Exception('Method not implemented');
|
|
}
|
|
|
|
/**
|
|
* Retrieves the filename of transferred files.
|
|
*
|
|
* @param string $fileelement (Optional) Element to return the filename for
|
|
* @param boolean $path (Optional) Should the path also be returned ?
|
|
* @return string|array
|
|
*/
|
|
public function getFileName($file = null, $path = true)
|
|
{
|
|
$files = $this->_getFiles($file, true, true);
|
|
$result = array();
|
|
$directory = "";
|
|
foreach($files as $file) {
|
|
if (empty($this->_files[$file]['name'])) {
|
|
continue;
|
|
}
|
|
|
|
if ($path === true) {
|
|
$directory = $this->getDestination($file) . DIRECTORY_SEPARATOR;
|
|
}
|
|
|
|
$result[$file] = $directory . $this->_files[$file]['name'];
|
|
}
|
|
|
|
if (count($result) == 1) {
|
|
return current($result);
|
|
}
|
|
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* Retrieve additional internal file informations for files
|
|
*
|
|
* @param string $file (Optional) File to get informations for
|
|
* @return array
|
|
*/
|
|
public function getFileInfo($file = null)
|
|
{
|
|
return $this->_getFiles($file);
|
|
}
|
|
|
|
/**
|
|
* Adds one or more files
|
|
*
|
|
* @param string|array $file File to add
|
|
* @param string|array $validator Validators to use for this file, must be set before
|
|
* @param string|array $filter Filters to use for this file, must be set before
|
|
* @return Zend_File_Transfer_Adapter_Abstract
|
|
* @throws Zend_File_Transfer_Exception Not implemented
|
|
*/
|
|
public function addFile($file, $validator = null, $filter = null)
|
|
{
|
|
require_once 'Zend/File/Transfer/Exception.php';
|
|
throw new Zend_File_Transfer_Exception('Method not implemented');
|
|
}
|
|
|
|
/**
|
|
* Returns all set types
|
|
*
|
|
* @return array List of set types
|
|
* @throws Zend_File_Transfer_Exception Not implemented
|
|
*/
|
|
public function getType()
|
|
{
|
|
require_once 'Zend/File/Transfer/Exception.php';
|
|
throw new Zend_File_Transfer_Exception('Method not implemented');
|
|
}
|
|
|
|
/**
|
|
* Adds one or more type of files
|
|
*
|
|
* @param string|array $type Type of files to add
|
|
* @param string|array $validator Validators to use for this file, must be set before
|
|
* @param string|array $filter Filters to use for this file, must be set before
|
|
* @return Zend_File_Transfer_Adapter_Abstract
|
|
* @throws Zend_File_Transfer_Exception Not implemented
|
|
*/
|
|
public function addType($type, $validator = null, $filter = null)
|
|
{
|
|
require_once 'Zend/File/Transfer/Exception.php';
|
|
throw new Zend_File_Transfer_Exception('Method not implemented');
|
|
}
|
|
|
|
/**
|
|
* Sets a new destination for the given files
|
|
*
|
|
* @deprecated Will be changed to be a filter!!!
|
|
* @param string $destination New destination directory
|
|
* @param string|array $files Files to set the new destination for
|
|
* @return Zend_File_Transfer_Abstract
|
|
* @throws Zend_File_Transfer_Exception when the given destination is not a directory or does not exist
|
|
*/
|
|
public function setDestination($destination, $files = null)
|
|
{
|
|
$orig = $files;
|
|
$destination = rtrim($destination, "/\\");
|
|
if (!is_dir($destination)) {
|
|
require_once 'Zend/File/Transfer/Exception.php';
|
|
throw new Zend_File_Transfer_Exception('The given destination is no directory or does not exist');
|
|
}
|
|
|
|
if (!is_writable($destination)) {
|
|
require_once 'Zend/File/Transfer/Exception.php';
|
|
throw new Zend_File_Transfer_Exception('The given destination is not writeable');
|
|
}
|
|
|
|
if ($files === null) {
|
|
foreach ($this->_files as $file => $content) {
|
|
$this->_files[$file]['destination'] = $destination;
|
|
}
|
|
} else {
|
|
$files = $this->_getFiles($files, true, true);
|
|
if (empty($files) and is_string($orig)) {
|
|
$this->_files[$orig]['destination'] = $destination;
|
|
}
|
|
|
|
foreach ($files as $file) {
|
|
$this->_files[$file]['destination'] = $destination;
|
|
}
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Retrieve destination directory value
|
|
*
|
|
* @param null|string|array $files
|
|
* @return null|string|array
|
|
*/
|
|
public function getDestination($files = null)
|
|
{
|
|
$orig = $files;
|
|
$files = $this->_getFiles($files, false, true);
|
|
$destinations = array();
|
|
if (empty($files) and is_string($orig)) {
|
|
if (isset($this->_files[$orig]['destination'])) {
|
|
$destinations[$orig] = $this->_files[$orig]['destination'];
|
|
} else {
|
|
require_once 'Zend/File/Transfer/Exception.php';
|
|
throw new Zend_File_Transfer_Exception(sprintf('"%s" not found by file transfer adapter', $orig));
|
|
}
|
|
}
|
|
|
|
foreach ($files as $key => $content) {
|
|
if (isset($this->_files[$key]['destination'])) {
|
|
$destinations[$key] = $this->_files[$key]['destination'];
|
|
} else {
|
|
$tmpdir = $this->_getTmpDir();
|
|
$this->setDestination($tmpdir, $key);
|
|
$destinations[$key] = $tmpdir;
|
|
}
|
|
}
|
|
|
|
if (empty($destinations)) {
|
|
$destinations = $this->_getTmpDir();
|
|
} else if (count($destinations) == 1) {
|
|
$destinations = current($destinations);
|
|
}
|
|
|
|
return $destinations;
|
|
}
|
|
|
|
/**
|
|
* Set translator object for localization
|
|
*
|
|
* @param Zend_Translate|null $translator
|
|
* @return Zend_File_Transfer_Abstract
|
|
*/
|
|
public function setTranslator($translator = null)
|
|
{
|
|
if (null === $translator) {
|
|
$this->_translator = null;
|
|
} elseif ($translator instanceof Zend_Translate_Adapter) {
|
|
$this->_translator = $translator;
|
|
} elseif ($translator instanceof Zend_Translate) {
|
|
$this->_translator = $translator->getAdapter();
|
|
} else {
|
|
require_once 'Zend/File/Transfer/Exception.php';
|
|
throw new Zend_File_Transfer_Exception('Invalid translator specified');
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Retrieve localization translator object
|
|
*
|
|
* @return Zend_Translate_Adapter|null
|
|
*/
|
|
public function getTranslator()
|
|
{
|
|
if ($this->translatorIsDisabled()) {
|
|
return null;
|
|
}
|
|
|
|
return $this->_translator;
|
|
}
|
|
|
|
/**
|
|
* Indicate whether or not translation should be disabled
|
|
*
|
|
* @param bool $flag
|
|
* @return Zend_File_Transfer_Abstract
|
|
*/
|
|
public function setDisableTranslator($flag)
|
|
{
|
|
$this->_translatorDisabled = (bool) $flag;
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Is translation disabled?
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function translatorIsDisabled()
|
|
{
|
|
return $this->_translatorDisabled;
|
|
}
|
|
|
|
/**
|
|
* Returns the hash for a given file
|
|
*
|
|
* @param string $hash Hash algorithm to use
|
|
* @param string|array $files Files to return the hash for
|
|
* @return string|array Hashstring
|
|
* @throws Zend_File_Transfer_Exception On unknown hash algorithm
|
|
*/
|
|
public function getHash($hash = 'crc32', $files = null)
|
|
{
|
|
if (!in_array($hash, hash_algos())) {
|
|
require_once 'Zend/File/Transfer/Exception.php';
|
|
throw new Zend_File_Transfer_Exception('Unknown hash algorithm');
|
|
}
|
|
|
|
$files = $this->_getFiles($files);
|
|
$result = array();
|
|
foreach($files as $key => $value) {
|
|
if (file_exists($value['name'])) {
|
|
$result[$key] = hash_file($hash, $value['name']);
|
|
} else if (file_exists($value['tmp_name'])) {
|
|
$result[$key] = hash_file($hash, $value['tmp_name']);
|
|
} else {
|
|
require_once 'Zend/File/Transfer/Exception.php';
|
|
throw new Zend_File_Transfer_Exception("File '{$value['name']}' does not exist");
|
|
}
|
|
}
|
|
|
|
if (count($result) == 1) {
|
|
return current($result);
|
|
}
|
|
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* Returns the real filesize of the file
|
|
*
|
|
* @param string|array $files Files to get the filesize from
|
|
* @throws Zend_File_Transfer_Exception When the file does not exist
|
|
* @return string|array Filesize
|
|
*/
|
|
public function getFileSize($files = null)
|
|
{
|
|
$files = $this->_getFiles($files);
|
|
$result = array();
|
|
foreach($files as $key => $value) {
|
|
if (file_exists($value['name'])) {
|
|
$size = sprintf("%u", @filesize($value['name']));
|
|
} else if (file_exists($value['tmp_name'])) {
|
|
$size = sprintf("%u", @filesize($value['tmp_name']));
|
|
} else {
|
|
require_once 'Zend/File/Transfer/Exception.php';
|
|
throw new Zend_File_Transfer_Exception("File '{$value['name']}' does not exist");
|
|
}
|
|
|
|
if ($value['options']['useByteString']) {
|
|
$result[$key] = self::_toByteString($size);
|
|
} else {
|
|
$result[$key] = $size;
|
|
}
|
|
}
|
|
|
|
if (count($result) == 1) {
|
|
return current($result);
|
|
}
|
|
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* Returns the real mimetype of the file
|
|
* Uses fileinfo, when not available mime_magic and as last fallback a manual given mimetype
|
|
*
|
|
* @param string|array $files Files to get the mimetype from
|
|
* @throws Zend_File_Transfer_Exception When the file does not exist
|
|
* @return string|array MimeType
|
|
*/
|
|
public function getMimeType($files = null)
|
|
{
|
|
$files = $this->_getFiles($files);
|
|
$result = array();
|
|
foreach($files as $key => $value) {
|
|
if (file_exists($value['name'])) {
|
|
$file = $value['name'];
|
|
} else if (file_exists($value['tmp_name'])) {
|
|
$file = $value['tmp_name'];
|
|
} else {
|
|
require_once 'Zend/File/Transfer/Exception.php';
|
|
throw new Zend_File_Transfer_Exception("File '{$value['name']}' does not exist");
|
|
}
|
|
|
|
if (class_exists('finfo', false)) {
|
|
$const = defined('FILEINFO_MIME_TYPE') ? FILEINFO_MIME_TYPE : FILEINFO_MIME;
|
|
if (!empty($value['options']['magicFile'])) {
|
|
$mime = new finfo($const, $value['options']['magicFile']);
|
|
} else {
|
|
$mime = new finfo($const);
|
|
}
|
|
|
|
if ($mime !== false) {
|
|
$result[$key] = $mime->file($file);
|
|
}
|
|
|
|
unset($mime);
|
|
}
|
|
|
|
if (empty($result[$key])) {
|
|
if (function_exists('mime_content_type') && ini_get('mime_magic.magicfile')) {
|
|
$result[$key] = mime_content_type($file);
|
|
} else {
|
|
$result[$key] = $value['type'];
|
|
}
|
|
}
|
|
|
|
if (empty($result[$key])) {
|
|
require_once 'Zend/File/Transfer/Exception.php';
|
|
throw new Zend_File_Transfer_Exception("The mimetype of file '{$value['name']}' could not been detected");
|
|
}
|
|
}
|
|
|
|
if (count($result) == 1) {
|
|
return current($result);
|
|
}
|
|
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* Returns the formatted size
|
|
*
|
|
* @param integer $size
|
|
* @return string
|
|
*/
|
|
protected static function _toByteString($size)
|
|
{
|
|
$sizes = array('B', 'kB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB');
|
|
for ($i=0; $size >= 1024 && $i < 9; $i++) {
|
|
$size /= 1024;
|
|
}
|
|
|
|
return round($size, 2) . $sizes[$i];
|
|
}
|
|
|
|
/**
|
|
* Internal function to filter all given files
|
|
*
|
|
* @param string|array $files (Optional) Files to check
|
|
* @return boolean False on error
|
|
*/
|
|
protected function _filter($files = null)
|
|
{
|
|
$check = $this->_getFiles($files);
|
|
foreach ($check as $name => $content) {
|
|
if (array_key_exists('filters', $content)) {
|
|
foreach ($content['filters'] as $class) {
|
|
$filter = $this->_filters[$class];
|
|
try {
|
|
$result = $filter->filter($this->getFileName($name));
|
|
|
|
$this->_files[$name]['destination'] = dirname($result);
|
|
$this->_files[$name]['name'] = basename($result);
|
|
} catch (Zend_Filter_Exception $e) {
|
|
$this->_messages += array($e->getMessage());
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
if (count($this->_messages) > 0) {
|
|
return false;
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Determine system TMP directory and detect if we have read access
|
|
*
|
|
* @return string
|
|
* @throws Zend_File_Transfer_Exception if unable to determine directory
|
|
*/
|
|
protected function _getTmpDir()
|
|
{
|
|
if (null === $this->_tmpDir) {
|
|
$tmpdir = array();
|
|
if (function_exists('sys_get_temp_dir')) {
|
|
$tmpdir[] = sys_get_temp_dir();
|
|
}
|
|
|
|
if (!empty($_ENV['TMP'])) {
|
|
$tmpdir[] = realpath($_ENV['TMP']);
|
|
}
|
|
|
|
if (!empty($_ENV['TMPDIR'])) {
|
|
$tmpdir[] = realpath($_ENV['TMPDIR']);
|
|
}
|
|
|
|
if (!empty($_ENV['TEMP'])) {
|
|
$tmpdir[] = realpath($_ENV['TEMP']);
|
|
}
|
|
|
|
$upload = ini_get('upload_tmp_dir');
|
|
if ($upload) {
|
|
$tmpdir[] = realpath($upload);
|
|
}
|
|
|
|
foreach($tmpdir as $directory) {
|
|
if ($this->_isPathWriteable($directory)) {
|
|
$this->_tmpDir = $directory;
|
|
}
|
|
}
|
|
|
|
if (empty($this->_tmpDir)) {
|
|
// Attemp to detect by creating a temporary file
|
|
$tempFile = tempnam(md5(uniqid(rand(), TRUE)), '');
|
|
if ($tempFile) {
|
|
$this->_tmpDir = realpath(dirname($tempFile));
|
|
unlink($tempFile);
|
|
} else {
|
|
require_once 'Zend/File/Transfer/Exception.php';
|
|
throw new Zend_File_Transfer_Exception('Could not determine temp directory');
|
|
}
|
|
}
|
|
|
|
$this->_tmpDir = rtrim($this->_tmpDir, "/\\");
|
|
}
|
|
return $this->_tmpDir;
|
|
}
|
|
|
|
/**
|
|
* Tries to detect if we can read and write to the given path
|
|
*
|
|
* @param string $path
|
|
*/
|
|
protected function _isPathWriteable($path)
|
|
{
|
|
$tempFile = rtrim($path, "/\\");
|
|
$tempFile .= '/' . 'test.1';
|
|
|
|
$result = @file_put_contents($tempFile, 'TEST');
|
|
|
|
if ($result == false) {
|
|
return false;
|
|
}
|
|
|
|
$result = @unlink($tempFile);
|
|
|
|
if ($result == false) {
|
|
return false;
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Returns found files based on internal file array and given files
|
|
*
|
|
* @param string|array $files (Optional) Files to return
|
|
* @param boolean $names (Optional) Returns only names on true, else complete info
|
|
* @param boolean $noexception (Optional) Allows throwing an exception, otherwise returns an empty array
|
|
* @return array Found files
|
|
* @throws Zend_File_Transfer_Exception On false filename
|
|
*/
|
|
protected function _getFiles($files, $names = false, $noexception = false)
|
|
{
|
|
$check = array();
|
|
|
|
if (is_string($files)) {
|
|
$files = array($files);
|
|
}
|
|
|
|
if (is_array($files)) {
|
|
foreach ($files as $find) {
|
|
$found = array();
|
|
foreach ($this->_files as $file => $content) {
|
|
if (!isset($content['name'])) {
|
|
continue;
|
|
}
|
|
|
|
if (($content['name'] === $find) && isset($content['multifiles'])) {
|
|
foreach ($content['multifiles'] as $multifile) {
|
|
$found[] = $multifile;
|
|
}
|
|
break;
|
|
}
|
|
|
|
if ($file === $find) {
|
|
$found[] = $file;
|
|
break;
|
|
}
|
|
|
|
if ($content['name'] === $find) {
|
|
$found[] = $file;
|
|
break;
|
|
}
|
|
}
|
|
|
|
if (empty($found)) {
|
|
if ($noexception !== false) {
|
|
return array();
|
|
}
|
|
|
|
require_once 'Zend/File/Transfer/Exception.php';
|
|
throw new Zend_File_Transfer_Exception(sprintf('"%s" not found by file transfer adapter', $find));
|
|
}
|
|
|
|
foreach ($found as $checked) {
|
|
$check[$checked] = $this->_files[$checked];
|
|
}
|
|
}
|
|
}
|
|
|
|
if ($files === null) {
|
|
$check = $this->_files;
|
|
$keys = array_keys($check);
|
|
foreach ($keys as $key) {
|
|
if (isset($check[$key]['multifiles'])) {
|
|
unset($check[$key]);
|
|
}
|
|
}
|
|
}
|
|
|
|
if ($names) {
|
|
$check = array_keys($check);
|
|
}
|
|
|
|
return $check;
|
|
}
|
|
|
|
/**
|
|
* Retrieve internal identifier for a named validator
|
|
*
|
|
* @param string $name
|
|
* @return string
|
|
*/
|
|
protected function _getValidatorIdentifier($name)
|
|
{
|
|
if (array_key_exists($name, $this->_validators)) {
|
|
return $name;
|
|
}
|
|
|
|
foreach (array_keys($this->_validators) as $test) {
|
|
if (preg_match('/' . preg_quote($name) . '$/i', $test)) {
|
|
return $test;
|
|
}
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Retrieve internal identifier for a named filter
|
|
*
|
|
* @param string $name
|
|
* @return string
|
|
*/
|
|
protected function _getFilterIdentifier($name)
|
|
{
|
|
if (array_key_exists($name, $this->_filters)) {
|
|
return $name;
|
|
}
|
|
|
|
foreach (array_keys($this->_filters) as $test) {
|
|
if (preg_match('/' . preg_quote($name) . '$/i', $test)) {
|
|
return $test;
|
|
}
|
|
}
|
|
|
|
return false;
|
|
}
|
|
}
|