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:  * phpFtp
 36:  * 15.10.2012 15:36
 37:  */
 38: namespace MOC\Module\Network;
 39: use MOC\Api;
 40: use MOC\Generic\Device\Module;
 41: 
 42: /**
 43:  * Class for FTP access
 44:  */
 45: class Ftp implements Module {
 46: 
 47:     /** @var Ftp $Singleton */
 48:     private static $Singleton = null;
 49: 
 50:     /**
 51:      * Get Singleton/Instance
 52:      *
 53:      * @static
 54:      * @return Ftp
 55:      */
 56:     public static function InterfaceInstance() {
 57:         if( self::$Singleton === null ) {
 58:             self::$Singleton = new Ftp();
 59:         } return self::$Singleton;
 60:     }
 61: 
 62:     /**
 63:      * Get Changelog
 64:      *
 65:      * @static
 66:      * @return \MOC\Core\Changelog
 67:      */
 68:     public static function InterfaceChangelog() {
 69:         return Api::Core()->Changelog()->Create( __CLASS__ );
 70:     }
 71: 
 72:     /**
 73:      * Get Dependencies
 74:      *
 75:      * @static
 76:      * @return \MOC\Core\Depending
 77:      */
 78:     public static function InterfaceDepending() {
 79:         return Api::Core()->Depending();
 80:     }
 81: 
 82:     private $Connection = null;
 83: 
 84:     /**
 85:      * Opens a FTP connection
 86:      * 
 87:      * @param string $ServerName
 88:      * @param int $Port
 89:      * @param int $TimeOut
 90:      *
 91:      * @return Ftp
 92:      */
 93:     public function Open( $ServerName, $Port = 21, $TimeOut = 15 ) {
 94:         $this->Connection()->Open( $ServerName, $Port, $TimeOut );
 95:         return $this;
 96:     }
 97: 
 98:     /**
 99:      * Login to the FTP server
100:      * 
101:      * @param string $UserName
102:      * @param string $Password
103:      *
104:      * @return Ftp
105:      */
106:     public function Login( $UserName, $Password ) {
107:         $this->Connection()->Login( $UserName, $Password );
108:         return $this;
109:     }
110: 
111:     /**
112:      * Gets FTP connection
113:      * 
114:      * @return Ftp\Transport\Connection
115:      */
116:     private function Connection() {
117:         if( $this->Connection === null ) {
118:             $this->Connection = Ftp\Transport\Connection::InterfaceInstance();
119:         }
120:         return $this->Connection;
121:     }
122: 
123:     /**
124:      * Gets directory
125:      * 
126:      * @return Ftp\Transport\Connection|Ftp\Directory|null
127:      */
128:     public function Directory() {
129:         return Ftp\Directory::InterfaceInstance()->Connection( $this->Connection() );
130:     }
131: 
132:     /**
133:      * Gets file
134:      * 
135:      * @return Ftp\Transport\Connection|Ftp\File|null
136:      */
137:     public function File() {
138:         return Ftp\File::InterfaceInstance()->Connection( $this->Connection() );
139:     }
140: }
141: