How To Install Eclipse for PHP on Ubuntu
Explains all the steps required to install Eclipse for PHP development on Ubuntu and getting started with PHP development using the Hello World project.
In this tutorial, we will discuss the steps required to install the most recent release of Eclipse (Eclipse 2019) for PHP on the popular Linux distribution Ubuntu. It provides the steps for Ubuntu 18.04 LTS. The steps should be the same for other versions of Ubuntu and Linux based systems. It assumes that PHP and Java are already installed on the system.
Notes: You may follow How To Install Java 10 On Ubuntu, How To Install Java 11 On Ubuntu, and How To Install OpenJDK 12 On Ubuntu to install Java on Ubuntu 18.04 LTS. I have installed OpenJDK 12 for this tutorial. You can also follow How To Install PHP 7 On Ubuntu 18.04 LTS to install PHP 7 on Ubuntu 18.04 LTS.
Download Eclipse for PHP
Now click Linux 64 Bit link as highlighted in Fig 1. It will show the download options from mirror sites as shown in Fig 2.
Click on the Download Button to start the download.
Confirm PHP and Java
In this step, we will confirm whether PHP and Java are already installed on the system. You can also follow the links mentioned at the start of this tutorial to install missing PHP and Java on Ubuntu.
# Test PHP version
# It will show the PHP installed on the system
PHP 7.2.19-0ubuntu0.18.04.1 (cli) (built: Jun 4 2019 14:48:12) ( NTS )
Copyright (c) 1997-2018 The PHP Group
Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
with Zend OPcache v7.2.19-0ubuntu0.18.04.1, Copyright (c) 1999-2018, by Zend Technologies
# Test Java version
# It will show the Java installed on the system
openjdk 12.0.1 2019-04-16
OpenJDK Runtime Environment (build 12.0.1+12)
OpenJDK 64-Bit Server VM (build 12.0.1+12, mixed mode, sharing
I have installed the most recent version of PHP 7.2 and OpenJDK as shown above.
Install Eclipse for PHP
In this step, we will install Eclipse for PHP as downloaded by us in the previous step.
Extract the Eclipse file downloaded by us. It should be similar to the one as shown in Fig 3.
We can either directly execute the executable file as highlighted in Fig 3 or create a desktop icon by following the next step.
Create Desktop Shortcut
In this step, we will install the GNOME panel and use the same to create a desktop shortcut to execute the Eclipse installed by us in previous steps.
# Install GNOME Panel
sudo apt-get install --no-install-recommends gnome-panel
# Create Desktop icon
gnome-desktop-item-edit ~/Desktop/ --create-new
Now configure the Eclipse installation as shown in Fig 4. We will use the Eclipse icon available in the root of the installation directory.
Provide name and description of the shortcut as shown in Fig 4. Now click on the Browse
Press the OK
Execute Eclipse and Configure Workspace
In this step, we will execute the Eclipse and configure the workspace. A workspace is a collection of projects and arrangement of the development IDE.
Start Eclipse by either clicking the executable file from installation path or the desktop shortcut icon created by us. It will show the splash screen and show the dialog to choose workspace as shown in Fig 5.
Make sure that you have kept the checkbox to choose workspace at start of Eclipse as unchecked so that we can select a different workspace at the start of Eclipse.
Now click on the Launch Button to launch the Eclipse IDE with the selected workspace. It should look similar to the one as shown in Fig 6.
We can also uncheck the checkbox (Always show Welcome at
In this step, we will create our first PHP project using Eclipse and print Hello PHP on the console.
Click on File -> New -> PHP Project to create a PHP project in Eclipse. It will show the project configuration dialog as shown in Fig 8. We can either create the project at the workspace location or it can be some other location having all the existing PHP projects. I have also selected the PHP version 7.2 as shown in Fig 8.
Click the Finish Button to finalize and create the project within the active workspace.
Now right click on the Project -> New -> PHP File in order to create a PHP file. It will show the File Wizard as shown in Fig 9.
Provide the appropriate name of the PHP file and click the Finish
Now update the PHP file to echo Hello PHP as shown in Fig 10.
Now we will execute the PHP file. In order to execute the PHP file, we also need to configure the PHP environment in Eclipse. Click on Window -> Preferences -> PHP -> Installed PHPs. It will show the installed PHPs as shown in Fig 11.
We can see that none of the installed PHP is configured for the fresh install of Eclipse IDE. Click on the Add Button to configure PHP. It will show the dialog to add executable PHP as shown in Fig 12.
Configure the PHP executable as shown in Fig 12. I have used the default PHP installed on the system. You can also use a different PHP version if it's required for the project.
The Installed PHPs options will be updated and show the PHP executable added by us. Now we can execute our PHP file with a valid executable configured by us. Click on the Apply and Close Button to finalized our configurations.
To execute the PHP file,
This is how we can install the Eclipse for PHP on Ubuntu, create PHP project and execute the PHP files on the console. The same PHP files can also be accessed via Web Server to show the output on the Browser.