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 11:23
37: */
38: namespace MOC\Module\Network\Ftp\File;
39: use MOC\Api;
40: use MOC\Generic\Device\Module;
41: use MOC\Module\Network\Ftp\Transport\Connection;
42:
43: /**
44: * File-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\File
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 = null;
94: /** @var null|array|string $Content */
95: protected $Content = null;
96: /** @var bool $Changed */
97: private $Changed = false;
98:
99: /** @var null|string $Name */
100: private $Name = null;
101: /** @var null|string $Extension */
102: private $Extension = null;
103: /** @var null|string $Path */
104: private $Path = null;
105: /** @var null|int $Size */
106: private $Size = null;
107: /** @var null|int $Time */
108: private $Time = null;
109:
110: /**
111: * File-Location
112: *
113: * @param null|string $Location
114: *
115: * @return null|string
116: */
117: public function Location( $Location = null ) {
118: if( $Location !== null ) {
119: $this->Location = $this->UpdateSyntax( $Location );
120: } return $this->Location;
121: }
122:
123: /**
124: * File-Name
125: *
126: * @param string|null $Name
127: *
128: * @return string|null
129: */
130: public function Name( $Name = null ) {
131: if( $Name !== null ) {
132: $this->Name = $Name;
133: } return $this->Name;
134: }
135:
136: /**
137: * File-Extension
138: *
139: * @param string|null $Extension
140: *
141: * @return string|null
142: */
143: public function Extension( $Extension = null ) {
144: if( $Extension !== null ) {
145: $this->Extension = $Extension;
146: } return $this->Extension;
147: }
148:
149: /**
150: * File-Path
151: *
152: * @param string|null $Path
153: *
154: * @return string|null
155: */
156: public function Path( $Path = null ) {
157: if( $Path !== null ) {
158: $this->Path = $this->UpdateSyntax( $Path );
159: } return $this->Path;
160: }
161:
162: /**
163: * File-Size
164: *
165: * @param int|null $Size
166: *
167: * @return int|null
168: */
169: public function Size( $Size = null ) {
170: if( $Size !== null ) {
171: $this->Size = $Size;
172: } return $this->Size;
173: }
174:
175: /**
176: * File-Timestamp
177: *
178: * @param int|null $Time
179: *
180: * @return int|null
181: */
182: public function Time( $Time = null ) {
183: if( $Time !== null ) {
184: $this->Time = $Time;
185: } return $this->Time;
186: }
187:
188: /**
189: * File-Changed
190: *
191: * @param null|bool $Toggle
192: *
193: * @return bool
194: */
195: public function Changed( $Toggle = null ) {
196: if( $Toggle !== null ) {
197: $this->Changed = $Toggle;
198: } return $this->Changed;
199: }
200:
201: /**
202: * Read File-Properties
203: */
204: protected function UpdateProperties() {
205: $this->Name( pathinfo( $this->Location(), PATHINFO_FILENAME ) );
206: $this->Extension( pathinfo( $this->Location(), PATHINFO_EXTENSION ) );
207: $this->Path( pathinfo( $this->Location(), PATHINFO_DIRNAME ) );
208: $this->Size( ftp_size( $this->Connection()->Handler(), $this->Location() ) );
209: $this->Time( ftp_mdtm( $this->Connection()->Handler(), $this->Location() ) );
210: }
211:
212: /**
213: * Correct Path-Syntax
214: *
215: * @param string $Path
216: *
217: * @return string
218: */
219: protected function UpdateSyntax( $Path ) {
220: return '/'.trim( preg_replace( '![\\\/]+!', '/', $Path ), '\\/' );
221: }
222:
223: }
224: