xdebug.ini

; ============================================================================
; KaririCode DevKit - Xdebug Configuration
; ============================================================================
; Xdebug 3.x configuration for step debugging and code coverage
; https://xdebug.org/docs/all_settings
;
; Location: devkit/.config/php/xdebug.ini
; ============================================================================

[xdebug]
; ============================================================================
; MODE CONFIGURATION
; ============================================================================
; Modes: off, develop, coverage, debug, gcstats, profile, trace
; Multiple modes can be combined with commas (e.g., "debug,coverage")
; This is controlled by environment variable XDEBUG_MODE in .env
xdebug.mode=${XDEBUG_MODE}

; ============================================================================
; DEBUGGING
; ============================================================================
; Start debugging automatically or wait for trigger
; Values: yes, no, trigger
xdebug.start_with_request=yes

; IDE/Client connection settings
; Use host.docker.internal for Docker Desktop (Mac/Windows)
; Use 172.17.0.1 for Docker on Linux
xdebug.client_host=host.docker.internal
xdebug.client_port=9003

; Discovery mode for cloud/dynamic environments
; Set to 1 if you need automatic discovery (not recommended for local dev)
xdebug.discover_client_host=0

; IDE key for identifying debugging session
; PHPStorm: PHPSTORM
; VSCode: VSCODE
xdebug.idekey=PHPSTORM

; Connection timeout in milliseconds
xdebug.connect_timeout_ms=2000

; ============================================================================
; LOGGING
; ============================================================================
; Log file location (useful for debugging connection issues)
xdebug.log=/var/log/xdebug.log

; Log level (0-10, where 10 is most verbose)
; 0 = Criticals
; 1 = Errors
; 3 = Warnings
; 5 = Communication
; 7 = Information
; 10 = Debug
xdebug.log_level=7

; ============================================================================
; STEP DEBUGGING
; ============================================================================
; Maximum nesting level for recursive debugging
; Increase if you have deeply nested structures
xdebug.max_nesting_level=512

; ============================================================================
; COVERAGE
; ============================================================================
; Enable code coverage (required for PHPUnit coverage)
xdebug.coverage_enable=1

; ============================================================================
; DEVELOPMENT MODE
; ============================================================================
; Development helpers (when mode=develop)
; Show local variables in stack traces
xdebug.dump.GET=*
xdebug.dump.POST=*
xdebug.dump.COOKIE=*
xdebug.dump.FILES=*
xdebug.dump.SESSION=*

; ============================================================================
; PROFILING (disabled by default)
; ============================================================================
; Uncomment to enable profiling
; xdebug.profiler_enable=0
; xdebug.profiler_enable_trigger=1
; xdebug.profiler_enable_trigger_value=""
; xdebug.profiler_output_dir=/var/www/profiler
; xdebug.profiler_output_name=cachegrind.out.%p

; ============================================================================
; TRACING (disabled by default)
; ============================================================================
; Uncomment to enable function tracing
; xdebug.trace_enable_trigger=1
; xdebug.trace_enable_trigger_value=""
; xdebug.trace_output_dir=/var/www/traces
; xdebug.trace_output_name=trace.%c
; xdebug.trace_format=0
; xdebug.trace_options=0

; ============================================================================
; PERFORMANCE
; ============================================================================
; Show memory usage in stack traces
xdebug.show_mem_delta=1

; ============================================================================
; DISPLAY
; ============================================================================
; HTML error output formatting
xdebug.cli_color=1

; Variable display depth
xdebug.var_display_max_depth=10

; Maximum number of array children/object properties
xdebug.var_display_max_children=256

; Maximum string length
xdebug.var_display_max_data=4096

; ============================================================================
; USAGE TIPS
; ============================================================================
;
; Enable Xdebug:
;   make xdebug-on
;
; Disable Xdebug:
;   make xdebug-off
;
; Check Status:
;   make xdebug-status
;
; IDE Configuration:
;   PHPStorm:
;     - Settings > PHP > Debug
;     - Port: 9003
;     - Check "Accept external connections"
;     - Settings > PHP > Servers
;     - Add server: localhost, port 9003
;     - Map: /var/www -> your-project-path
;
;   VSCode:
;     - Install PHP Debug extension
;     - Add to launch.json:
;       {
;         "name": "Listen for Xdebug",
;         "type": "php",
;         "request": "launch",
;         "port": 9003,
;         "pathMappings": {
;           "/var/www": "${workspaceFolder}"
;         }
;       }
;
; ============================================================================