Categories


Popular topics

Note: these settings are only available in UEStudio

The IDE » Debugger » Xdebug » Miscellaneous branch of Settings includes the following options related to PHP debugging via Xdebug in UEStudio.

Start Xdebug using the active document

If selected, Xdebug will automatically begin debugging the PHP document active in UEStudio you click Debug (start) in the Debug tab. UEStudio will automatically check to see if the active PHP file exists on or below the Root web directory defined below. If it does, then your default web browser will be launched with the active script run from http://localhost/ and ?XDEBUG_SESSION_NAME=phpTest automatically appended to the script URL to enable detection by Xdebug for debugging.

Please note: Apache server must already be running when you start debugging in order for the script to be launched automatically in your browser. If the server isn't running, the browser will display a "page not found" error. You cannot run PHP scripts by accessing them directly on the file system through the browser. You must run them through a locally-installed web server like Apache. See our power tip on PHP debugging in UEStudio for more information.

If the active script does not exist on or below the Root web directory, it is automatically launched and debugged as a console (command line) application using the environment variable defined during download and installation.

If this option is not selected, you would need to launch the script to be debugged in a browser after selecting Debug (start) from the Debug tab, with the ?XDEBUG_SESSION_NAME=phpTest parameter appended or from a command prompt (which would automatically force the use of the environment variable defined for Xdebug interaction) so that UEStudio can detect the running process on the specified port. Alternatively, you can configure the Xdebug settings in the php.ini file could be configured so that the remote_autostart option is set to "1":

xdebug.remote_autostart = 1

In this case, debugging starts automatically every time a PHP script is detected as running after you start debugging from UESduio, and the ?XDEBUG_SESSION_NAME=phpTest flag would not have to be appended to the script URL to enable debugging.

Root web directory

In order for the active script to be recognized as a browser-based script (and to be launched automatically on localhost local web server), the root web directory must be defined here. With the default WampServer installation this would be at C:\wamp\www but you should browse to the appropriate directory on your system if you're unsure of the exact location. This field is subdued unless Start Xdebug using the active document is enabled.

Port

By default, the port the Xdebug listens on is 9000, which is the default setting in UEStudio, and unless there is a compelling reason to do otherwise, you should keep the default port. If you want to change the port, keep in mind that you have to configure the same port number in UEStudio and the related php.ini.