interface/modules/zend_modules/library/Zend/Uri/File.php

   1 <?php
   2 /**
   3  * Zend Framework (http://framework.zend.com/)
   4  *
   5  * @link      http://github.com/zendframework/zf2 for the canonical source repository
   6  * @copyright Copyright (c) 2005-2013 Zend Technologies USA Inc. (http://www.zend.com)
   7  * @license   http://framework.zend.com/license/new-bsd New BSD License
   8  */
   9
  10 namespace Zend\Uri;
  11
  12 /**
  13  * File URI handler
  14  *
  15  * The 'file:...' scheme is loosely defined in RFC-1738
  16  */
  17 class File extends Uri
  18 {
  19     protected static $validSchemes = array('file');
  20
  21     /**
  22      * Check if the URI is a valid File URI
  23      *
  24      * This applies additional specific validation rules beyond the ones
  25      * required by the generic URI syntax.
  26      *
  27      * @return bool
  28      * @see    Uri::isValid()
  29      */
  30     public function isValid()
  31     {
  32         if ($this->query) {
  33             return false;
  34         }
  35
  36         return parent::isValid();
  37     }
  38
  39     /**
  40      * User Info part is not used in file URIs
  41      *
  42      * @see    Uri::setUserInfo()
  43      * @param  string $userInfo
  44      * @return File
  45      */
  46     public function setUserInfo($userInfo)
  47     {
  48         return $this;
  49     }
  50
  51     /**
  52      * Fragment part is not used in file URIs
  53      *
  54      * @see    Uri::setFragment()
  55      * @param  string $fragment
  56      * @return File
  57      */
  58     public function setFragment($fragment)
  59     {
  60         return $this;
  61     }
  62
  63     /**
  64      * Convert a UNIX file path to a valid file:// URL
  65      *
  66      * @param  string $path
  67      * @return File
  68      */
  69     public static function fromUnixPath($path)
  70     {
  71         $url = new static('file:');
  72         if (substr($path, 0, 1) == '/') {
  73             $url->setHost('');
  74         }
  75
  76         $url->setPath($path);
  77         return $url;
  78     }
  79
  80     /**
  81      * Convert a Windows file path to a valid file:// URL
  82      *
  83      * @param  string $path
  84      * @return File
  85      */
  86     public static function fromWindowsPath($path)
  87     {
  88         $url = new static('file:');
  89
  90         // Convert directory separators
  91         $path = str_replace(array('/', '\\'), array('%2F', '/'), $path);
  92
  93         // Is this an absolute path?
  94         if (preg_match('|^([a-zA-Z]:)?/|', $path)) {
  95             $url->setHost('');
  96         }
  97
  98         $url->setPath($path);
  99         return $url;
 100     }
 101 }