Source for file Ftp.php

Documentation is available at Ftp.php

1: <?php
2:
3: /**
4: * Nette Framework
5: *
6: * Copyright (c) 2004, 2009 David Grudl (http://davidgrudl.com)
7: *
8: * This source file is subject to the "Nette license" that is bundled
9: * with this package in the file license.txt.
10: *
11: * For more information please see https://nette.org
12: *
13: * @copyright Copyright (c) 2004, 2009 David Grudl
14: * @license https://nette.org/license Nette license
15: * @link https://nette.org
16: * @category Nette
17: * @package Nette\Web
18: * @version $Id$
19: */
20:
21:
22:
23: require_once dirname(__FILE__) . '/../Object.php';
24:
25:
26:
27: /**
28: * Access to a FTP server.
29: *
30: * <code>
31: * $ftp = new Ftp;
32: * $ftp->connect('ftp.example.com');
33: * $ftp->login('anonymous', 'example@example.com');
34: * $ftp->get('file.txt', 'README', Ftp::ASCII);
35: * </code>
36: *
37: * @author David Grudl
38: * @copyright Copyright (c) 2004, 2009 David Grudl
39: * @package Nette\Web
40: */
41: class Ftp extends Object
42: {
43: /**#@+ FTP constant alias */
44: const ASCII = FTP_ASCII;
45: const TEXT = FTP_TEXT;
46: const BINARY = FTP_BINARY;
47: const IMAGE = FTP_IMAGE;
48: const TIMEOUT_SEC = FTP_TIMEOUT_SEC;
49: const AUTOSEEK = FTP_AUTOSEEK;
50: const AUTORESUME = FTP_AUTORESUME;
51: const FAILED = FTP_FAILED;
52: const FINISHED = FTP_FINISHED;
53: const MOREDATA = FTP_MOREDATA;
54: /**#@-*/
55:
56: /** @var resource */
57: private $resource;
58:
59: /** @var array */
60: private $state;
61:
62:
63:
64: /**
65: * Magic method (do not call directly).
66: * @param string method name
67: * @param array arguments
68: * @return mixed
69: * @throws MemberAccessException
70: * @throws FtpException
71: */
72: public function __call($name, $args)
73: {
74: $name = strtolower($name);
75: $silent = strncmp($name, 'try', 3) === 0;
76: $func = $silent ? substr($name, 3) : $name;
77: static $aliases = array(
78: 'sslconnect' => 'ssl_connect',
79: 'getoption' => 'get_option',
80: 'setoption' => 'set_option',
81: 'nbcontinue' => 'nb_continue',
82: 'nbfget' => 'nb_fget',
83: 'nbfput' => 'nb_fput',
84: 'nbget' => 'nb_get',
85: 'nbput' => 'nb_put',
86: );
87: $func = 'ftp_' . (isset($aliases[$func]) ? $aliases[$func] : $func);
88:
89: if (!function_exists($func)) {
90: return parent::__call($name, $args);
91: }
92:
93:
94: Tools::tryError();
95:
96: if ($func === 'ftp_connect' || $func === 'ftp_ssl_connect') {
97: $this->state = array($name => $args);
98: $this->resource = call_user_func_array($func, $args);
99: $res = NULL;
100:
101: } elseif (!is_resource($this->resource)) {
102: Tools::catchError($msg);
103: throw new FtpException("Not connected to FTP server. Call connect() or ssl_connect() first.");
104:
105: } else {
106: if ($func === 'ftp_login' || $func === 'ftp_pasv') {
107: $this->state[$name] = $args;
108: }
109:
110: array_unshift($args, $this->resource);
111: $res = call_user_func_array($func, $args);
112:
113: if ($func === 'ftp_chdir' || $func === 'ftp_cdup') {
114: $this->state['chdir'] = array(ftp_pwd($this->resource));
115: }
116: }
117:
118: if (Tools::catchError($msg) && !$silent) {
119: throw new FtpException($msg);
120: }
121:
122: return $res;
123: }
124:
125:
126:
127: /**
128: * Reconnects to FTP server.
129: * @return void
130: */
131: public function reconnect()
132: {
133: @ftp_close($this->resource); // intentionally @
134: foreach ($this->state as $name => $args) {
135: call_user_func_array(array($this, $name), $args);
136: }
137: }
138:
139:
140:
141: /**
142: * Checks if file or directory exists.
143: * @param string
144: * @return bool
145: */
146: public function fileExists($file)
147: {
148: return is_array($this->nlist($file));
149: }
150:
151:
152:
153: /**
154: * Checks if directory exists.
155: * @param string
156: * @return bool
157: */
158: public function isDir($dir)
159: {
160: $current = $this->pwd();
161: try {
162: $this->chdir($dir);
163: } catch (FtpException $e) {
164: }
165: $this->chdir($current);
166: return empty($e);
167: }
168:
169:
170:
171: /**
172: * Recursive creates directories.
173: * @param string
174: * @return void
175: */
176: public function mkDirRecursive($dir)
177: {
178: $parts = explode('/', $dir);
179: $path = '';
180: while (!empty($parts)) {
181: $path .= array_shift($parts);
182: try {
183: if ($path !== '') $this->mkdir($path);
184: } catch (FtpException $e) {
185: if (!$this->isDir($path)) {
186: throw new FtpException("Cannot create directory '$path'.");
187: }
188: }
189: $path .= '/';
190: }
191: }
192:
193: }
194:
195:
196:
197: /**
198: * FTP server exception.
199: *
200: * @package Nette\Web
201: */
202: class FtpException extends Exception
203: {
204: }

Source for file Ftp.php

Namespaces