X-Git-Url: http://git.phpeclipse.com diff --git a/net.sourceforge.phpeclipse.help/docbook-src/guide/src/en/user-manual/install_debugger.xml b/net.sourceforge.phpeclipse.help/docbook-src/guide/src/en/user-manual/install_debugger.xml new file mode 100644 index 0000000..f46ab55 --- /dev/null +++ b/net.sourceforge.phpeclipse.help/docbook-src/guide/src/en/user-manual/install_debugger.xml @@ -0,0 +1,186 @@ + + + + + + + Installing Debugger + + At the moment only DBG is supported by the standard &phpeclipse; release. XDEBUG is only supported by loading the appropriate sources via CVS. + + + + + Installing <application>DBG</application> + installDBG + DBG is a full-featured php debugger engine, an interactive tool that helps you debug PHP scripts. It works with a production and/or development web server and allows you to debug your scripts locally or remotely, from an IDE or the console. &phpeclipse; has a built-in, pure Java debugging client that operates the DBG debugging engine. + + + + To get the debugger to work you need to install the debugger engine to run in the PHP interpreter, and configure the debugger client to communicate with the engine. + + + + Make sure you download the appropriate DBG binaries for your OS and your release of PHP (from 4.0.6 up to 4.3.10 and from 5.0.0 up to 5.0.3) (Note that the 5.0.3 debugger binary seems to work for the 5.0.4 and 5.05 interpreters.) If you are using Mac OS X you will have to build the debugger from source. + + + + + Getting the right php_dbg.dll + + DBG can be downloaded from DBG Downloads. You need to download the dbg modules packet for the appropriate operating system. Unpack the zipped packet and take the dll (or so) file which matches the PHP version you have currently running. E.g. for PHP 5.1.2 the correct file is php_dbg.dll-5.1.2. Rename the appropriate file to php_dbg.dll and read to find out the right destination location for the file. + + + + + + Find the extension directory + + + The best way to find out is via the phpinfo() command. Create a PHP-file called phpinfo.php with the following content: + ]]> and start it via your web browser. Then search for extension_dir. The right column shows the path to the directory where you have to place the php_dbg.dll (see ). + + +
+ The information about the extension directory + + + + + + + + +
+ + + + + Setup &phpini; + + Where is the &phpini; which needs to be set up? + + + + The simplest way to find out the path of the &phpini; is again with the help of the phpinfo function as described in + + + + + Another possibility to find out where an application searches specific files is by using a tool called Filemon which you can get from Sysinternals. + + + + + The resulting output shows the path of the &phpini; file within the topmost header. See + + + + Now open php.ini and search for implicit_flush, and set it to On. + + + + + copy the following lines into php.ini (they can go at the end of the file). For linux it is a php_dbg.so instead of php.dbg.dll. + + + + + Disable eAccelerator if it is installed and enabled: + + + + + Disable the Xdebug extension if installed (usually via pear) by commenting out + + + + Also if you have Zend Extension Manager installed (You should find a [Zend] section) make sure you add this line before any other zend_extension_ts (windows) or zend_extension (linux) lines: For Windows: + + For linux: + + + + + Restart web server + + +
+ Get the &phpini; path + + + + + + + + +
+ + + + + Test the DBG Installation + + When you have done all steps, restart your web server and again submit the phpinfo function as described in . Search the browser output for dbg and you should find a section like you can see in + + +
+ phpinfo showing the DBG section + + + + + + + + +
+ + + In addition you can submit the following URL within your browser: . Now, as there is no client running listening to dbg, you should see the following error message + + +
+ DBG Error Message + + + + + + + + +
+ + + + For setting up a debug configuration and doing real debugging with &phpeclipse;, see . + + + + + + + + + + Installing <application>XDEBUG</application> + installXDEBUG + The XDebug support is only available through direct checkout of the &phpeclipse; CVS repository. + + + + More to come. + + +