Debugging a PHP Web Page
This procedure describes how to debug whole applications, projects,
files or collections of files that are already on the server.
Your server must be running the Zend
Debugger or Xdebug in order for remote debugging and
profiling capabilities to function.
The Zend Debugger comes bundled with Zend Studio and
Zend Server. For instructions on installing and configuring Xdebug, see Installing Xdebug and Configuring Xdebug.
To debug a PHP Web Page:
Click the arrow
next to the debug button
on the toolbar and select Debug Configurations -or- select
Run | Debug Configurations.
A Debug dialog will open.
PHP Web Page option to create a new debug configuration.
Enter a name for
the new configuration.
Select the Server
Debugger to be used (by
default this will be the Zend Debugger).
Select your server
from the PHP Server list.
If you have not yet configured your server, click New.
The PHP Server Creation Wizard will open.
Configure your server by following the instructions on 'adding a new server'
under the PHP Servers Preferences
For more information on
configuring the communication between Zend Studio
and your remote server, see Setting Up Remote
To check whether
your server connection is correctly configured, and that Zend Studio can communicate
with your server debugger, click the 'Check Debug Server Connection'
Under PHP File,
click Browse and select
your 'debug target' file (the file from which the debugging
process will start.)
the Debugger should stop at the first line of code by marking/unmarking
the 'Break at First Line' checkbox.
The URL to be
debugged will have been automatically created based on the
file name and your server address. If the URL does not point
to your debug target's location, unmark the Auto Generate
checkbox and modify the URL.
For further Debug
options, select the Advanced tab, which has the following
Debug Configuration - Advanced
Open in Browser - Mark if you would like the application
to be displayed in Zend Studio's
internal browser while it is debugged.
Choose whether to:
Debug All Pages
- The specified page and all the pages linked to it are debugged.
The browser waits for the debug of each page before displaying
Debug First Page
Only - Only the first page is debugged.
Start Debug from
- Select the URL from which you would like the Debugging process
from this Page - Selecting this option will result in all
the pages linked to the URL being debugged.
- Choose whether the source files used during this session
will be taken from the server or from a local copy.
If a local copy is not available, files will be taken from
the server. Selecting the 'Local Copy' option will result
in the Path Mapping mechanism being applied when files are
called. See the Path
Mapping topic for more details.
and then Debug.
Click Yes if
asked whether to open the PHP Debug Perspective.
the "Running and
Analyzing Debugger results" topic for more information
on the outcome of a debugging process.
If the file contains 'include' or 'require' calls to
files which are not contained within the project, you must add
them to the project's Include Path in order to simulate your production
In addition, if a file defined with an absolute path to a server location
(See 'Include Paths' for more on absolute
file locations) is called, a Path Mapping dialog will appear. See Path
Mapping for more information.