Configure Xdebug in Eclipse PDT

Separate PDT and Xdebug versions

Install a current Eclipse PDT package, set the project’s PHP language level, and install an Xdebug build compatible with the runtime. Historical PDT documentation may mention Zend Debugger or Xdebug 2 directives; use current Xdebug documentation for extension settings.

Define server and executable context

Configure the PHP executable or web server launch in PDT, select Xdebug, and align listener port and session behavior. Web and CLI launches can use different ini files, so verify each independently.

Remote path handling

A remote or container server sends its own file paths. Configure mappings against the imported PHP project and ensure linked resources resolve predictably. Test a plain file before a framework front controller.

Keep workspace state reproducible

Document PDT release, update sites, project PHP version, and required plugins. Commit only reviewed project settings; do not share an entire Eclipse workspace or credentials as a debugging shortcut.

Verification and maintenance

Configure Xdebug in Eclipse PDT was reviewed for this seed on 2026-08-09. Before adopting its recommendations, confirm current releases, platform support, licensing, extension publishers, and configuration syntax through Eclipse PDT at the official source linked below. Product status and plugin compatibility can change independently of this editorial record.

Test changes on a representative repository and keep Composer scripts, automated tests, static analysis, and version control authoritative. If official documentation no longer supports a claim made on /ide/eclipse-pdt/xdebug/, mark the fact unknown or update it from a primary source rather than filling the gap from an old tutorial or download mirror.