help/html/locally_debugging_a_php_script.htm - gerrit/www.eclipse.org/pdt - Git at Google

 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN">
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  <meta name="generator" content="Adobe RoboHelp 8">
 <title>Locally Debugging a PHP Script</title>
 <link rel="StyleSheet" href="default.css" type="text/css">
 <style type="text/css">
 <!--
 body { border-left-style:None;
 border-right-style:None;
 border-bottom-style:None;
 background-color:Transparent;
 border-top-style:None; }
 -->
 </style>
 <style type="text/css">
 <!--
 body { border-left-style:None;
 border-right-style:None;
 border-bottom-style:None;
 background-color:Transparent;
 border-top-style:None; }
 -->
 </style>
 <script type="text/javascript" language="JavaScript">
 //<![CDATA[
 function reDo() {
   if (innerWidth != origWidth || innerHeight != origHeight)
      location.reload();
 }
 if ((parseInt(navigator.appVersion) == 4) && (navigator.appName == "Netscape")) {
 	origWidth = innerWidth;
 	origHeight = innerHeight;
 	onresize = reDo;
 }
 onerror = null;
 //]]>
 </script>
 <style type="text/css">
 <!--
 div.WebHelpPopupMenu { position:absolute;
 left:0px;
 top:0px;
 z-index:4;
 visibility:hidden; }
 p.WebHelpNavBar { text-align:right; }
 -->
 </style>
 <script type="text/javascript" language="javascript1.2" src="whmsg.js"></script>
 <script type="text/javascript" language="javascript" src="whver.js"></script>
 <script type="text/javascript" language="javascript1.2" src="whproxy.js"></script>
 <script type="text/javascript" language="javascript1.2" src="whutils.js"></script>
 <script type="text/javascript" language="javascript1.2" src="whlang.js"></script>
 <script type="text/javascript" language="javascript1.2" src="whtopic.js"></script>
 <script type="text/javascript" language="javascript1.2">//<![CDATA[
 <!--
 if (window.gbWhTopic)
 {
 	var strUrl = document.location.href;
 	var bc = 0;
 	var n = strUrl.toLowerCase().indexOf("bc-");
 	if(n != -1)
 	{
 		document.location.href = strUrl.substring(0, n);
 		bc = strUrl.substring(n+3);
 	}

 	if (window.setRelStartPage)
 	{
 	addTocInfo("Tasks\nDebugging Files and Applications\nLocally Debugging a PHP Script");
 addAvenueInfo("Tasks","setting_breakpoints.htm","debugging_a_php_web_page.htm");

 	}

 	document.write("<p style=\"text-align:left\"> ");
 AddMasterBreadcrumbs("ide_help.htm", "", "&gt;", "Home", "pdt_table_of_contents.htm");
 document.write("<a href=\"tasks.htm\">Tasks<\/a> &gt; <a href=\"debugging.htm\">Debugging Files and Applications<\/a> &gt; Locally Debugging a PHP Script<\/p>");


 	if (window.setRelStartPage)
 	{
 	setRelStartPage("ide_help.htm");

 		autoSync(0);
 		sendSyncInfo();
 		sendAveInfoOut();
 	}

 }
 else
 	if (window.gbIE4)
 		document.location.reload();
 //-->
 //]]></script>
 </head>

 <body leftmargin="5" topmargin="5" rightmargin="5" bottommargin="5"><script type="text/javascript" language="javascript1.2">//<![CDATA[
 <!--
 if (window.writeIntopicBar)
 	writeIntopicBar(4);
 //-->
 //]]></script>
 <div style="width: 100%; position: relative;" id="header">


  <p align="right"><a
 	 title="Documentation Survey" href="http://spreadsheets.google.com/viewform?formkey=dC1scEswTjFia2tDQ3Y5TVJBbkNQcWc6MQ">Documentation
 	 Survey</a>
 	 | <a href="javascript:crlf=&quot;&quot;;h=location.href;t=document.title;e = &quot;&quot; + (window.getSelection ? window.getSelection() : document.getSelection ? document.getSelection() : document.selection.createRange().text); if (e!=null) location=&quot;mailto:documentation@zend.com&quot; + &quot;?Subject= Feedback on PDT for page &quot; + escape(t) + &quot;&amp;Body=&quot; + escape(e).replace(/ /g, &quot;+&quot;) + crlf + &quot; &quot;; void 0"><span
 	 style="background-color: #ffffff;">Submit Documentation</span><span
 	 style="background-color: #ffffff;"> Feedback</span></a><span
 	 style="background-color: #ffffff;"></span><span style="background-color: #ffffff;">
 	 </span><span style="background-color: #ffffff;">|
 	 </span><span
 	 style="background-color: #ffffff;"><a title="View Latest Version and Get PDF Online"
 											 href="http://www.zend.com/en/resources/zend-documentation/"
 											 target="_blank">View Latest
 	 Version and Get PDF Online</a></span></p>
 </div>


 <h1>Locally Debugging a PHP Script
  </h1>
 <p>This procedure describes how to debug a PHP Script from your workspace
  using an internal <a href="php_executables.htm">PHP Executable</a>.</p>
 <p class="Note">Note:</p>
 <p class="NoteText">You must configure
  your PHP Executable through the <a href="php_executables.htm">PHP
  Executables Preferences page</a> before you can debug locally.</p>
 <table cellspacing="0" width="100%">
 	<col style="width: 7.093%;">
 	<col style="width: 92.907%;">
 	<tr valign="top">
 		<td style="width: 7.093%; padding-right: 10px; padding-left: 10px;"><p
 			 style="font-size: 6pt;">&#160;</p></td>
 		<td style="width: 92.907%; padding-right: 10px; padding-left: 10px;"><p
 			 style="font-weight: bold;">&#160;</p></td>
 	</tr>
 	<tr valign="top">
 		<td style="width: 7.093%; padding-right: 10px; padding-left: 10px;"><p
 			 style="font-size: 6pt;"><img src="ref_icon.png" alt="Instructions on how to complete a procedure" title="Instructions on how to complete a procedure" style="border: none;" width="28" height="33" border="0"></p></td>
 		<td style="width: 92.907%; padding-right: 10px; padding-left: 10px;"><p
 			 style="font-weight: bold;">To locally debug a PHP Script:</p>
 		<ol type="1">
 			<li class="p" style="margin-left: -20px;"><p>Set breakpoints
 			 at the relevant places in the file that you would like to
 			 debug by double-clicking the vertical marker bar to the left
 			 of the editor.</p></li>
 			<li class="p" style="margin-left: -20px;"><p>Save the file.</p></li>
 			<li class="p" style="margin-left: -20px;"><p>Click the arrow
 			 next to the debug button <img src="debug_icon.png" alt="debug_icon.png" style="border: none;" width="39" height="25" border="0">
 			 on the toolbar and select Debug Configurations... -or- select
 			 <span style="font-weight: bold;"><b>Run | Debug Configurations....</b></span><br>
 			A Debug dialog will open.</p></li>
 			<li class="p" style="margin-left: -20px;"><p>Double-click the
 			 PHP Script option to create a new debug configuration.</p></li>
 		</ol>
 		<p class="picture"><img src="debug_phpscript_configuration.png" alt="New Debug Configuration" title="New Debug Configuration" style="border: none;" width="510" height="398" border="0"></p>

 		<ol start="5" type="1">
 			<li class="p" style="margin-left: -20px;"><p>Enter a name for
 			 the new configuration.</p></li>
 			<li class="p" style="margin-left: -20px;"><p> S
 			 elect the required PHP executable.
 			 <br>
 			If no PHP Executables are
 			 listed, click the PHP Executable link and add a PHP Executable
 			 in the <a href="php_executables.htm">PHP Executable Preferences</a>
 			 page. The PHP Executables
 			 must match the Debugger type. </p></li>
 			<li class="p" style="margin-left: -20px;"><p>Select the PHP
 			 Debugger to be used. PDT
 			 supports both the Zend Debugger and XDebug.
 			 </p></li>
 			<li class="p" style="margin-left: -20px;"><p>Enter your PHP
 			 file in the &quot;PHP File&quot; text field, or click <span
 			 style="font-weight: bold;"><b>Browse</b></span> and select your file</p></li>
 			<li class="p" style="margin-left: -20px;"><p>Marking the &quot;Breakpoint&quot;
 			 checkbox will result in the debugging process pausing at the
 			 first line of code.</p></li>
 			<li class="p" style="margin-left: -20px;"><p>If necessary,
 			 you can add arguments in the PHP Script Arguments tab to simulate
 			 command line inputs.</p></li>
 			<li class="p" style="margin-left: -20px;"><p>Click <span style="font-weight: bold;"><b>Apply</b></span>
 			 and then <span style="font-weight: bold;"><b>Debug</b></span>.</p></li>
 			<li class="p" style="margin-left: -20px;"><p>Click <span style="font-weight: bold;"><b>Yes</b></span>
 			 if asked whether to open the PHP Debug Perspective.</p></li>
 		</ol></td>
 	</tr>
 	<tr valign="top">
 		<td colspan="2" style="width: 100%; padding-right: 10px; padding-left: 10px;"><p>A
 		 number of views will open with relevant debug information.</p>
 		<p>See the <a href="analyzing_debugger_results.htm">Running and
 		 Analyzing Debugger results</a> topic for more information on the
 		 outcome of a debugging process.</p></td>

 	</tr>
 </table>
 <p class="Note">Note:</p>
 <p class="NoteText">If the file contains 'include' or 'require' calls to
  files which are not contained within the project, you must <a href="adding_elements_to_a_project_s_include_path.htm">add
  them to the project's Include Path</a> in order to simulate your production
  environment.</p>
 <table cellspacing="0" width="100%">
 	<col style="width: 7.093%;">
 	<col style="width: 92.907%;">
 	<tr valign="top">
 		<td style="width: 7.093%; padding-right: 10px; padding-left: 10px;"><p
 			 style="font-size: 6pt;">&#160;</p></td>
 		<td style="width: 92.907%; padding-right: 10px; padding-left: 10px;"><p>&#160;</p></td>
 	</tr>
 	<tr valign="top">
 		<td style="width: 7.093%; padding-right: 10px; padding-left: 10px;"><p
 			 style="font-size: 6pt;"><img src="link_icon.png" alt="link_icon.png" style="border: none;" width="32" height="40" border="0"></p></td>
 		<td style="width: 92.907%; padding-right: 10px; padding-left: 10px;"><p
 			 style="font-weight: bold;">Related Links:</p>
 		<p><a href="working_with_the_debugger.htm">Working
 		 with the Debugger </a></p>
 		<p><a href="debugging.htm">Debugging
 		 </a></p>

 		<p><a href="debug.htm">Debug
 		 Preferences </a></p>
 		<p><a href="debugging_a_php_web_page.htm">Debugging
 		 a PHP Web Page </a></p>


 		<p><a href="analyzing_debugger_results.htm">Running
 		 and Analyzing Debugger Results </a></p>
 		<p><a href="run.htm">Run Menu</a> </p>
 		<p><a href="php_support.htm">PHP Support</a> </p></td>
 	</tr>
 	<tr valign="top">
 		<td style="width: 7.093%; padding-right: 10px; padding-left: 10px;"><p
 			 style="font-size: 6pt;">&#160;</p></td>
 		<td style="width: 92.907%; padding-right: 10px; padding-left: 10px;"><p>&#160;</p></td>
 	</tr>
 </table>
 <div style="width: 100%; position: relative;" id="footer">

  <p style="text-decoration: underline; "
 										 align="center">PHP Development
 	 Tools</p>


 </div>
 <script type="text/javascript" language="javascript1.2">//<![CDATA[
 <!--
 if (window.writeIntopicBar)
 	writeIntopicBar(0);

 highlightSearch();
 //-->
 //]]></script>
 </body>
 </html>
	<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN">
	<html>
	<head>
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
	<meta name="generator" content="Adobe RoboHelp 8">
	<title>Locally Debugging a PHP Script</title>
	<link rel="StyleSheet" href="default.css" type="text/css">
	<style type="text/css">
	<!--
	body { border-left-style:None;
	border-right-style:None;
	border-bottom-style:None;
	background-color:Transparent;
	border-top-style:None; }
	-->
	</style>
	<style type="text/css">
	<!--
	body { border-left-style:None;
	border-right-style:None;
	border-bottom-style:None;
	background-color:Transparent;
	border-top-style:None; }
	-->
	</style>
	<script type="text/javascript" language="JavaScript">
	//<![CDATA[
	function reDo() {
	if (innerWidth != origWidth \|\| innerHeight != origHeight)
	location.reload();
	}
	if ((parseInt(navigator.appVersion) == 4) && (navigator.appName == "Netscape")) {
	origWidth = innerWidth;
	origHeight = innerHeight;
	onresize = reDo;
	}
	onerror = null;
	//]]>
	</script>
	<style type="text/css">
	<!--
	div.WebHelpPopupMenu { position:absolute;
	left:0px;
	top:0px;
	z-index:4;
	visibility:hidden; }
	p.WebHelpNavBar { text-align:right; }
	-->
	</style>
	<script type="text/javascript" language="javascript1.2" src="whmsg.js"></script>
	<script type="text/javascript" language="javascript" src="whver.js"></script>
	<script type="text/javascript" language="javascript1.2" src="whproxy.js"></script>
	<script type="text/javascript" language="javascript1.2" src="whutils.js"></script>
	<script type="text/javascript" language="javascript1.2" src="whlang.js"></script>
	<script type="text/javascript" language="javascript1.2" src="whtopic.js"></script>
	<script type="text/javascript" language="javascript1.2">//<![CDATA[
	<!--
	if (window.gbWhTopic)
	{
	var strUrl = document.location.href;
	var bc = 0;
	var n = strUrl.toLowerCase().indexOf("bc-");
	if(n != -1)
	{
	document.location.href = strUrl.substring(0, n);
	bc = strUrl.substring(n+3);
	}

	if (window.setRelStartPage)
	{
	addTocInfo("Tasks\nDebugging Files and Applications\nLocally Debugging a PHP Script");
	addAvenueInfo("Tasks","setting_breakpoints.htm","debugging_a_php_web_page.htm");

	}

	document.write("<p style=\"text-align:left\"> ");
	AddMasterBreadcrumbs("ide_help.htm", "", ">", "Home", "pdt_table_of_contents.htm");
	document.write("<a href=\"tasks.htm\">Tasks<\/a> > <a href=\"debugging.htm\">Debugging Files and Applications<\/a> > Locally Debugging a PHP Script<\/p>");


	if (window.setRelStartPage)
	{
	setRelStartPage("ide_help.htm");

	autoSync(0);
	sendSyncInfo();
	sendAveInfoOut();
	}

	}
	else
	if (window.gbIE4)
	document.location.reload();
	//-->
	//]]></script>
	</head>

	<body leftmargin="5" topmargin="5" rightmargin="5" bottommargin="5"><script type="text/javascript" language="javascript1.2">//<![CDATA[
	<!--
	if (window.writeIntopicBar)
	writeIntopicBar(4);
	//-->
	//]]></script>
	<div style="width: 100%; position: relative;" id="header">


	<p align="right"><a
	title="Documentation Survey" href="http://spreadsheets.google.com/viewform?formkey=dC1scEswTjFia2tDQ3Y5TVJBbkNQcWc6MQ">Documentation
	Survey</a>
	\| <a href="javascript:crlf="";h=location.href;t=document.title;e = "" + (window.getSelection ? window.getSelection() : document.getSelection ? document.getSelection() : document.selection.createRange().text); if (e!=null) location="mailto:documentation@zend.com" + "?Subject= Feedback on PDT for page " + escape(t) + "&Body=" + escape(e).replace(/ /g, "+") + crlf + " "; void 0"><span
	style="background-color: #ffffff;">Submit Documentation</span><span
	style="background-color: #ffffff;"> Feedback</span></a><span
	style="background-color: #ffffff;"></span><span style="background-color: #ffffff;">
	</span><span style="background-color: #ffffff;">\|
	</span><span
	style="background-color: #ffffff;"><a title="View Latest Version and Get PDF Online"
	href="http://www.zend.com/en/resources/zend-documentation/"
	target="_blank">View Latest
	Version and Get PDF Online</a></span></p>
	</div>


	<h1>Locally Debugging a PHP Script
	</h1>
	<p>This procedure describes how to debug a PHP Script from your workspace
	using an internal <a href="php_executables.htm">PHP Executable</a>.</p>
	<p class="Note">Note:</p>
	<p class="NoteText">You must configure
	your PHP Executable through the <a href="php_executables.htm">PHP
	Executables Preferences page</a> before you can debug locally.</p>
	<table cellspacing="0" width="100%">
	<col style="width: 7.093%;">
	<col style="width: 92.907%;">
	<tr valign="top">
	<td style="width: 7.093%; padding-right: 10px; padding-left: 10px;"><p
	style="font-size: 6pt;"> </p></td>
	<td style="width: 92.907%; padding-right: 10px; padding-left: 10px;"><p
	style="font-weight: bold;"> </p></td>
	</tr>
	<tr valign="top">
	<td style="width: 7.093%; padding-right: 10px; padding-left: 10px;"><p
	style="font-size: 6pt;"><img src="ref_icon.png" alt="Instructions on how to complete a procedure" title="Instructions on how to complete a procedure" style="border: none;" width="28" height="33" border="0"></p></td>
	<td style="width: 92.907%; padding-right: 10px; padding-left: 10px;"><p
	style="font-weight: bold;">To locally debug a PHP Script:</p>
	<ol type="1">
	<li class="p" style="margin-left: -20px;"><p>Set breakpoints
	at the relevant places in the file that you would like to
	debug by double-clicking the vertical marker bar to the left
	of the editor.</p></li>
	<li class="p" style="margin-left: -20px;"><p>Save the file.</p></li>
	<li class="p" style="margin-left: -20px;"><p>Click the arrow
	next to the debug button <img src="debug_icon.png" alt="debug_icon.png" style="border: none;" width="39" height="25" border="0">
	on the toolbar and select Debug Configurations... -or- select
	<span style="font-weight: bold;"><b>Run \| Debug Configurations....</b></span><br>
	A Debug dialog will open.</p></li>
	<li class="p" style="margin-left: -20px;"><p>Double-click the
	PHP Script option to create a new debug configuration.</p></li>
	</ol>
	<p class="picture"><img src="debug_phpscript_configuration.png" alt="New Debug Configuration" title="New Debug Configuration" style="border: none;" width="510" height="398" border="0"></p>

	<ol start="5" type="1">
	<li class="p" style="margin-left: -20px;"><p>Enter a name for
	the new configuration.</p></li>
	<li class="p" style="margin-left: -20px;"><p> S
	elect the required PHP executable.
	<br>
	If no PHP Executables are
	listed, click the PHP Executable link and add a PHP Executable
	in the <a href="php_executables.htm">PHP Executable Preferences</a>
	page. The PHP Executables
	must match the Debugger type. </p></li>
	<li class="p" style="margin-left: -20px;"><p>Select the PHP
	Debugger to be used. PDT
	supports both the Zend Debugger and XDebug.
	</p></li>
	<li class="p" style="margin-left: -20px;"><p>Enter your PHP
	file in the "PHP File" text field, or click <span
	style="font-weight: bold;"><b>Browse</b></span> and select your file</p></li>
	<li class="p" style="margin-left: -20px;"><p>Marking the "Breakpoint"
	checkbox will result in the debugging process pausing at the
	first line of code.</p></li>
	<li class="p" style="margin-left: -20px;"><p>If necessary,
	you can add arguments in the PHP Script Arguments tab to simulate
	command line inputs.</p></li>
	<li class="p" style="margin-left: -20px;"><p>Click <span style="font-weight: bold;"><b>Apply</b></span>
	and then <span style="font-weight: bold;"><b>Debug</b></span>.</p></li>
	<li class="p" style="margin-left: -20px;"><p>Click <span style="font-weight: bold;"><b>Yes</b></span>
	if asked whether to open the PHP Debug Perspective.</p></li>
	</ol></td>
	</tr>
	<tr valign="top">
	<td colspan="2" style="width: 100%; padding-right: 10px; padding-left: 10px;"><p>A
	number of views will open with relevant debug information.</p>
	<p>See the <a href="analyzing_debugger_results.htm">Running and
	Analyzing Debugger results</a> topic for more information on the
	outcome of a debugging process.</p></td>

	</tr>
	</table>
	<p class="Note">Note:</p>
	<p class="NoteText">If the file contains 'include' or 'require' calls to
	files which are not contained within the project, you must <a href="adding_elements_to_a_project_s_include_path.htm">add
	them to the project's Include Path</a> in order to simulate your production
	environment.</p>
	<table cellspacing="0" width="100%">
	<col style="width: 7.093%;">
	<col style="width: 92.907%;">
	<tr valign="top">
	<td style="width: 7.093%; padding-right: 10px; padding-left: 10px;"><p
	style="font-size: 6pt;"> </p></td>
	<td style="width: 92.907%; padding-right: 10px; padding-left: 10px;"><p> </p></td>
	</tr>
	<tr valign="top">
	<td style="width: 7.093%; padding-right: 10px; padding-left: 10px;"><p
	style="font-size: 6pt;"><img src="link_icon.png" alt="link_icon.png" style="border: none;" width="32" height="40" border="0"></p></td>
	<td style="width: 92.907%; padding-right: 10px; padding-left: 10px;"><p
	style="font-weight: bold;">Related Links:</p>
	<p><a href="working_with_the_debugger.htm">Working
	with the Debugger </a></p>
	<p><a href="debugging.htm">Debugging
	</a></p>

	<p><a href="debug.htm">Debug
	Preferences </a></p>
	<p><a href="debugging_a_php_web_page.htm">Debugging
	a PHP Web Page </a></p>


	<p><a href="analyzing_debugger_results.htm">Running
	and Analyzing Debugger Results </a></p>
	<p><a href="run.htm">Run Menu</a> </p>
	<p><a href="php_support.htm">PHP Support</a> </p></td>
	</tr>
	<tr valign="top">
	<td style="width: 7.093%; padding-right: 10px; padding-left: 10px;"><p
	style="font-size: 6pt;"> </p></td>
	<td style="width: 92.907%; padding-right: 10px; padding-left: 10px;"><p> </p></td>
	</tr>
	</table>
	<div style="width: 100%; position: relative;" id="footer">

	<p style="text-decoration: underline; "
	align="center">PHP Development
	Tools</p>


	</div>
	<script type="text/javascript" language="javascript1.2">//<![CDATA[
	<!--
	if (window.writeIntopicBar)
	writeIntopicBar(0);

	highlightSearch();
	//-->
	//]]></script>
	</body>
	</html>