Skip to content
Advertisement

What’s the difference between xdebug.ini and php.ini

Recently I installed lamp and php-xdebug on an ubuntu 16.04 box. I noticed that now I have the following files

/etc/php/7.0/apache2/conf.d/20-xdebug.ini

/etc/php/7.0/cli/conf.d/20-xdebug.ini

/etc/php/7.0/mods-available/xdebug.ini

I was wandering what is the difference is between these files and settings in /etc/php/7.0/apache2/php.ini are affected by these.

Also in terms of best practice which of these files should be used?

If configurations are repeated in these files with different values which would take precedence?

For example if xdebug.remote_port = 9000 is set in /etc/php/7.0/apache2/php.ini and in /etc/php/7.0/mods-available/xdebug.ini it was set as xdebug.remote_port = 9001 which value would be selected?

Advertisement

Answer

Ubuntu is based on Debian. Debian and it’s derivatives use a somewhat unique way of managing extensions for php and apache.

Of the files you have listed:

  • /etc/php/7.0/apache2/conf.d/20-xdebug.ini is a symlink to /etc/php/7.0/mods-available/xdebug.ini

  • /etc/php/7.0/cli/conf.d/20-xdebug.ini is also a symlink to /etc/php/7.0/mods-available/xdebug.ini

  • You can edit /etc/php/7.0/mods-available/xdebug.ini directly and changes you make will affect everywhere it is enabled.

Commands phpenmod and phpdismod are available to enable or disable PHP modules. These are like a2enmod for apache, which you can read about here. For example, turn XDebug off with sudo phpdismod xdebug. Turn it back on with sudo phpenmod xdebug. Your configuration will be preserved when you flip it on and off because your changes are always preserved in mods-available, although PHP does not look in that directory for configuration. In fact, when you “disable” the module with phpdismod, it’s simply removing the symlink from the appropriate folder so that the module is not enabled in the php config.

Finally, /etc/php/7.0/apache2/php.ini is the location for system-wide config that is not a module that can be enabled or disabled.


Thus, your config changes like xdebug.remote_port = 9000 should go in /etc/php/7.0/mods-available/xdebug.ini since it’s related to XDebug. Putting it in both places is a bad idea (because of the confusion it creates), but the last one to load takes precedence. This is why many of the files in the mods-available directory have numbers in the filename – so they’ll load in the correct order.

Use the phpinfo() function to get more info about which config values were loaded and what ini files they were loaded from. For example:

$ php -r "phpinfo();"

or

$ php -r "phpinfo();" | grep xdebug
User contributions licensed under: CC BY-SA
3 People found this is helpful
Advertisement