JFile/copy

JFile/copy Kopiert eine Datei.

Ist der FTP LayerToDo link aktiv, so wird dieser genutzt.

Syntax

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

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

• @return boolean True bei Erfolg
• @since

Parameter	Datentyp	Beschreibung	Standardwert
$src	string	Der Pfad zur Quelldatei	---
$dest	string	Der Pfad zur Zieldatei	---
[$path]	string	Ein Pfad der beiden Pfaden vorangestellt wird	null
[$use_streams]	boolean	Sollen StreamsToDo link genutzt werden	false

Beispiel

Eine Datei kopieren

if( JFile::copy('pfad'.DS.'zur'.DS.'quelle.php', 'pfad'.DS.'zum'.DS.'ziel.php', JPATH_ROOT) )
{
   echo 'Die Datei wurde kopiert';
}

Bei einem Fehler während der Ausführung der Funktion wird eine JError::raiseWarning Fehlermeldung ausgegeben

Siehe auch

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

Quellcode

 libraries

•  joomla
  •  filesystem
    •  file.php

public static function copy($src, $dest, $path = null, $use_streams = false)
{
   // Prepend a base path if it exists
   if ($path)
   {
      $src = JPath::clean($path . '/' . $src);
      $dest = JPath::clean($path . '/' . $dest);
   }
 
   // Check src path
   if (!is_readable($src))
   {
      JError::raiseWarning(21, JText::sprintf('JLIB_FILESYSTEM_ERROR_JFILE_FIND_COPY', $src));
 
      return false;
   }
 
   if ($use_streams)
   {
      $stream = JFactory::getStream();
 
      if (!$stream->copy($src, $dest))
      {
         JError::raiseWarning(21, JText::sprintf('JLIB_FILESYSTEM_ERROR_JFILE_STREAMS', $src, $dest, $stream->getError()));
 
         return false;
      }
 
      return true;
   }
   else
   {
      // Initialise variables.
      $FTPOptions = JClientHelper::getCredentials('ftp');
 
      if ($FTPOptions['enabled'] == 1)
      {
         // Connect the FTP client
         jimport('joomla.client.ftp');
         $ftp = JFTP::getInstance($FTPOptions['host'], $FTPOptions['port'], null, $FTPOptions['user'], $FTPOptions['pass']);
 
         // If the parent folder doesn't exist we must create it
         if (!file_exists(dirname($dest)))
         {
            jimport('joomla.filesystem.folder');
            JFolder::create(dirname($dest));
         }
 
         // Translate the destination path for the FTP account
         $dest = JPath::clean(str_replace(JPATH_ROOT, $FTPOptions['root'], $dest), '/');
         if (!$ftp->store($src, $dest))
         {
 
            // FTP connector throws an error
            return false;
         }
         $ret = true;
      }
      else
      {
         if (!@ copy($src, $dest))
         {
            JError::raiseWarning(21, JText::_('JLIB_FILESYSTEM_ERROR_COPY_FAILED'));
 
            return false;
         }
         $ret = true;
      }
 
      return $ret;
   }
}