1: <?php
  2: /**
  3:  * LICENSE (BSD)
  4:  *
  5:  * Copyright (c) 2012, Gerd Christian Kunze
  6:  * All rights reserved.
  7:  *
  8:  * Redistribution and use in source and binary forms, with or without
  9:  * modification, are permitted provided that the following conditions are
 10:  * met:
 11:  *
 12:  *  * Redistributions of source code must retain the above copyright
 13:  *    notice, this list of conditions and the following disclaimer.
 14:  *
 15:  *  * Redistributions in binary form must reproduce the above copyright
 16:  *    notice, this list of conditions and the following disclaimer in the
 17:  *    documentation and/or other materials provided with the distribution.
 18:  *
 19:  *  * Neither the name of Gerd Christian Kunze nor the names of the
 20:  *    contributors may be used to endorse or promote products derived from
 21:  *    this software without specific prior written permission.
 22:  *
 23:  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
 24:  * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
 25:  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 26:  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
 27:  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
 28:  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
 29:  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
 30:  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
 31:  * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
 32:  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
 33:  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 34:  *
 35:  * Property
 36:  * 16.10.2012 10:42
 37:  */
 38: namespace MOC\Module\Network\Ftp\Directory;
 39: use MOC\Api;
 40: use MOC\Generic\Device\Module;
 41: use MOC\Module\Network\Ftp\Transport\Connection;
 42: 
 43: /**
 44:  * Directory-Property
 45:  */
 46: class Property implements Module {
 47:     /**
 48:      * Get Changelog
 49:      *
 50:      * @static
 51:      * @return \MOC\Core\Changelog
 52:      */
 53:     public static function InterfaceChangelog() {
 54:         return Api::Core()->Changelog()->Create( __CLASS__ );
 55:     }
 56: 
 57:     /**
 58:      * Get Dependencies
 59:      *
 60:      * @static
 61:      * @return \MOC\Core\Depending
 62:      */
 63:     public static function InterfaceDepending() {
 64:         return Api::Core()->Depending();
 65:     }
 66: 
 67:     /**
 68:      * Get Singleton/Instance
 69:      *
 70:      * @static
 71:      * @return Property
 72:      */
 73:     public static function InterfaceInstance() {
 74:         return new Property();
 75:     }
 76: 
 77:     /** @var null|Connection $Connection */
 78:     private $Connection = null;
 79: 
 80:     /**
 81:      * @param null|Connection $Connection
 82:      *
 83:      * @return null|Connection|\MOC\Module\Network\Ftp\Directory
 84:      */
 85:     public function Connection( Connection $Connection = null ) {
 86:         if( $Connection !== null ) {
 87:             $this->Connection = $Connection;
 88:             return $this;
 89:         } return $this->Connection;
 90:     }
 91: 
 92:     /** @var null|string $Location */
 93:     private $Location = '/';
 94: 
 95:     /** @var null|string $Name */
 96:     private $Name = null;
 97:     /** @var null|string $Path */
 98:     private $Path = null;
 99: 
100:     /**
101:      * Directory-Location
102:      *
103:      * @param null|string $Location
104:      *
105:      * @return null|string
106:      */
107:     public function Location( $Location = null ) {
108:         if( $Location !== null ) {
109:             $this->Location = $this->UpdateSyntax( $Location );
110:         } return $this->Location;
111:     }
112: 
113:     /**
114:      * Directory-Name
115:      *
116:      * @param string|null $Name
117:      *
118:      * @return string|null
119:      */
120:     public function Name( $Name = null ) {
121:         if( $Name !== null ) {
122:             $this->Name = $Name;
123:         } return $this->Name;
124:     }
125: 
126:     /**
127:      * Directory-Path
128:      *
129:      * @param string|null $Path
130:      *
131:      * @return string|null
132:      */
133:     public function Path( $Path = null ) {
134:         if( $Path !== null ) {
135:             $this->Path = $this->UpdateSyntax( $Path );
136:         } return $this->Path;
137:     }
138: 
139:     /**
140:      * Read Directory-Properties
141:      */
142:     protected function UpdateProperties() {
143:         $this->Path( dirname( $this->Location() ) );
144:         $this->Name( basename( $this->Location() ) );
145:     }
146: 
147:     /**
148:      * Correct Path-Syntax
149:      *
150:      * @param string $Path
151:      *
152:      * @return string
153:      */
154:     protected function UpdateSyntax( $Path ) {
155:         return '/'.trim( preg_replace( '![\\\/]+!', '/', $Path ), '\\/' );
156:     }
157: }
158: