FileTransferSSH

  1. drupal
    1. 7 includes/filetransfer/ssh.inc

The SSH connection class for the update module.

Hierarchy

Properties

NameDescription
FileTransfer::$hostname
FileTransfer::$password
FileTransfer::$port
FileTransfer::$username

Functions & methods

NameDescription
FileTransfer::checkPathChecks that the path is inside the jail and throws an exception if not.
FileTransfer::chmod
FileTransfer::copyDirectoryCopies a directory.
FileTransfer::copyFileCopies a file.
FileTransfer::createDirectoryCreates a directory.
FileTransfer::findChrootReturn the chroot property for this connection.
FileTransfer::fixRemotePathReturns a modified path suitable for passing to the server. If a path is a windows path, makes it POSIX compliant by removing the drive letter. If $this->chroot has a value, it is stripped from the path to allow for chroot'd filetransfer systems.
FileTransfer::removeDirectoryRemoves a directory.
FileTransfer::removeFileRemoves a file.
FileTransfer::sanitizePathChanges backslashes to slashes, also removes a trailing slash.
FileTransfer::setChrootSets the chroot and changes the jail to match the correct path scheme
FileTransfer::__getImplementation of the magic __get() method.
FileTransferSSH::chmodJailedChanges the permissions of the file / directory specified in $path Overrides FileTransferChmodInterface::chmodJailed
FileTransferSSH::connectConnect to the server. Overrides FileTransfer::connect
FileTransferSSH::copyDirectoryJailedCopies a directory. Overrides FileTransfer::copyDirectoryJailed
FileTransferSSH::copyFileJailedCopies a file. Overrides FileTransfer::copyFileJailed
FileTransferSSH::createDirectoryJailedCreates a directory. Overrides FileTransfer::createDirectoryJailed
FileTransferSSH::factoryClasses that extend this class must override the factory() static method. Overrides FileTransfer::factory
FileTransferSSH::getSettingsFormReturns the form to configure the FileTransfer class for SSH. Overrides FileTransfer::getSettingsForm
FileTransferSSH::isDirectoryWARNING: This is untested. It is not currently used, but should do the trick. Overrides FileTransfer::isDirectory
FileTransferSSH::isFileChecks if a particular path is a file (not a directory). Overrides FileTransfer::isFile
FileTransferSSH::removeDirectoryJailedRemoves a directory. Overrides FileTransfer::removeDirectoryJailed
FileTransferSSH::removeFileJailedRemoves a file. Overrides FileTransfer::removeFileJailed
FileTransferSSH::__constructThe constructor for the UpdateConnection class. This method is also called from the classes that extend this class and override this method. Overrides FileTransfer::__construct

File

includes/filetransfer/ssh.inc, line 6

View source
class FileTransferSSH extends FileTransfer implements FileTransferChmodInterface {

  function __construct($jail, $username, $password, $hostname = "localhost", $port = 22) {
    $this->username = $username;
    $this->password = $password;
    $this->hostname = $hostname;
    $this->port = $port;
    parent::__construct($jail);
  }

  function connect() {
    $this->connection = @ssh2_connect($this->hostname, $this->port);
    if (!$this->connection) {
      throw new FileTransferException('SSH Connection failed to @host:@port', NULL, array('@host' => $this->hostname, '@port' => $this->port));
    }
    if (!@ssh2_auth_password($this->connection, $this->username, $this->password)) {
      throw new FileTransferException('The supplied username/password combination was not accepted.');
    }
  }

  static function factory($jail, $settings) {
    $username = empty($settings['username']) ? '' : $settings['username'];
    $password = empty($settings['password']) ? '' : $settings['password'];
    $hostname = empty($settings['advanced']['hostname']) ? 'localhost' : $settings['advanced']['hostname'];
    $port = empty($settings['advanced']['port']) ? 22 : $settings['advanced']['port'];
    return new FileTransferSSH($jail, $username, $password, $hostname, $port);
  }

  protected function copyFileJailed($source, $destination) {
    if (!@ssh2_scp_send($this->connection, $source, $destination)) {
      throw new FileTransferException('Cannot copy @source_file to @destination_file.', NULL, array('@source' => $source, '@destination' => $destination));
    }
  }

  protected function copyDirectoryJailed($source, $destination) {
    if (@!ssh2_exec($this->connection, 'cp -Rp ' . escapeshellarg($source) . ' ' . escapeshellarg($destination))) {
      throw new FileTransferException('Cannot copy directory @directory.', NULL, array('@directory' => $source));
    }
  }

  protected function createDirectoryJailed($directory) {
    if (@!ssh2_exec($this->connection, 'mkdir ' . escapeshellarg($directory))) {
      throw new FileTransferException('Cannot create directory @directory.', NULL, array('@directory' => $directory));
    }
  }

  protected function removeDirectoryJailed($directory) {
    if (@!ssh2_exec($this->connection, 'rm -Rf ' . escapeshellarg($directory))) {
      throw new FileTransferException('Cannot remove @directory.', NULL, array('@directory' => $directory));
    }
  }

  protected function removeFileJailed($destination) {
    if (!@ssh2_exec($this->connection, 'rm ' . escapeshellarg($destination))) {
      throw new FileTransferException('Cannot remove @directory.', NULL, array('@directory' => $destination));
    }
  }

  /**
   * WARNING: This is untested.  It is not currently used, but should do the trick.
   */
  public function isDirectory($path) {
    $directory = escapeshellarg($path);
    $cmd = "[ -d {$directory} ] && echo 'yes'";
    if ($output = @ssh2_exec($this->connection, $cmd)) {
      if ($output == 'yes') {
        return TRUE;
      }
      return FALSE;
    }
    else {
      throw new FileTransferException('Cannot check @path.', NULL, array('@path' => $path));
    }
  }

  public function isFile($path) {
    $file = escapeshellarg($path);
    $cmd = "[ -f {$file} ] && echo 'yes'";
    if ($output = @ssh2_exec($this->connection, $cmd)) {
      if ($output == 'yes') {
        return TRUE;
      }
      return FALSE;
    }
    else {
      throw new FileTransferException('Cannot check @path.', NULL, array('@path' => $path));
    }
  }

  function chmodJailed($path, $mode, $recursive) {
    $cmd = sprintf("chmod %s%o %s", $recursive ? '-R ' : '', $mode, escapeshellarg($path));
    if (@!ssh2_exec($this->connection, $cmd)) {
      throw new FileTransferException('Cannot change permissions of @path.', NULL, array('@path' => $path));
    }
  }

  /**
   * Returns the form to configure the FileTransfer class for SSH.
   */
  public function getSettingsForm() {
    $form = parent::getSettingsForm();
    $form['advanced']['port']['#default_value'] = 22;
    return $form;
  }
}
Login or register to post comments