Welcome!

Turning Annoyances into Wonders Since Tuesday

Ken Fogel

Subscribe to Ken Fogel: eMailAlertsEmail Alerts
Get Ken Fogel via: homepageHomepage mobileMobile rssRSS facebookFacebook twitterTwitter linkedinLinkedIn


Related Topics: Eclipse Platform, PHP Developer's Journal

Tutorial

Configuring the PHP Version of Eclipse 3.5 RC4

Eclipse, WampServer, & Windows

Step 1: Download and install WampServer

Download the latest version of WAMP from here.

As of this writing the current version is 2.0h dated 04/16/09 and file you will download is called WampServer2.0h.exe

Run the file WampServer2.0h.exe

You will be asked to agree to the software license, approve the choice of directory, select the default browser, and decide if you want a desktop and/or quick launch icon. For the directory the default is c:\wamp but you may change to whatever you like. In later steps in this document it will be assumed you selected c:\wamp so change this to your choice of directory.

Step 2: Test the WampServer installation

Test the installation by running WampServer. An icon will appear in your tool tray. Click on it and you will see:

Select Localhost and your browser should start and the home page for WampServer should appear. If the browser reports that the page cannot be found select "Start All Services" and then refresh the page. If this does not work select "Put Online". If this doesn't work then cry and then check your firewall settings.

Step 3: Download and Install Eclipse for PHP

Download Eclipse for PHP. At the time of this writing we are a week away from the final version of 3.5. I used 3.5 Release Candidate 4 for this document.

Eclipse is packaged as a zip file so just unzip it into the folder of your choice. One possibility is in a folder within the WampServer installation. Since Eclipse is already in a folder called Eclipse I unzipped mine to c:\wamp and ended up with the following:

Step 4: Download and install the Zend PHP debugger plug-in for Eclipse

Download the Zend debugger file at this link:

Unzip this file to the same folder you unzipped Eclipse to. In my case I unzipped this file to C:\wamp

I have also installed XDebug but there is something not quite right. I suspect I have not found the right setting to tweak. As far as I can tell you can only have one of the debuggers running at a time. If you know how to get XDebug to work and if you know how to make both debuggers available at the same time then please let me know.

Step 5: Configure PHP to use the Zend Debugger in WAMP

On the Wamp menu select PHP -> php.ini

This will open the php.ini file for editing. Do not directly edit the php.ini file you may find with Windows Explorer. By going thru the menu the file you edit will be copied to its proper destination inside the Apache web server.

Add the following to the php.ini file right after the [Tidy] section:

[Tidy]
; The path to a default tidy configuration file to use when using tidy
;tidy.default_config = /usr/local/lib/php/default.tcfg
; Should tidy clean and repair output automatically?
; WARNING: Do not use this option if you are generating non-html content
; such as dynamic images
tidy.clean_output = Off
[Debugger]
zend_extension_ts=C:/wamp/eclipse/plugins
/org.zend.php.debug.debugger.win32.x86_5.2.15.v20081217
/resources/php5/ZendDebugger.dll
zend_debugger.allow_hosts=127.0.0.1, 192.168.0.2
zend_debugger.expose_remotely=always

The path after zend_extension_ts must be on one line.

The IP number 192.168.0.2 is the one assigned by my router. You must have your router assigned address.

From the Wamp menu Restart All Services and the select Localhost.

From this page select the link titled phpinfo() found under the title Tools.

This will display the PHP configuration page and there should be a section entitled Zend Debugger as shown here:

Step 6: Configure Eclipse for WampServer and the Zend Debugger

Start Eclipse and select a workspace. You will need to know the physical location of the workspace so make a note of it. In preparing this document my workspace is in:

C:\Users\neon\workspacephp

For you dinosaurs still using XP the equivalent location would be:

C:\Documents and Settings\neon\workspacephp

Remember that when there are spaces in a path you should enter the path when required with quotation marks:

"C:\Documents and Settings\neon\workspacephp"

To configure settings that will apply to all projects in this workspace go to the Windows->Preferences menu.

Open the PHP item in the tree on the left. There are two items here that need to be configured.

The first item is PHP Executables. Selecting this will display a number of versions of PHP that are included with Eclipse.

We want to use the version of PHP included with WampServer so we will add a new executable. Select Add.., give it a name, and browse to the php.exe inside the WampServer installation.

Leave out the PHP ini file and make sure the PHP debugger is set to Zend Debugger.

Make this new entry the default version of PHP.

Now we need to set up the Server.

We will edit the Default PHP Web Server but you could just as easily create a new server and set it as the default.

When you select the Default PHP Web Server and click on Edit you will see:

The only change to make is to add /workspace after http://localhost

The items on the tab for Path Mapping are left blank.

Click OK here and on the Preferences dialog and we are just minutes away from testing a PHP page.

More Stories By Ken Fogel

In 1980 I bought for myself the most wonderful toy of the day, the Apple ][+. Obsession followed quickly and by 1983 I was writing software for small and medium sized businesses in Montreal for both the Apple and the IBM PC under the company name Omnibus Systems. In the evenings I taught continuing education courses that demystified the computer to the first generation of workers who found themselves with their typewriter on the scrap heap and a PC with WordStar taking its place.

In 1990 I was invited to join the faculty at Dawson College in the Computer Science Technology program. When I joined the program the primary language was COBOL and my responsibility was to teach small systems languages such as BASIC and C/C++.

Today I am now the chairperson and program coordinator of the Computer Science Technology program at Dawson. The program's primary language is Java and the focus is on enterprise programming.

I like to write about the every day problems my students and I face in using various languages and platforms to get the job done. And from time to time I stray from the path and write about what I plan to do, what I actually get around to doing, and what I imagine I am doing.

@omniprof