Overview

Namespaces

  • MOC
    • Adapter
    • Core
      • Changelog
      • Depending
      • Drive
        • Directory
        • File
      • Error
        • Register
        • Type
      • Journal
      • Proxy
      • Template
      • Xml
    • Extension
      • Excel
      • Flot
      • Mail
      • Pdf
      • Word
      • Xml
      • YUICompressor
      • Zip
    • Generic
      • Common
      • Device
        • Extension
        • Widget
    • Module
      • Database
        • Driver
      • Drive
      • Image
        • Font
      • Installer
      • Network
        • Ftp
          • Directory
          • File
          • Transport
        • Http
        • ParcelTracker
          • Carrier
      • Office
        • Chart
          • Axis
        • Document
          • Excel
            • Cell
              • Format
              • Style
                • Border
                  • Bottom
                  • Left
                  • Right
                  • Top
                • Font
            • Close
            • Page
            • Worksheet
          • Pdf
            • Close
            • Font
            • Page
              • Margin
              • Position
            • Text
          • Xml
            • Close
        • Image
        • Mail
          • Address
          • Content
      • Packer
        • Yui
        • Zip
      • Template
    • Plugin
      • Gateway
      • Repository
      • Shared
  • PHP

Classes

  • Property
  • Read
  • Write
  • Overview
  • Namespace
  • Class
  • Tree
  • Deprecated
  • Todo
  • Download
  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: 
API documentation generated by ApiGen 2.8.0