Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

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?

like image 346
natral Avatar asked Nov 07 '17 19:11

natral


People also ask

What is Xdebug used for?

Xdebug uses the DBGp debugging protocol and gives debugging and profiling capabilities. It allows us to add breakpoints and stop the code execution at every breakpoint to see variables output in only one code iteration. So Xdebug lets you save your time, which is otherwise lost in code debugging.

Does xampp come with Xdebug?

Xdebug is a powerful open source debugger and profiler for PHP. It is included with XAMPP and can be used to display stack traces, analyze code coverage and profile your PHP code. Restart the Apache server using the XAMPP control panel.

What is Xdebug port?

Port 9003 is the default for both Xdebug and the Command Line Debug Client.


1 Answers

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
like image 52
mkasberg Avatar answered Sep 22 '22 17:09

mkasberg