Skip to content

Instantly share code, notes, and snippets.

@joseluisq

joseluisq/xdebug_installation.md

Last active June 1, 2025 16:31
Show Gist options
  • Save joseluisq/d7586c9e5bd52012e0cf to your computer and use it in GitHub Desktop.
Save joseluisq/d7586c9e5bd52012e0cf to your computer and use it in GitHub Desktop.
Download ZIP
Install PHP Xdebug on Fedora / CentOS x64
Raw
xdebug_installation.md

PHP Xdebug installation on Fedora/CentOS x64

First, install xdebug package on system:

$ sudo yum install php-pecl-xdebug.x86_64

Or with DNF:

$ sudo dnf install php-xdebug

If your have an Nginx server, we should restart the PHP processor php-fpm:

$ sudo systemctl restart php-fpm

Or if you have a Apache server, we should restart the httpd server:

$ sudo systemctl restart httpd

Finally, verify if xdebug extension is loaded:

php -r "echo (extension_loaded('xdebug') ? 'xdebug up and running!' : 'xdebug is not loaded!');"

// xdebug up and running!⏎
@talenta-eg
Copy link

Thanks

@josephx86
Copy link

Thanks for the gist.

I have been trying to get xdebug working correctly in Eclipse Mars 2 (4.5.2) on Fedora 23. I got it working correctly after setting the xdebug.remote_enable option.

I have the revision at https://gist.github.com/josephx86/85c1413b25ee257e0543032aadfec7fc/revisions

@Canavell
Copy link

thank you

@rahilwazir
Copy link

You don't need to add the line to /etc/php.ini as the PHP loads it anyway.

@nickmendoza
Copy link

Thanks in 2017.

@joseluisq
Copy link
Author

@rahilwazir It's true. Now is not necessary to add this line to php.ini. Updated!

@Verakhs
Copy link

Verakhs commented Nov 7, 2017 •
edited
Loading

I would like to know whether upgrading to a new version will mess up with my old apps? recently I start getting such errors as follows:

/etc/cron.daily/0yum.cron:
Error: Package: php-pecl-xdebug-2.1.4-2.el6.x86_64 (epel)
Requires: php-common >= 5.3.3-38
Installed: php-common-5.3.3-27.el6_5.1.x86_64 (@sl-security)
php-common = 5.3.3-27.el6_5.1
Available: php-common-5.3.3-26.el6.x86_64 (sl)
php-common = 5.3.3-26.el6
Available: php-common-5.3.3-27.el6_5.x86_64 (sl-security)
php-common = 5.3.3-27.el6_5
/etc/cron.daily/cleanscratch:

Cleaning /srv/scratch space
/etc/cron.daily/freshclam:

/etc/cron.daily/freshclam: line 15: /usr/bin/freshclam: No such file or directory

@killrazor
Copy link

killrazor commented Apr 3, 2018 •
edited
Loading

@Verakhs There are some deprecated functions. You should check it out before upgrading. Or...if it isn't critical, just upgrade and watch for errors.

@djwave28
Copy link

Ran into a minor issue with the last command to verify if xdebug is running on fedora 27. Apparently the double and single quotes are inverse. ran it successful with :

php -r 'echo (extension_loaded("xdebug") ? "xdebug up and running!" : "xdebug is not loaded!");'

@treii28
Copy link

treii28 commented Jan 22, 2019

ok, and if it's installed and not loaded on centos, then what?

@skyvondave
Copy link

-bash: !': event not found

@skyvondave
Copy link

I had to run:

php -r 'echo (extension_loaded("xdebug") ? "xdebug up and running!" : "xdebug is not loaded!");'

@derdek
Copy link

derdek commented Sep 1, 2020

I had to run:

php -r 'echo (extension_loaded("xdebug") ? "xdebug up and running!" : "xdebug is not loaded!");'

remove ! from command, because terminal try load history by !

php -r "echo (extension_loaded('xdebug') ? 'xdebug up and running' : 'xdebug is not loaded');"

@dwickeroth
Copy link

In my case xdebug worked when using the php command line interpreter, but not when using apache. The line 'sudo systemctl restart php-fpm' saved me there.
Thanx!

@simonhammes
Copy link

php-pecl-xdebug3 on Fedora 42 :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment