README.md

Xdebug

Ansible role to install and configure Xdebug on Ubuntu.

Requirements

• PHP

Role Variables

All variables are listed below, along with their default values in defaults/main.yml:

Variables for installing and configuring xdebug 2:

# The version of the xdebug package to install (ie. php7.2-xdebug)
xdebug_php_version: 7.2

xdebug_version: 2

# xdbebug.ini settings
# see: https://xdebug.org/docs/all_settings

xdebug_conf_max_nesting_level: 256
xdebug_conf_idekey: PHPSTORM

# Start xdebug on every requset, regardless of the GET/POST variable
xdebug_remote_autostart: 0

# Connect to the client that sent the request
xdebug_conf_remote_connect_back: 0

# Connect to the specified host (overidden by remote_connect_back)
# 10.0.2.2 is the default IP address virtualbox assigns to the host
xdebug_remote_enable: 0
xdebug_remote_host: 10.0.2.2
xdebug_conf_remote_port: 9000

Variables for installing and configuring xdebug 3:

# The version of the xdebug package to install (ie. php7.2-xdebug)
xdebug_php_version: 7.2

xdebug_version: 3

# xdbebug.ini settings
# see: https://xdebug.org/docs/all_settings

xdebug_conf_max_nesting_level: 256
xdebug_conf_idekey: PHPSTORM

# The mode to run xdebug in: https://xdebug.org/docs/all_settings#mode
xdebug_conf_mode: debug

# How xdebug should be started https://xdebug.org/docs/all_settings#start_with_request
xdebug_conf_start_with_request: trigger

# Connect to the client that sent the request
xdebug_conf_discover_client_host: 0

# Connect to the specified host (overidden by discover_client_host)
# 10.0.2.2 is the default IP address virtualbox assigns to the host
xdebug_conf_client_host: 10.0.2.2
xdebug_conf_client_port: 9000

Dependencies

None.

Example Playbook

Including an example of how to use your role (for instance, with variables passed in as parameters) is always nice for users too:

- hosts: dev
  roles:
     - { role: ndench.xdebug }

License

MIT

Author Information

This role was created in 2017 by Nathan Dench.