<?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();
	}
}