How To Run PHP Project In Eclipse

To run a PHP project in Eclipse, you need a Java JDK, a PHP engine, Eclipse with the PDT plugin, and a correctly configured PHP executable and server. This guide walks you through each step, from prerequisites to debugging with Xdebug, so you can execute PHP scripts and web pages directly from the IDE.

Before you run a php project in eclipse: prerequisites

Eclipse itself is a Java application, so it requires a Java Runtime Environment (JRE) or Java Development Kit (JDK) to launch. For recent Eclipse versions, Java 8 or newer is typically required; for the latest releases, Java 17 or newer may be necessary. Install the appropriate JDK from Oracle or OpenJDK and verify it with java -version in your terminal.

You also need a PHP engine (the PHP interpreter) installed on your system. Eclipse PDT uses this executable to parse, validate, and run your PHP code. Download PHP from php.net (Windows: zip package; macOS/Linux: package manager like Homebrew or apt), and note the full path to php.exe (Windows) or php (macOS/Linux). You can verify the installation by running php -v.

Install Eclipse and the PHP Development Tools (PDT) plugin

The easiest way to get PHP support is to download the “Eclipse IDE for PHP Developers” package from the official Eclipse website (eclipse.org/downloads). This package includes PDT out of the box. If you already have a different Eclipse edition (e.g., Java or Enterprise), you can add PDT manually via the Eclipse Marketplace.

To install PDT into an existing Eclipse:

Launch Eclipse and go to Help > Eclipse Marketplace.
In the search bar, type “PHP Development Tools” and press Enter.
Click Go to Marketplace next to the PDT entry, then click Install.
Review the components, accept the license, and click Finish.
Restart Eclipse when prompted to activate the plugin.

After restart, Eclipse will have PHP-specific features like syntax highlighting, content assist, code navigation, and syntax validation.

Create or import a PHP project

Create a new PHP project

Open Eclipse and switch to the PHP perspective: Window > Perspective > Open Perspective > PHP.
Go to File > New > PHP Project. Alternatively, right-click in the Project Explorer and select New > PHP Project.
Enter a project name. Choose a location (default is your workspace). You can optionally check “Create sample PHP file” or “Create web server configuration file” for a quick start.
Click Finish. Eclipse creates the project structure with source folders, and you’ll see it in the Project Explorer.

Import an existing PHP project

In the PHP perspective, go to File > Import (or right-click in Project Explorer and choose Import).
Expand General, select Existing Projects into Workspace, and click Next.
Choose Select root directory and browse to the folder containing your project, or choose Select archive file for a zip/tar.
Eclipse lists detected projects. Select the ones you want (hold Ctrl/Cmd for multiple) and click Finish.
The project is imported with its folder structure intact. If Eclipse doesn’t detect the PHP version automatically, you may need to manually set the interpreter (see next section). Also, check for any external libraries or dependencies and add them to the project’s build path if needed.

Configure the PHP executable in Eclipse

Eclipse needs to know where your PHP interpreter is located. To configure it:

Go to Window > Preferences (on macOS: Eclipse > Preferences).
Expand PHP and select Installed PHPs.
Click Add. In the dialog, browse to the php.exe file (Windows) or the php binary (macOS/Linux).
Eclipse auto-detects the PHP version and ini location. You can also add additional .ini files or set debugger settings here.
Click Finish and then Apply and Close.

You can configure multiple PHP interpreters and switch between them per project (right-click project > Properties > PHP > Interpreter). This is useful when working with different PHP versions.

Run a PHP script locally

To execute a PHP script (CLI-style) and see output in the Console:

In the Project Explorer, navigate to the PHP file you want to run.
Right-click the file and select Run As > PHP Script. Alternatively, go to Run > Run Configurations, double-click PHP Script, and create a new configuration.
In the Run Configurations dialog, give the configuration a name, select the PHP executable (from the configured list), and browse to the PHP file (the “PHP File” field).
You can specify program arguments, PHP script arguments, environment variables, or other settings in the respective tabs.
Click Run. The script executes, and output appears in the Console view.

Remember to save your file before running to include the latest changes. If your script uses include or require for files outside the project, add those directories to the project’s Include Path (right-click project > Properties > PHP Include Path) to simulate your production environment.

Run a PHP web page with a server

For web applications, you need to configure a PHP server (e.g., Apache, Nginx, or PHP’s built-in web server) so Eclipse can launch your pages in a browser.

Go to Run > Run Configurations.
Double-click PHP Web Page to create a new configuration.
Give it a name. Under the Server section, click New to open the PHP Server Creation Wizard.
Enter a server name. Set the Base URL (e.g., http://localhost:8080) and the Document Root (the folder on your server that maps to the project’s web root).
Optionally, click Test Debugger to verify the connection and debugger setup. If you have Xdebug installed, Eclipse will confirm it.
Click Finish to save the server configuration.
Back in the Run Configurations dialog, select the PHP file you want to run (or leave it blank to use the currently active editor).
By default, Eclipse auto-generates the URL based on the file name and server address. You can uncheck Auto Generate and manually edit the URL if needed.
Click Run.

If your project uses include or require for files outside the project, add them to the project’s Include Path as described in the previous section. This ensures the web page runs correctly with all dependencies.

Debug a PHP project with Xdebug

Debugging lets you step through code, inspect variables, and find errors. Eclipse PDT supports Xdebug and Zend Debugger. Here’s how to set up Xdebug:

Install and configure Xdebug

Install Xdebug on your PHP engine. On Windows, download the correct DLL from xdebug.org and add zend_extension=path/to/xdebug.dll to your php.ini. On macOS/Linux, use PECL (pecl install xdebug) or your package manager.
In php.ini, set xdebug.mode=debug and xdebug.start_with_request=yes (or trigger for manual start). Also set xdebug.client_host=127.0.0.1 and xdebug.client_port=9003 (or 9000 for older versions).
Restart your web server or PHP service.

Configure Eclipse for debugging

Go to Window > Preferences > PHP > Debug. Set the Debugger to Xdebug.
In PHP > Servers, ensure your server (from the previous section) is listed and uses the correct debugger settings.
Open the PHP file you want to debug. Set breakpoints by double-clicking the line number in the editor’s left margin (a blue circle appears).
Right-click the file and select Debug As > PHP Script (for CLI) or Debug As > PHP Web Page (for web). Eclipse switches to the Debug perspective.
Use the debug toolbar: Resume (F8), Step Over (F6), Step Into (F5), and Step Return (F7).
Inspect variables by hovering over them in the editor, or use the Variables and Expressions views to monitor values and scope.

If you’re debugging a web page, make sure your browser has the Xdebug helper extension installed (for Chrome/Firefox) to trigger debugging sessions, or set xdebug.start_with_request=yes to always start.

View PHP files in browser

To quickly view a PHP file in a browser without a full run configuration:

Right-click the PHP file in Project Explorer.
Select Run As > PHP Web Page (if you have a server configured) or Run As > PHP Script for CLI output.
Alternatively, use the Run button (green play icon) in the toolbar and choose the appropriate configuration.
Eclipse opens the page in your default browser using the server’s base URL and the file’s path.

If you see a “404 Not Found,” check that the document root in your server configuration matches the project’s web root, and that the file is inside that directory.