Joomla! Programmierung/Framework/JFolder/move

JFolder/move verschiebt Ordner.

Syntax

static move ($src, $dest, [$path])

static move( $src, $dest, [$path], [$use_streams] )

• @return mixed boolean True bei Erfolg oder string Fehlermeldung
• @since

Parameter	Datentyp	Beschreibung	Standardwert
$src	string	Der Pfad zum Quellordner.
$dest	string	Der Pfad zum Zielordner.
[$path]	string	Pfad der vorangestellt wird.	''
[$use_streams]	boolean	ToDo Beschreibung	false

Beispiel

$retVal = JFolder::move('quelle', 'ziel', JPATH_COMPONENT);
if( $retVal !== true )
{
   JError::raiseWarning(100, $retVal);
}

Verschiebt den Ordner  quelle nach  ziel.
Schlägt dies fehl, wird über JError::raiseWarning die im Rückgabewert enthaltene Fehlermeldung ausgegeben.
Beiden Pfaden wird die Konstante JPATH_COMPONENT vorangestellt.

Siehe auch

• JFolder->move() auf api.joomla.org

Quellcode

JFolder::move()

 libraries/joomla

•  filesystem
  •  folder.php

public static function move($src, $dest, $path = '', $use_streams=false)
{
   // Initialise variables.
   jimport('joomla.client.helper');
   $FTPOptions = JClientHelper::getCredentials('ftp');
 
   if ($path)
   {
      $src = JPath::clean($path . '/' . $src);
      $dest = JPath::clean($path . '/' . $dest);
   }
 
   if (!self::exists($src)){
      return JText::_('JLIB_FILESYSTEM_ERROR_FIND_SOURCE_FOLDER');
   }
   if (self::exists($dest)) {
      return JText::_('JLIB_FILESYSTEM_ERROR_FOLDER_EXISTS');
   }
   if($use_streams)
   {
      $stream = JFactory::getStream();
      if(!$stream->move($src, $dest)) {
         return JText::sprintf('JLIB_FILESYSTEM_ERROR_FOLDER_RENAME', $stream->getError());
      }
      $ret = true;
   }
   else
   {
      if ($FTPOptions['enabled'] == 1)
      {
         // Connect the FTP client
         jimport('joomla.client.ftp');
         $ftp = JFTP::getInstance(
            $FTPOptions['host'], $FTPOptions['port'], null,
            $FTPOptions['user'], $FTPOptions['pass']
         );
 
         //Translate path for the FTP account
         $src = JPath::clean(str_replace(JPATH_ROOT, $FTPOptions['root'], $src), '/');
         $dest = JPath::clean(str_replace(JPATH_ROOT, $FTPOptions['root'], $dest), '/');
 
         // Use FTP rename to simulate move
         if (!$ftp->rename($src, $dest)) {
            return JText::_('Rename failed');
         }
         $ret = true;
      }
      else
      {
         if (!@rename($src, $dest)) {
            return JText::_('Rename failed');
         }
         $ret = true;
      }
   }
   return $ret;
}