From 6652a09da6846d2272b6d34505c3941cf1b05420 Mon Sep 17 00:00:00 2001
From: Shivam Mathur <shivam_jpr@hotmail.com>
Date: Mon, 24 Oct 2022 03:34:36 +0530
Subject: [PATCH] Add debug builds section in the README

---
 README.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/README.md b/README.md
index 46328b27..08add95b 100644
--- a/README.md
+++ b/README.md
@@ -42,6 +42,7 @@ Setup PHP with required extensions, php.ini configuration, code-coverage support
   - [Basic Setup](#basic-setup)
   - [Matrix Setup](#matrix-setup)
   - [Nightly Build Setup](#nightly-build-setup)
+  - [Debug Build Setup](#debug-build-setup)
   - [Thread Safe Setup](#thread-safe-setup)
   - [Force Update Setup](#force-update-setup)
   - [Verbose Setup](#verbose-setup)
@@ -540,6 +541,23 @@ steps:
     tools: php-cs-fixer, phpunit
 ```
 
+### Debug Build Setup
+
+> Set up a PHP build with debugging symbols.
+
+- Production release builds of PHP without debugging symbols are set up by default.
+- You can use the `debug` environment variable to set up a build with debugging symbols for PHP 5.6 and above.
+
+```yaml
+steps:
+- name: Setup PHP with debugging symbols
+  uses: shivammathur/setup-php@v2
+  with:
+    php-version: '8.1'
+  env:
+    debug: true # specify true or false
+```
+
 ### Thread Safe Setup
 
 > Set up `TS` or `NTS` PHP on `Windows`.