Bureaucrats, confirmed, Administrators
4,558
edits
Changes
initial content
== Intro ==
[http://www.eclipse.org/ Eclipse] is an open source community whose projects are focused on building an open development platform comprised of extensible frameworks, tools and runtimes for building, deploying and managing software across the application development lifecycle. A large and vibrant ecosystem of major technology vendors, innovative start-ups, universities, research institutions and individuals extend, complement and support the Eclipse platform.
As the project, community and resources are numerous, this page serves to note specific information that will help you use and interact with the technology most efficiently '''with a focus on the PHP developer'''.
== Installation ==
Getting and installing Eclipse used to be a lot more difficult than it is today. In late 2008, it is '''still''' not as simple as <code>sudo apt-get install eclipse</code>. You can do that, but '''the installed version will be 3.2, which dates from 2006 and will fail to meet requirements for recent modules like PDT'''. What's worse, the system can NOT upgrade itself. See https://help.ubuntu.com/community/EclipseIDE for more accurate help in installing Eclipse. The short instructions are to install a Java Virtual Machine (which you can use synaptic or apt-get for) and to '''download''' Eclipse and install it manually.
In spite of any relative ease compared to the way it was "back in the day" (when just installing Java took about a decade and three lawyers), it's a large project, with Java as a dependency and many applications that you can install on top of the framework. So, an exact description of how to get setup is important. In addition to the foregoing details, http://groups.drupal.org/node/6261 describes how to get yourself setup with a completely free development environment. It starts with Ubuntu (the Debian-based desktop distribution) and ends with configuring Eclipse for working with Drupal coding standards. (Now nicknamed appropriately 'Drubuntu'.)
The http://wiki.eclipse.org/PDT/Installation site offers good details on getting a clean and fully updated installation working.
== Components ==
As a [http://www.eclipse.org/home/categories/languages.php Language IDE] eclipse offers tools for just about every programming language (click on "Related EPIC Plugins" in the bottom panel). It has also expanded beyond what you might consider when you think "Integrated Development Environment" to include not just advanced tools like UML modeling, but even support for Service Oriented Architectures.
=== Web Tools Platform ===
=== Subclipse ===
[http://subclipse.tigris.org/ Subclipse] is an Eclipse Team Provider plug-in providing support for Subversion within the Eclipse IDE. [http://www.newt.com/java/eclipse/ this Eclipse HOWTO] covers subclipse installation and a couple other initial configuration items. I believe with the release of Ganymede (2008) that subversion integration is included, so I'd have to learn what the differences are between the subclipse project, and any subversion integration which is pre-packaged with the eclipse platform.
{{Ambox |
| text = One point of note is that sometimes you may want to get a 'minor' release upgrade (1.x.1 -> 1.y.1) for an installed plug-in such as subclipse. By default, the Eclipse Update Manager will not update you to a new minor release. In other words, if you have release 1.0.3 installed, it will update you to a 1.0.4 release, but it will not update you to a 1.1.0 or 1.2.0 release. You can change this in the Eclipse preferences. [http://subclipse.tigris.org/upgrade.html Open the Eclipse Preferences] and click on the Install/Update option.}}
=== PHPEclipse ===
[http://www.phpeclipse.net/ PHPEclipse] is ''not'' the same as the PDT. They are two separate PHP-oriented IDEs that install into the Eclipse framework. You should try each, and decide which one works best for you. http://www.phpeclipse.de/wiki/General/HowDoesPHPEclipseCompareWithOtherPHPEditors
=== PHP Developer Tools (PDT) ===
The [http://www.eclipse.org/pdt/ PDT] project is the reference environment for PHP Developers.
Installing the PDT is very simple, and the steps are listed at https://help.ubuntu.com/community/EclipsePDT The wiki for the project is at http://wiki.eclipse.org/index.php/PDT
Unfortunately, the current packaged eclipse (3.2.2) for Kubuntu fails some of the requirements for the PDT, so if you are just installing eclipse for the first time, you'll see an error like the following when trying to install PDT:
{{Ambox |
| type = notice
| text = PDT Feature (1.0.3.v20080603-79-7PE7QYGHNH6Gh) requires feature "org.eclipse.wst (2.0.0)", or compatible.}}
See
http://wiki.eclipse.org/IRC_FAQ#How_do_I_install_a_project_with_multiple_dependencies.3F Again, you'll probably want to REMOVE the 3.2 version and install a more recent version by hand because you can't upgrade one major release to the next.
=== Zend Studio for Eclipse ===
Zend Studio and other IDEs are similar to the PDT, but are not free.
* http://www.eclipseplugincentral.com/Web_Links-index-req-viewlink-cid-1268.html
* http://www.zend.com/en/products/studio/
== Extras ==
Due to it's extensible nature, any given project from Drupal to Symfony can create plugins for Eclipse that make developing for that particular Content Management System or Web Application Framework more enjoyable (automatic syntax helpers for the defined methods of the system) plus other features. For example, the Symfony framework includes many command-line tools and it's configuration is written in YAML. The [http://noy.cc/symfoclipse/ Symfoclipse plugin] makes these tools available from the IDE and provides YAML authoring and validation.
== Upgrading ==
It seems that Eclipse will not allow you to upgrade the system itself from Eclipse 3.2 to Eclipse 3.3 to Eclipse 3.4 to get Eclipse to work with the recent releases of PDT or PHPEclipse. Instead, you have to install the base Eclipse you want, and get the specific bundles that will work with that base.
{{ambox|
| text = the Eclipse Foundation coordinates an update to the technology on an annual basis (this process is called a "Release Train") and has been doing so every June since 2003.
; 2006 : Eclipse 3.2 / Calisto <nowiki>http://download.eclipse.org/releases/calisto/ </nowiki> discovery site
; 2007 : Eclipse 3.3 / [http://www.crn.com/software/200001763 Europa] <nowiki>http://download.eclipse.org/releases/europa/ </nowiki> discovery site
; 2008 : Eclipse 3.4 / [http://www.eclipse.org/ganymede/ Ganymede] <nowiki>http://download.eclipse.org/releases/ganymede/</nowiki> discovery site
}}
In addition to installing Eclipse, you should definitely be sure to set the Java environement
<source lang="bash">
sudo update-java-alternatives --list
</source>
That command should list something like
<pre>
java-6-sun 63 /usr/lib/jvm/java-6-sun
java-gcj 1042 /usr/lib/jvm/java-gcj
</pre>
Then you can set the Sun Microsystems Java as the default with
<source>
sudo update-java-alternatives --set java-6-sun
</source>
== Videos ==
* http://live.eclipse.org/
* [http://live.eclipse.org/node/578 PHP Tutorial: Using Eclipse+PDT as a PHP IDE]
[http://www.eclipse.org/ Eclipse] is an open source community whose projects are focused on building an open development platform comprised of extensible frameworks, tools and runtimes for building, deploying and managing software across the application development lifecycle. A large and vibrant ecosystem of major technology vendors, innovative start-ups, universities, research institutions and individuals extend, complement and support the Eclipse platform.
As the project, community and resources are numerous, this page serves to note specific information that will help you use and interact with the technology most efficiently '''with a focus on the PHP developer'''.
== Installation ==
Getting and installing Eclipse used to be a lot more difficult than it is today. In late 2008, it is '''still''' not as simple as <code>sudo apt-get install eclipse</code>. You can do that, but '''the installed version will be 3.2, which dates from 2006 and will fail to meet requirements for recent modules like PDT'''. What's worse, the system can NOT upgrade itself. See https://help.ubuntu.com/community/EclipseIDE for more accurate help in installing Eclipse. The short instructions are to install a Java Virtual Machine (which you can use synaptic or apt-get for) and to '''download''' Eclipse and install it manually.
In spite of any relative ease compared to the way it was "back in the day" (when just installing Java took about a decade and three lawyers), it's a large project, with Java as a dependency and many applications that you can install on top of the framework. So, an exact description of how to get setup is important. In addition to the foregoing details, http://groups.drupal.org/node/6261 describes how to get yourself setup with a completely free development environment. It starts with Ubuntu (the Debian-based desktop distribution) and ends with configuring Eclipse for working with Drupal coding standards. (Now nicknamed appropriately 'Drubuntu'.)
The http://wiki.eclipse.org/PDT/Installation site offers good details on getting a clean and fully updated installation working.
== Components ==
As a [http://www.eclipse.org/home/categories/languages.php Language IDE] eclipse offers tools for just about every programming language (click on "Related EPIC Plugins" in the bottom panel). It has also expanded beyond what you might consider when you think "Integrated Development Environment" to include not just advanced tools like UML modeling, but even support for Service Oriented Architectures.
=== Web Tools Platform ===
=== Subclipse ===
[http://subclipse.tigris.org/ Subclipse] is an Eclipse Team Provider plug-in providing support for Subversion within the Eclipse IDE. [http://www.newt.com/java/eclipse/ this Eclipse HOWTO] covers subclipse installation and a couple other initial configuration items. I believe with the release of Ganymede (2008) that subversion integration is included, so I'd have to learn what the differences are between the subclipse project, and any subversion integration which is pre-packaged with the eclipse platform.
{{Ambox |
| text = One point of note is that sometimes you may want to get a 'minor' release upgrade (1.x.1 -> 1.y.1) for an installed plug-in such as subclipse. By default, the Eclipse Update Manager will not update you to a new minor release. In other words, if you have release 1.0.3 installed, it will update you to a 1.0.4 release, but it will not update you to a 1.1.0 or 1.2.0 release. You can change this in the Eclipse preferences. [http://subclipse.tigris.org/upgrade.html Open the Eclipse Preferences] and click on the Install/Update option.}}
=== PHPEclipse ===
[http://www.phpeclipse.net/ PHPEclipse] is ''not'' the same as the PDT. They are two separate PHP-oriented IDEs that install into the Eclipse framework. You should try each, and decide which one works best for you. http://www.phpeclipse.de/wiki/General/HowDoesPHPEclipseCompareWithOtherPHPEditors
=== PHP Developer Tools (PDT) ===
The [http://www.eclipse.org/pdt/ PDT] project is the reference environment for PHP Developers.
Installing the PDT is very simple, and the steps are listed at https://help.ubuntu.com/community/EclipsePDT The wiki for the project is at http://wiki.eclipse.org/index.php/PDT
Unfortunately, the current packaged eclipse (3.2.2) for Kubuntu fails some of the requirements for the PDT, so if you are just installing eclipse for the first time, you'll see an error like the following when trying to install PDT:
{{Ambox |
| type = notice
| text = PDT Feature (1.0.3.v20080603-79-7PE7QYGHNH6Gh) requires feature "org.eclipse.wst (2.0.0)", or compatible.}}
See
http://wiki.eclipse.org/IRC_FAQ#How_do_I_install_a_project_with_multiple_dependencies.3F Again, you'll probably want to REMOVE the 3.2 version and install a more recent version by hand because you can't upgrade one major release to the next.
=== Zend Studio for Eclipse ===
Zend Studio and other IDEs are similar to the PDT, but are not free.
* http://www.eclipseplugincentral.com/Web_Links-index-req-viewlink-cid-1268.html
* http://www.zend.com/en/products/studio/
== Extras ==
Due to it's extensible nature, any given project from Drupal to Symfony can create plugins for Eclipse that make developing for that particular Content Management System or Web Application Framework more enjoyable (automatic syntax helpers for the defined methods of the system) plus other features. For example, the Symfony framework includes many command-line tools and it's configuration is written in YAML. The [http://noy.cc/symfoclipse/ Symfoclipse plugin] makes these tools available from the IDE and provides YAML authoring and validation.
== Upgrading ==
It seems that Eclipse will not allow you to upgrade the system itself from Eclipse 3.2 to Eclipse 3.3 to Eclipse 3.4 to get Eclipse to work with the recent releases of PDT or PHPEclipse. Instead, you have to install the base Eclipse you want, and get the specific bundles that will work with that base.
{{ambox|
| text = the Eclipse Foundation coordinates an update to the technology on an annual basis (this process is called a "Release Train") and has been doing so every June since 2003.
; 2006 : Eclipse 3.2 / Calisto <nowiki>http://download.eclipse.org/releases/calisto/ </nowiki> discovery site
; 2007 : Eclipse 3.3 / [http://www.crn.com/software/200001763 Europa] <nowiki>http://download.eclipse.org/releases/europa/ </nowiki> discovery site
; 2008 : Eclipse 3.4 / [http://www.eclipse.org/ganymede/ Ganymede] <nowiki>http://download.eclipse.org/releases/ganymede/</nowiki> discovery site
}}
In addition to installing Eclipse, you should definitely be sure to set the Java environement
<source lang="bash">
sudo update-java-alternatives --list
</source>
That command should list something like
<pre>
java-6-sun 63 /usr/lib/jvm/java-6-sun
java-gcj 1042 /usr/lib/jvm/java-gcj
</pre>
Then you can set the Sun Microsystems Java as the default with
<source>
sudo update-java-alternatives --set java-6-sun
</source>
== Videos ==
* http://live.eclipse.org/
* [http://live.eclipse.org/node/578 PHP Tutorial: Using Eclipse+PDT as a PHP IDE]