Version 4.0.13.1

system/Ftp/RecursiveDirectoryFtpIterator.php

@@ -0,0 +1,171 @@
+<?php
+/**
+ * @brief		FTP RecursiveDirectoryIterator 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;
+}
+
+/**
+ * Recursive directory FTP iterator
+ */
+class _RecursiveDirectoryFtpIterator extends \IPS\Ftp\FtpSplFileInfo implements \RecursiveIterator
+{
+	/**
+	 * @brief	Holds an array of iterable objects
+	 */
+	public $contents		= NULL;
+
+	/**
+	 * @brief	The FTP class holding our connection
+	 */
+	protected $ftpObject	= NULL;
+
+	/**
+	 * @brief	Flag to store whether the iterator has been rewound
+	 */
+	protected $rewound		= FALSE;
+
+	/**
+	 * Constructor: Create a new recursive FTP directory iterator
+	 *
+	 * @param	\IPS\Ftp	$ftp	The FTP object handle
+	 * @param	string		$file	The filename or directory
+	 * @param	int			$type	The type of item passed
+	 * @return	void
+	 * @throws \InvalidArgumentException
+	 */
+	public function __construct( $ftp, $file, $type = self::TYPE_DIRECTORY )
+	{
+		$this->ftpObject	= $ftp;
+
+		return parent::__construct( $file, $type );
+	}
+
+	/**
+	 * Return children of the current object
+	 *
+	 * @return \RecursiveDirectoryFtpIterator
+	 */
+	public function getChildren()
+	{
+		return new \IPS\Ftp\RecursiveDirectoryFtpIterator( $this->ftpObject, $this->current()->getPath() );
+	}
+
+	/**
+	 * Do we have any children?
+	 *
+	 * @return bool
+	 */
+	public function hasChildren()
+	{
+		return $this->current()->isDir();
+	}
+
+	/**
+	 * Return the current item
+	 *
+	 * @return mixed
+	 */
+	public function current()
+	{
+		return current( $this->contents );
+	}
+
+	/**
+	 * Return the current key
+	 *
+	 * @return string
+	 */
+	public function key()
+	{
+		return $this->current()->getPathname();
+	}
+
+	/**
+	 * Advance to the next item
+	 *
+	 * @return mixed
+	 */
+	public function next()
+	{
+		next( $this->contents );
+	}
+
+	/**
+	 * Rewind and fetch all items
+	 *
+	 * @return void
+	 */
+	public function rewind()
+	{
+		/* Change to the appropriate directory */
+		$this->ftpObject->chdir( $this->getPath() );
+
+		/* Fetch our names and the raw listing */
+		$names	= $this->ftpObject->ls( $this->getFilename() );
+		$types	= $this->ftpObject->rawList( $this->getFilename() );
+
+		/* Reset our contents array */
+		$this->contents	= array();
+
+		/* Now loop over the results we got */
+		foreach( $names as $k => $name )
+		{
+			if( $name == '.' OR $name == '..' )
+			{
+				continue;
+			}
+
+			$this->contents[]	= new \IPS\Ftp\RecursiveDirectoryFtpIterator( $this->ftpObject, $this->getItemname( $name ), self::getTypeFromRaw( $types[ $k ] ) );
+		}
+	}
+
+	/**
+	 * Is this a valid item?
+	 *
+	 * @return bool
+	 */
+	public function valid()
+	{
+		if( !$this->rewound )
+		{
+			$this->rewind();
+			$this->rewound	= TRUE;
+		}
+
+		return ( $this->current() instanceof \IPS\Ftp\FtpSplFileInfo );
+	}
+
+	/**
+	 * Return sub-path
+	 *
+	 * @return string
+	 */
+	public function getSubPath()
+	{
+		return $this->getPath();
+	}
+
+	/**
+	 * Return sub-path + filename
+	 *
+	 * @return string
+	 */
+	public function getSubPathname()
+	{
+		return $this->getPathname();
+	}
+}