---
title: "How do I enable Xdebug in Pipelines?"
date: "2025-10-15T11:11:25+00:00"
summary:
image:
type: "article"
url: "/acquia-cloud-platform/help/92031-how-do-i-enable-xdebug-pipelines"
id: "84aec722-df8e-4125-8580-4c0d55e0a163"
---

This document describes how you can enable the [Xdebug](https://xdebug.org/) extension in Pipelines for PHP 8.3. With this, you can generate code coverage reports with PHPUnit.

To enable this extension:

1.  Confirm that Xdebug is available in the PHP image:
    
        php -m | grep xdebug
    
2.  Enable Xdebug temporarily as follows:
    
        php -d extension=xdebug.so -r "if (extension_loaded('xdebug')) { echo 'xdebug is loaded'; }"
    
3.  Add the following command to the `acquia-pipeline.yaml` file before the test steps:
    
        version: 1.3.0 services: - php: version: 8.3 events: build: steps: - enable-xdebug: type: script script: - echo "Enabling Xdebug temporarily" - php -d extension=xdebug.so -v - ./vendor/bin/phpunit --coverage-text
    
    This method enables Xdebug for that specific execution. You cannot enable this extension in a persistent manner as that is supported only after you update the `php.ini` file, requiring access which is not supported in Pipelines.