PHP

SSH Tunnel Thread Activity Log

Demonstrates the tunnel-log properties KeepTunnelLog, TunnelLog, and TunnelLogPath, which record the activity of the SSH tunnel and client-manager threads.

Note: The log paths are relative to the application's current working directory. Absolute paths may also be used.

Background: This is the counterpart to the accept log, covering the SSH side rather than the listener: the tunnel and client-manager threads that actually move data. As with the accept log, KeepTunnelLog enables the in-memory TunnelLog while TunnelLogPath writes a separate file. Together the two logs let you localize a problem to either the accepting side or the forwarding side.

Chilkat PHP Downloads

Download Chilkat for PHP

Chilkat2 PHP

<?php

use Chilkat2\SshTunnel;

// Demonstrates the SshTunnel tunnel-log properties KeepTunnelLog, TunnelLog, and TunnelLogPath.
//
// These log the activity of the SSH tunnel and client-manager threads.

$tunnel = new SshTunnel();

// Retain the SSH tunnel-thread activity in memory so it can be read from the TunnelLog property.
$tunnel->KeepTunnelLog = true;

// Optionally also write the tunnel-thread activity to a file (separate from the in-memory log).
$tunnel->TunnelLogPath = 'qa_output/tunnel.log';

$tunnel->DestHostname = 'db.internal.example.com';
$tunnel->DestPort = 5432;

$sshPort = 22;
try {
    $tunnel->Connect('ssh.example.com', $sshPort);

    // Normally you would not hard-code the password in source.  You should instead obtain it
    // from an interactive prompt, environment variable, or a secrets vault.
    $password = 'mySshPassword';

    $tunnel->AuthenticatePw('mySshLogin', $password);

    $listenPort = 1080;
    $tunnel->BeginAccepting($listenPort);
} catch (\Chilkat2\Exception $e) {
    echo $e->getMessage(), "\n";
    exit;
}

// ... clients transfer data through the tunnel ...

// Read the accumulated in-memory tunnel log.
echo $tunnel->TunnelLog, "\n";

$waitForThreadExit = true;
try {
    $tunnel->CloseTunnel($waitForThreadExit);
} catch (\Chilkat2\Exception $e) {
    echo $e->getMessage(), "\n";
    exit;
}