X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/53f4633144ed68c8b8fb5861f992b5489894a940..d3947bc013df7edd54b46deed8230d2eeafc5ecb:/wp-admin/includes/class-wp-filesystem-ftpext.php diff --git a/wp-admin/includes/class-wp-filesystem-ftpext.php b/wp-admin/includes/class-wp-filesystem-ftpext.php index 62ade491..e1202aed 100644 --- a/wp-admin/includes/class-wp-filesystem-ftpext.php +++ b/wp-admin/includes/class-wp-filesystem-ftpext.php @@ -18,6 +18,7 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base { public $link; /** + * @access public * * @param array $opt */ @@ -63,6 +64,7 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base { } /** + * @access public * * @return bool */ @@ -73,12 +75,22 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base { $this->link = @ftp_connect($this->options['hostname'], $this->options['port'], FS_CONNECT_TIMEOUT); if ( ! $this->link ) { - $this->errors->add('connect', sprintf(__('Failed to connect to FTP Server %1$s:%2$s'), $this->options['hostname'], $this->options['port'])); + $this->errors->add( 'connect', + /* translators: %s: hostname:port */ + sprintf( __( 'Failed to connect to FTP Server %s' ), + $this->options['hostname'] . ':' . $this->options['port'] + ) + ); return false; } - if ( ! @ftp_login($this->link,$this->options['username'], $this->options['password']) ) { - $this->errors->add('auth', sprintf(__('Username/Password incorrect for %s'), $this->options['username'])); + if ( ! @ftp_login( $this->link,$this->options['username'], $this->options['password'] ) ) { + $this->errors->add( 'auth', + /* translators: %s: username */ + sprintf( __( 'Username/Password incorrect for %s' ), + $this->options['username'] + ) + ); return false; } @@ -91,19 +103,30 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base { } /** - * @param string $file - * @return false|string + * Retrieves the file contents. + * + * @since 2.5.0 + * @access public + * + * @param string $file Filename. + * @return string|false File contents on success, false if no temp file could be opened, + * or if the file couldn't be retrieved. */ public function get_contents( $file ) { $tempfile = wp_tempnam($file); $temp = fopen($tempfile, 'w+'); - if ( ! $temp ) + if ( ! $temp ) { + unlink( $tempfile ); return false; - - if ( ! @ftp_fget($this->link, $temp, $file, FTP_BINARY ) ) + } + + if ( ! @ftp_fget( $this->link, $temp, $file, FTP_BINARY ) ) { + fclose( $temp ); + unlink( $tempfile ); return false; - + } + fseek( $temp, 0 ); // Skip back to the start of the file being written to $contents = ''; @@ -116,6 +139,8 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base { } /** + * @access public + * * @param string $file * @return array */ @@ -124,6 +149,8 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base { } /** + * @access public + * * @param string $file * @param string $contents * @param bool|int $mode @@ -161,6 +188,8 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base { } /** + * @access public + * * @return string */ public function cwd() { @@ -171,6 +200,8 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base { } /** + * @access public + * * @param string $dir * @return bool */ @@ -179,6 +210,8 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base { } /** + * @access public + * * @param string $file * @param int $mode * @param bool $recursive @@ -208,6 +241,8 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base { } /** + * @access public + * * @param string $file * @return string */ @@ -216,6 +251,8 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base { return $dir[$file]['owner']; } /** + * @access public + * * @param string $file * @return string */ @@ -223,7 +260,10 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base { $dir = $this->dirlist($file); return $dir[$file]['permsn']; } + /** + * @access public + * * @param string $file * @return string */ @@ -233,6 +273,7 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base { } /** + * @access public * * @param string $source * @param string $destination @@ -248,7 +289,10 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base { return false; return $this->put_contents($destination, $content, $mode); } + /** + * @access public + * * @param string $source * @param string $destination * @param bool $overwrite @@ -257,7 +301,10 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base { public function move($source, $destination, $overwrite = false) { return ftp_rename($this->link, $source, $destination); } + /** + * @access public + * * @param string $file * @param bool $recursive * @param string $type @@ -277,7 +324,10 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base { $this->delete( trailingslashit($file) . $delete_file['name'], $recursive, $delete_file['type'] ); return @ftp_rmdir($this->link, $file); } + /** + * @access public + * * @param string $file * @return bool */ @@ -290,14 +340,20 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base { return !empty($list); //empty list = no file, so invert. } + /** + * @access public + * * @param string $file * @return bool */ public function is_file($file) { return $this->exists($file) && !$this->is_dir($file); } + /** + * @access public + * * @param string $path * @return bool */ @@ -312,41 +368,58 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base { } /** + * @access public + * * @param string $file * @return bool */ public function is_readable($file) { return true; } + /** + * @access public + * * @param string $file * @return bool */ public function is_writable($file) { return true; } + /** + * @access public + * * @param string $file * @return bool */ public function atime($file) { return false; } + /** + * @access public + * * @param string $file * @return int */ public function mtime($file) { return ftp_mdtm($this->link, $file); } + /** + * @access public + * * @param string $file * @return int */ public function size($file) { return ftp_size($this->link, $file); } + /** + * @access public + * * @param string $file * @return bool */ @@ -355,6 +428,8 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base { } /** + * @access public + * * @param string $path * @param mixed $chmod * @param mixed $chown @@ -373,6 +448,8 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base { } /** + * @access public + * * @param string $path * @param bool $recursive * @return bool @@ -382,6 +459,8 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base { } /** + * @access public + * * @staticvar bool $is_windows * @param string $line * @return array @@ -454,13 +533,16 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base { } // Replace symlinks formatted as "source -> target" with just the source name - if ( $b['islink'] ) + if ( isset( $b['islink'] ) && $b['islink'] ) { $b['name'] = preg_replace( '/(\s*->\s*.*)$/', '', $b['name'] ); + } return $b; } /** + * @access public + * * @param string $path * @param bool $include_hidden * @param bool $recursive