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:  * File
 36:  * 15.10.2012 15:38
 37:  */
 38: namespace MOC\Module\Network\Ftp;
 39: use MOC\Api;
 40: use MOC\Generic\Device\Module;
 41: 
 42: /**
 43:  *
 44:  */
 45: class File extends File\Read implements Module {
 46:     /**
 47:      * Get Singleton/Instance
 48:      *
 49:      * @static
 50:      * @return File
 51:      */
 52:     public static function InterfaceInstance() {
 53:         return new File();
 54:     }
 55: 
 56:     /**
 57:      * Get Dependencies
 58:      *
 59:      * @static
 60:      * @return \MOC\Core\Depending
 61:      */
 62:     public static function InterfaceDepending() {
 63:         return Api::Core()->Depending();
 64:     }
 65: 
 66:     /**
 67:      * Get Changelog
 68:      *
 69:      * @static
 70:      * @return \MOC\Core\Changelog
 71:      */
 72:     public static function InterfaceChangelog() {
 73:         return Api::Core()->Changelog();
 74:     }
 75: 
 76:     /**
 77:      * File-to-Handle
 78:      *
 79:      * @param string $Location
 80:      *
 81:      * @return File
 82:      */
 83:     public function Handle( $Location ) {
 84:         $this->Location( $Location );
 85:         $this->UpdateProperties();
 86:         return $this;
 87:     }
 88: 
 89:     /**
 90:      * File-Exists
 91:      *
 92:      * @return bool
 93:      */
 94:     public function Exists() {
 95:         if( ftp_size( $this->Connection()->Handler(), $this->Location() ) > -1 ) {
 96:             return true;
 97:         } else {
 98:             return false;
 99:         }
100:     }
101: 
102:     /**
103:      * File-Content
104:      *
105:      * @param array|null|string $Content
106:      *
107:      * @return array|null|string|File
108:      */
109:     public function Content( $Content = null ) {
110:         if( $Content !== null ) {
111:             if( $this->Content !== null ) { $this->Changed( true ); }
112:             $this->Content = $Content;
113:             $this->Changed( true );
114:             return $this;
115:         } elseif( $this->Content === null ) {
116:             $this->ReadAsString();
117:             $this->Changed( false );
118:             return $this->Content;
119:         } else {
120:             return $this->Content;
121:         }
122:     }
123: 
124:     /**
125:      * File-Hash
126:      *
127:      * @return null|string
128:      */
129:     public function Hash() {
130:         return ( file_exists( $this->Location() ) ? sha1_file( $this->Location() ) : sha1( $this->Location() ) );
131:     }
132: 
133:     /**
134:      * @return File
135:      */
136:     public function SetFileNameEncoding() {
137:         $FileName = self::MixedToUtf8( $this->Name() );
138: 
139:         $FileName = str_replace(
140:             array('ä', 'ö', 'ü', 'ß', 'ó', 'è', 'é'),
141:             array('ae', 'oe', 'ue', 'ss', 'o', 'e', 'e'),
142:             $FileName );
143: 
144:         $FileName = preg_replace( '/\s/s', '-', $FileName );
145: 
146:         $FileName = preg_replace('/[^a-z0-9_-]/isU', '', $FileName);
147: 
148:         $FileName = trim($FileName);
149: 
150:         $this->Name( $FileName );
151: 
152:         $this->Location( dirname( $this->Location() ).DIRECTORY_SEPARATOR.$FileName.(strlen($this->Extension())?'.'.$this->Extension():'') );
153: 
154:         return $this;
155:     }
156: 
157:     private static $DictionaryLatin1ToUtf8 = null;
158:     private static $DictionaryUtf8ToLatin1 = null;
159: 
160:     private static function BuildDictionary() {
161:         if( self::$DictionaryUtf8ToLatin1 === null || self::$DictionaryLatin1ToUtf8 === null ) {
162:             for ($Run = 32; $Run <= 255; $Run++) {
163:                 self::$DictionaryLatin1ToUtf8[chr($Run)] = utf8_encode(chr($Run));
164:                 self::$DictionaryUtf8ToLatin1[utf8_encode(chr($Run))] = chr($Run);
165:             }
166:         }
167:     }
168: 
169:     /**
170:      * @param $Text
171:      *
172:      * @return mixed
173:      */
174:     public static function MixedToLatin1( $Text ) {
175:         self::BuildDictionary();
176:         foreach ( self::$DictionaryUtf8ToLatin1 as $Key => $Val) {
177:             $Text = str_replace( $Key, $Val, $Text );
178:         }
179:         return $Text;
180:     }
181: 
182:     /**
183:      * @param $Text
184:      *
185:      * @return string
186:      */
187:     public static function MixedToUtf8( $Text ) {
188:         self::BuildDictionary();
189:         return utf8_encode( self::MixedToLatin1( $Text ) );
190:     }
191: }
192: