Joomla! Programmierung/Framework/JFolder/copy

JFolder/copy Kopiert einen Ordner.

Syntax

static copy($src, $dest, [$path], [$force])

static copy($src, $dest, [$path], [$force], [$use_streams])

• @return mixed object JError bei einem Fehler oder boolean True bei Erfolg.
• @since

Parameter	Datentyp	Beschreibung	Standardwert
$src	string	Der Pfad zum Quellordner.
$dest	string	Der Pfad zum Zielordner.
[$path]	string	Pfad der vorangestellt wird.	' '
[$force]	string	Überschreiben erzwingen.	false
[$use_streams]	bool	Sollen Streams genutzt werden	false

Beispiel

JFolder::copy('quelle', 'ziel', JPATH_COMPONENT, true);

Kopiert den Ordner  quelle in den Ordner  ziel Im Verzeichnis Ihrer Komponente und überschreibt ihn falls er schon vorhanden ist.

Siehe auch

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

Quellcode

 libraries

•  joomla
  •  filesystem
    •  folder.php

public static function copy($src, $dest, $path = '', $force = false, $use_streams = false)
{
   @set_time_limit(ini_get('max_execution_time'));
 
   // Initialise variables.
   $FTPOptions = JClientHelper::getCredentials('ftp');
 
   if ($path)
   {
      $src = JPath::clean($path . '/' . $src);
      $dest = JPath::clean($path . '/' . $dest);
   }
 
   // Eliminate trailing directory separators, if any
   $src = rtrim($src, DIRECTORY_SEPARATOR);
   $dest = rtrim($dest, DIRECTORY_SEPARATOR);
 
   if (!self::exists($src))
   {
      return JError::raiseError(-1, JText::_('JLIB_FILESYSTEM_ERROR_FIND_SOURCE_FOLDER'));
   }
   if (self::exists($dest) && !$force)
   {
      return JError::raiseError(-1, JText::_('JLIB_FILESYSTEM_ERROR_FOLDER_EXISTS'));
   }
 
   // Make sure the destination exists
   if (!self::create($dest))
   {
      return JError::raiseError(-1, JText::_('JLIB_FILESYSTEM_ERROR_FOLDER_CREATE'));
   }
 
   // If we're using ftp and don't have streams enabled
   if ($FTPOptions['enabled'] == 1 && !$use_streams)
   {
      // Connect the FTP client
      jimport('joomla.client.ftp');
      $ftp = JFTP::getInstance($FTPOptions['host'], $FTPOptions['port'], null, $FTPOptions['user'], $FTPOptions['pass']);
 
      if (!($dh = @opendir($src)))
      {
         return JError::raiseError(-1, JText::_('JLIB_FILESYSTEM_ERROR_FOLDER_OPEN'));
      }
      // Walk through the directory copying files and recursing into folders.
      while (($file = readdir($dh)) !== false)
      {
         $sfid = $src . '/' . $file;
         $dfid = $dest . '/' . $file;
         switch (filetype($sfid))
         {
            case 'dir':
               if ($file != '.' && $file != '..')
               {
                  $ret = self::copy($sfid, $dfid, null, $force);
                  if ($ret !== true)
                  {
                     return $ret;
                  }
               }
               break;
 
            case 'file':
               // Translate path for the FTP account
               $dfid = JPath::clean(str_replace(JPATH_ROOT, $FTPOptions['root'], $dfid), '/');
               if (!$ftp->store($sfid, $dfid))
               {
                  return JError::raiseError(-1, JText::_('JLIB_FILESYSTEM_ERROR_COPY_FAILED'));
               }
               break;
         }
      }
   }
   else
   {
      if (!($dh = @opendir($src)))
      {
         return JError::raiseError(-1, JText::_('JLIB_FILESYSTEM_ERROR_FOLDER_OPEN'));
      }
      // Walk through the directory copying files and recursing into folders.
      while (($file = readdir($dh)) !== false)
      {
         $sfid = $src . '/' . $file;
         $dfid = $dest . '/' . $file;
         switch (filetype($sfid))
         {
            case 'dir':
               if ($file != '.' && $file != '..')
               {
                  $ret = self::copy($sfid, $dfid, null, $force, $use_streams);
                  if ($ret !== true)
                  {
                     return $ret;
                  }
               }
               break;
 
            case 'file':
               if ($use_streams)
               {
                  $stream = JFactory::getStream();
                  if (!$stream->copy($sfid, $dfid))
                  {
                     return JError::raiseError(-1, JText::_('JLIB_FILESYSTEM_ERROR_COPY_FAILED') . ': ' . $stream->getError());
                  }
               }
               else
               {
                  if (!@copy($sfid, $dfid))
                  {
                     return JError::raiseError(-1, JText::_('JLIB_FILESYSTEM_ERROR_COPY_FAILED'));
                  }
               }
               break;
         }
      }
   }
   return true;
}