/library/Zend/Filter/RealPath.php
PHP | 135 lines | 83 code | 13 blank | 39 comment | 18 complexity | 34dc8f2f8f2251c0e06a4dc712687541 MD5 | raw file
Possible License(s): BSD-3-Clause
- <?php
- /**
- * Zend Framework (http://framework.zend.com/)
- *
- * @link http://github.com/zendframework/zf2 for the canonical source repository
- * @copyright Copyright (c) 2005-2013 Zend Technologies USA Inc. (http://www.zend.com)
- * @license http://framework.zend.com/license/new-bsd New BSD License
- */
- namespace Zend\Filter;
- use Traversable;
- use Zend\Stdlib\ErrorHandler;
- class RealPath extends AbstractFilter
- {
- /**
- * @var array $options
- */
- protected $options = array(
- 'exists' => true
- );
- /**
- * Class constructor
- *
- * @param bool|Traversable $existsOrOptions Options to set
- */
- public function __construct($existsOrOptions = true)
- {
- if ($existsOrOptions !== null) {
- if (!static::isOptions($existsOrOptions)) {
- $this->setExists($existsOrOptions);
- } else {
- $this->setOptions($existsOrOptions);
- }
- }
- }
- /**
- * Sets if the path has to exist
- * TRUE when the path must exist
- * FALSE when not existing paths can be given
- *
- * @param bool $flag Path must exist
- * @return self
- */
- public function setExists($flag = true)
- {
- $this->options['exists'] = (bool) $flag;
- return $this;
- }
- /**
- * Returns true if the filtered path must exist
- *
- * @return bool
- */
- public function getExists()
- {
- return $this->options['exists'];
- }
- /**
- * Defined by Zend\Filter\FilterInterface
- *
- * Returns realpath($value)
- *
- * If the value provided is non-scalar, the value will remain unfiltered
- * and an E_USER_WARNING will be raised indicating it's unfilterable.
- *
- * @param string $value
- * @return string|mixed
- */
- public function filter($value)
- {
- if (null === $value) {
- return null;
- }
- if (!is_scalar($value)){
- trigger_error(
- sprintf(
- '%s expects parameter to be scalar, "%s" given; cannot filter',
- __METHOD__,
- (is_object($value) ? get_class($value) : gettype($value))
- ),
- E_USER_WARNING
- );
- return $value;
- }
- $path = (string) $value;
- if ($this->options['exists']) {
- return realpath($path);
- }
- ErrorHandler::start();
- $realpath = realpath($path);
- ErrorHandler::stop();
- if ($realpath) {
- return $realpath;
- }
- $drive = '';
- if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') {
- $path = preg_replace('/[\\\\\/]/', DIRECTORY_SEPARATOR, $path);
- if (preg_match('/([a-zA-Z]\:)(.*)/', $path, $matches)) {
- list(, $drive, $path) = $matches;
- } else {
- $cwd = getcwd();
- $drive = substr($cwd, 0, 2);
- if (substr($path, 0, 1) != DIRECTORY_SEPARATOR) {
- $path = substr($cwd, 3) . DIRECTORY_SEPARATOR . $path;
- }
- }
- } elseif (substr($path, 0, 1) != DIRECTORY_SEPARATOR) {
- $path = getcwd() . DIRECTORY_SEPARATOR . $path;
- }
- $stack = array();
- $parts = explode(DIRECTORY_SEPARATOR, $path);
- foreach ($parts as $dir) {
- if (strlen($dir) && $dir !== '.') {
- if ($dir == '..') {
- array_pop($stack);
- } else {
- array_push($stack, $dir);
- }
- }
- }
- return $drive . DIRECTORY_SEPARATOR . implode(DIRECTORY_SEPARATOR, $stack);
- }
- }