Version 4.0.13.1

system/Ftp/FtpSplFileInfo.php

@@ -0,0 +1,216 @@
+<?php
+/**
+ * @brief		FTP SplFileInfo Class
+ * @author		<a href='http://www.invisionpower.com'>Invision Power Services, Inc.</a>
+ * @copyright	(c) 2001 - SVN_YYYY Invision Power Services, Inc.
+ * @license		http://www.invisionpower.com/legal/standards/
+ * @package		IPS Social Suite
+ * @since		30 Oct 2013
+ * @version		SVN_VERSION_NUMBER
+ */
+
+namespace IPS\Ftp;
+
+/* To prevent PHP errors (extending class does not exist) revealing path */
+if ( !defined( '\IPS\SUITE_UNIQUE_KEY' ) )
+{
+	header( ( isset( $_SERVER['SERVER_PROTOCOL'] ) ? $_SERVER['SERVER_PROTOCOL'] : 'HTTP/1.0' ) . ' 403 Forbidden' );
+	exit;
+}
+
+/**
+ * FTP file information iterator
+ */
+class _FtpSplFileInfo extends \SplFileInfo
+{
+	/**
+	 * @brief   Define our possible types
+	 */
+	const TYPE_UNKNOWN		= 1;
+	const TYPE_DIRECTORY	= 2;
+	const TYPE_FILE			= 3;
+	const TYPE_LINK			= 4;
+
+	/**
+	 * @brief   Some information about our current object
+	 */
+	protected $type			= self::TYPE_DIRECTORY;
+	protected $directory	= '/';
+	protected $filename		= '.';
+
+	/**
+	 * Constructor: Create a new spl file info object
+	 *
+	 * @param   string  $file   Filename or directory name
+	 * @param   string  $type   The type of item passed
+	 * @return  void
+	 */
+	public function __construct( $file, $type = self::TYPE_DIRECTORY )
+	{
+		$this->type = $type;
+
+		if( $type === self::TYPE_DIRECTORY )
+		{
+			$this->filename		= '.';
+			$this->directory	= $file;
+		}
+		else if( $type === self::TYPE_FILE )
+		{
+			$tmp = self::parseFile( $file );
+
+			$this->filename		= $tmp['filename'];
+			$this->directory	= $tmp['directory'];
+		}
+
+		return parent::__construct( $this->getPathname() );
+	}
+
+	/**
+	 * Is this a directory?
+	 *
+	 * @return bool
+	 */
+	public function isDir()
+	{
+		return ( $this->type === self::TYPE_DIRECTORY );
+	}
+
+	/**
+	 * Is this a file?
+	 *
+	 * @return bool
+	 */
+	public function isFile()
+	{
+		return ( $this->type === self::TYPE_FILE );
+	}
+
+	/**
+	 * Return the type
+	 *
+	 * @return int
+	 */
+	public function getType()
+	{
+		return $this->type;
+	}
+
+	/**
+	 * Return the directory
+	 *
+	 * @return string
+	 */
+	public function getPath()
+	{
+		return $this->directory;
+	}
+
+	/**
+	 * Return the filename
+	 *
+	 * @return string
+	 */
+	public function getFilename()
+	{
+		return $this->filename;
+	}
+
+	/**
+	 * Return the full filename with the path
+	 *
+	 * @return string
+	 */
+	public function getPathname()
+	{
+		if( $this->isDir() )
+		{
+			return $this->getPath();
+		}
+		else
+		{
+			return $this->getItemname( $this->filename );
+		}
+	}
+
+	/**
+	 * Get the current item name
+	 * 
+	 * @param	string	$file	The filename or directory name
+	 * @return	string
+	 */
+	public function getItemname( $file )
+	{
+		if( $this->directory === '/' AND $file === '.' )
+		{
+			return $this->directory;
+		}
+
+		return ( ( $this->directory === '/' ) ? ( $this->directory . $file ) : ( $this->directory . '/' . $file ) );
+	}
+
+	/**
+	 * Parse a raw list item to extract the type
+	 *
+	 * @param	mixed	$item	The item we are parsing, which could be a file or directory (or unknown)
+	 * @return	int
+	 */
+	public static function getTypeFromRaw( $item )
+	{
+		if( $item === '' )
+		{
+			return self::TYPE_UNKNOWN;
+		}
+
+		switch( $item[0] )
+		{
+			case 'd':
+				return self::TYPE_DIRECTORY;
+
+			case '-':
+				return self::TYPE_FILE;
+
+			case 'l':
+				return self::TYPE_LINK;
+
+			default:
+				return self::TYPE_UNKNOWN;
+		}
+	}
+
+	/**
+	 * Parse a raw list item to extract the needed information
+	 *
+	 * @param	string	$item	The item we are parsing, which could be a file or directory (or unknown)
+	 * @return	array	( 'filename' => ..., 'directory' => ... )
+	 * @throws	\InvalidArgumentException
+	 */
+	public static function parseFile( $file = '/' )
+	{
+		if( mb_strpos( $file, '/' ) !== 0 )
+		{
+			throw new \InvalidArgumentException( sprintf( 'File "%s" does not start with a /', $file ) );
+		}
+
+		if( mb_strlen( $file ) < 2 )
+		{
+			throw new \InvalidArgumentException( sprintf( 'File "%s" must contain at least two characters', $file ) );
+		}
+
+		$pathBreak	= mb_strrpos( $file, '/' );
+
+		return array(
+			'filename'	=> mb_substr( $file, $pathBreak + 1 ),
+			'directory'	=> ( mb_substr( $file, 0, $pathBreak ) === '' ) ? '/' : mb_substr( $file, 0, $pathBreak )
+		);
+	}
+
+	/**
+	 * If we cast to a string, return the full filename
+	 *
+	 * @return string
+	 */
+	public function __toString()
+	{
+		return $this->getPathname();
+	}
+}