Connecting Zend Studio to Zend Debugger over an SSH Tunnel

This article applies to:

[ Zend Studio, Zend Server ]
[ All operating systems ]

Normally, Zend Studio initiates the remote debugging session by sending a regular HTTP request to the debug server. This HTTP request contains return address parameters (IP address and port number) that the Zend Debugger uses when starting a new connection to Zend Studio in order to relay debugging information.

Regular debug session

In many environments, it may be the case that the debugging session is prevented by some network obstacles (firewalls, routers, proxy servers, etc.). To allow safe and effective bypassing of network obstructions you can setup an SSH Tunnel for remote debugging with Zend Studio. In this case, the process of establishing the debug session consists of two major steps:

• Creating an SSH Tunnel
• Instructing Zend Debugger to relay its traffic through the SSH Tunnel

To setup an SSH Tunnel you need first to tell the SSH daemon to open a listening port on the server and forward the traffic from this port to the port on your workstation, where Zend Studio is listening. Once this is done you need to instruct Zend Debugger to send the debug information not to the Zend Studio workstation directly, but through the created tunnel.

Debug session trough the SSH Tunnel

Creating an SSH Tunnel

To create an SSH Tunnel from a Linux and Mac OS X workstation use this command template:

ssh :127.0.0.1: @

For example:

To create an SSH Tunnel from a Microsoft Windows workstation, you can use PuTTY. Run the program and configure it as described below:

1. From the Category list choose Connection

   Read more : Connecting Zend Studio to Zend Debugger over an SSH Tunnel