PHP Extension

IMAP over Multiple Hop SSH

Demonstrates how to read IMAP email (using TCP or TLS) tunneled through mulitple-hop SSH. The scheme looks like this:

Application => ServerSSH1 => ServerSSH2 => IMAPServer

The ConnectThroughSsh and UseSsh methods are added in Chilkat version 9.5.0.55 to accomplish this task.

PHP Extension

<?php

include("chilkat.php");

$success = false;

// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

$ssh1 = new CkSsh();

// Connect directly to the 1st SSH server.
$success = $ssh1->Connect('serverssh1.com',22);
if ($success != true) {
    print $ssh1->lastErrorText() . "\n";
    exit;
}

// Authenticate using login/password:
$success = $ssh1->AuthenticatePw('ssh1Login','ssh1Password');
if ($success != true) {
    print $ssh1->lastErrorText() . "\n";
    exit;
}

// Connect through the 1st SSH connection to reach a 2nd SSH server.
// Note: Any number of SSH connections may be simultaneously tunneled through a single
// existing SSH connection.
$ssh2 = new CkSsh();
$success = $ssh2->ConnectThroughSsh($ssh1,'serverssh2.com',22);
if ($success != true) {
    print $ssh2->lastErrorText() . "\n";
    exit;
}

// Authenticate with ssh2...
$success = $ssh2->AuthenticatePw('ssh2Login','ssh2Password');
if ($success != true) {
    print $ssh2->lastErrorText() . "\n";
    exit;
}

$imap = new CkImap();

// Tell the IMAP object to connect to the IMAP server though the ssh2 tunnel (which itself is routed through ssh1).
// The connection looks like this:  Application => ServerSSH1 => ServerSSH2 => IMAPServer
$success = $imap->UseSsh($ssh2);
if ($success != true) {
    print $imap->lastErrorText() . "\n";
    exit;
}

$imap->put_Ssl(true);
$imap->put_Port(993);

// Connect to an IMAP server (through the multi-hop SSH tunnel)
$success = $imap->Connect('imap.someimapserver.com');
if ($success != true) {
    print $imap->lastErrorText() . "\n";
    exit;
}

// Login
$success = $imap->Login('myLogin','myPassword');
if ($success != true) {
    print $imap->lastErrorText() . "\n";
    exit;
}

// Do whatever needs to be done...  for example,

// Create the new email folder (sub-mailbox) on the IMAP server.
// If no folder path is provided, the new folder is a sub-mailbox of Inbox.
$success = $imap->CreateMailbox('newFolder');
if ($success != true) {
    print $imap->lastErrorText() . "\n";
    exit;
}

print 'Success.' . "\n";

// Close the connection with the IMAP server.  (This closes the tunnel through ssh2)
// The connection with ssh2 is still alive, and may be used for more connections.
$success = $imap->Disconnect();

// Close the connection with ssh2.  (This closes the the tunnel through ssh1.)
// The connection with ssh1 is still alive, and may be used for more connections.
$ssh2->Disconnect();

$ssh1->Disconnect();

?>