class FTPExtension

Defines a file transfer class using the PHP FTP extension.

Hierarchy

Expanded class hierarchy of FTPExtension

File

drupal/core/lib/Drupal/Core/FileTransfer/FTPExtension.php, line 13
Definition of Drupal\Core\FileTransfer\FTPExtension.

Namespace

Drupal\Core\FileTransfer
View source
class FTPExtension extends FTP implements ChmodInterface {

  /**
   * Implements Drupal\Core\FileTransfer\FileTransfer::connect().
   */
  public function connect() {
    $this->connection = ftp_connect($this->hostname, $this->port);
    if (!$this->connection) {
      throw new FileTransferException("Cannot connect to FTP Server, check settings");
    }
    if (!ftp_login($this->connection, $this->username, $this->password)) {
      throw new FileTransferException("Cannot log in to FTP server. Check username and password");
    }
  }

  /**
   * Implements Drupal\Core\FileTransfer\FileTransfer::copyFileJailed().
   */
  protected function copyFileJailed($source, $destination) {
    if (!@ftp_put($this->connection, $destination, $source, FTP_BINARY)) {
      throw new FileTransferException("Cannot move @source to @destination", NULL, array(
        "@source" => $source,
        "@destination" => $destination,
      ));
    }
  }

  /**
   * Implements Drupal\Core\FileTransfer\FileTransfer::createDirectoryJailed().
   */
  protected function createDirectoryJailed($directory) {
    if (!ftp_mkdir($this->connection, $directory)) {
      throw new FileTransferException("Cannot create directory @directory", NULL, array(
        "@directory" => $directory,
      ));
    }
  }

  /**
   * Implements Drupal\Core\FileTransfer\FileTransfer::removeDirectoryJailed().
   */
  protected function removeDirectoryJailed($directory) {
    $pwd = ftp_pwd($this->connection);
    if (!ftp_chdir($this->connection, $directory)) {
      throw new FileTransferException("Unable to change to directory @directory", NULL, array(
        '@directory' => $directory,
      ));
    }
    $list = @ftp_nlist($this->connection, '.');
    if (!$list) {
      $list = array();
    }
    foreach ($list as $item) {
      if ($item == '.' || $item == '..') {
        continue;
      }
      if (@ftp_chdir($this->connection, $item)) {
        ftp_cdup($this->connection);
        $this
          ->removeDirectory(ftp_pwd($this->connection) . '/' . $item);
      }
      else {
        $this
          ->removeFile(ftp_pwd($this->connection) . '/' . $item);
      }
    }
    ftp_chdir($this->connection, $pwd);
    if (!ftp_rmdir($this->connection, $directory)) {
      throw new FileTransferException("Unable to remove to directory @directory", NULL, array(
        '@directory' => $directory,
      ));
    }
  }

  /**
   * Implements Drupal\Core\FileTransfer\FileTransfer::removeFileJailed().
   */
  protected function removeFileJailed($destination) {
    if (!ftp_delete($this->connection, $destination)) {
      throw new FileTransferException("Unable to remove to file @file", NULL, array(
        '@file' => $destination,
      ));
    }
  }

  /**
   * Implements Drupal\Core\FileTransfer\FileTransfer::isDirectory().
   */
  public function isDirectory($path) {
    $result = FALSE;
    $curr = ftp_pwd($this->connection);
    if (@ftp_chdir($this->connection, $path)) {
      $result = TRUE;
    }
    ftp_chdir($this->connection, $curr);
    return $result;
  }

  /**
   * Implements Drupal\Core\FileTransfer\FileTransfer::isFile().
   */
  public function isFile($path) {
    return ftp_size($this->connection, $path) != -1;
  }

  /**
   * Implements Drupal\Core\FileTransfer\ChmodInterface::chmodJailed().
   */
  function chmodJailed($path, $mode, $recursive) {
    if (!ftp_chmod($this->connection, $mode, $path)) {
      throw new FileTransferException("Unable to set permissions on %file", NULL, array(
        '%file' => $path,
      ));
    }
    if ($this
      ->isDirectory($path) && $recursive) {
      $filelist = @ftp_nlist($this->connection, $path);
      if (!$filelist) {

        //empty directory - returns false
        return;
      }
      foreach ($filelist as $file) {
        $this
          ->chmodJailed($file, $mode, $recursive);
      }
    }
  }

}

Members

Namesort descending Modifiers Type Description Overrides
FileTransfer::$hostname protected property The hostname for this file transfer.
FileTransfer::$password protected property The password for this file transfer. 1
FileTransfer::$port protected property The port for this file transfer. 1
FileTransfer::$username protected property The username for this file transfer. 1
FileTransfer::checkPath final protected function Checks that the path is inside the jail and throws an exception if not.
FileTransfer::chmod final public function Changes the permissions of the specified $path (file or directory).
FileTransfer::copyDirectory final public function Copies a directory.
FileTransfer::copyDirectoryJailed protected function Copies a directory. 1
FileTransfer::copyFile final public function Copies a file.
FileTransfer::createDirectory final public function Creates a directory.
FileTransfer::findChroot function Returns the chroot property for this connection.
FileTransfer::fixRemotePath final protected function Returns a modified path suitable for passing to the server.
FileTransfer::removeDirectory final public function Removes a directory.
FileTransfer::removeFile final public function Removes a file.
FileTransfer::sanitizePath function Changes backslashes to slashes, also removes a trailing slash.
FileTransfer::setChroot function Sets the chroot and changes the jail to match the correct path scheme.
FileTransfer::__get function Implements the magic __get() method.
FTP::factory static function Overrides Drupal\Core\FileTransfer\FileTransfer::factory(). Overrides FileTransfer::factory
FTP::getSettingsForm public function Overrides Drupal\Core\FileTransfer\FileTransfer::getSettingsForm(). Overrides FileTransfer::getSettingsForm
FTP::__construct public function Overrides Drupal\Core\FileTransfer\FileTransfer::__construct(). Overrides FileTransfer::__construct
FTPExtension::chmodJailed function Implements Drupal\Core\FileTransfer\ChmodInterface::chmodJailed(). Overrides ChmodInterface::chmodJailed
FTPExtension::connect public function Implements Drupal\Core\FileTransfer\FileTransfer::connect(). Overrides FileTransfer::connect
FTPExtension::copyFileJailed protected function Implements Drupal\Core\FileTransfer\FileTransfer::copyFileJailed(). Overrides FileTransfer::copyFileJailed
FTPExtension::createDirectoryJailed protected function Implements Drupal\Core\FileTransfer\FileTransfer::createDirectoryJailed(). Overrides FileTransfer::createDirectoryJailed
FTPExtension::isDirectory public function Implements Drupal\Core\FileTransfer\FileTransfer::isDirectory(). Overrides FileTransfer::isDirectory
FTPExtension::isFile public function Implements Drupal\Core\FileTransfer\FileTransfer::isFile(). Overrides FileTransfer::isFile
FTPExtension::removeDirectoryJailed protected function Implements Drupal\Core\FileTransfer\FileTransfer::removeDirectoryJailed(). Overrides FileTransfer::removeDirectoryJailed
FTPExtension::removeFileJailed protected function Implements Drupal\Core\FileTransfer\FileTransfer::removeFileJailed(). Overrides FileTransfer::removeFileJailed