Configure Xdebug in Apache NetBeans

Use current runtime directives

NetBeans supports PHP debugging, but some long-lived wiki examples use Xdebug 2 directives such as xdebug.remote_enable and port 9000. For Xdebug 3, use current xdebug.mode, xdebug.start_with_request, client host, and port documentation.

Select the project run configuration

Choose local website, script, or remote website according to where PHP executes. Point NetBeans at the intended PHP interpreter and verify that interpreter loads Xdebug. A remote web server must be able to connect back through the network or a tunnel.

Map and test paths

Configure server-to-local mappings when remote filenames differ. Start NetBeans debugging, trigger a minimal page, and inspect one variable. Only then test the application bootstrap, where rewrites and front controllers add complexity.

Protect shared servers

Use trigger-based sessions, restrict network exposure, and never enable Xdebug on public production traffic. Modernize old remote deployment workflows toward version-controlled releases even if NetBeans continues to support SFTP.

Verification and maintenance

Configure Xdebug in Apache NetBeans 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 Apache NetBeans PHP Debugging 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/netbeans/xdebug/, mark the fact unknown or update it from a primary source rather than filling the gap from an old tutorial or download mirror.