{"id":57924,"date":"2023-08-19T17:50:06","date_gmt":"2023-08-19T12:20:06","guid":{"rendered":"https:\/\/www.tothenew.com\/blog\/?p=57924"},"modified":"2023-08-30T17:58:40","modified_gmt":"2023-08-30T12:28:40","slug":"how-to-install-xdebug-3-on-macos","status":"publish","type":"post","link":"https:\/\/www.tothenew.com\/blog\/how-to-install-xdebug-3-on-macos\/","title":{"rendered":"How to install Xdebug 3 on MacOS"},"content":{"rendered":"

Xdebug is an extension for PHP, and provides a range of features to improve the PHP development experience. It allows you to break during code execution and inspect all the variables in scope during a request.<\/em><\/span><\/p>\n

The purpose of this blog is to install Xdebug 3 on MacOS with PHP 8.1\u00a0 to debug PHP code.<\/span><\/p>\n

Let\u2019s start installing Xdebug 3 on MacOs:<\/span><\/h2>\n

Step 1:<\/b> First check whether PHP 8.1 is installed or not; if not, run the below command:<\/span><\/p>\n

brew install php@8.1<\/b><\/pre>\n
Step 2: <\/b>To Install Xdebug, run the below command:<\/span><\/p>\n
pecl install xdebug<\/b>\u00a0<\/span><\/pre>\n
If found\u00a0 warning like <\/span>\u00a0<\/b>PHP Warning:\u00a0 mkdir(): File exists in \/opt\/homebrew\/Cellar\/php\/8.1.8\/share\/php\/pear\/System.php on line 294<\/b><\/p>\n
First, create pecl directory by using the command: <\/span>mkdir \/opt\/homebrew\/lib\/php\/pecl<\/b><\/p>\n
Then again, run the command:<\/span><\/p>\n
pecl install xdebug<\/b>\u00a0<\/span><\/pre>\n
After running the above command, you will see the below output:<\/span><\/p>\n
running: find \"\/private\/tmp\/pear\/temp\/pear-build-rootO1x6b4\/install-xdebug-3.2.2\" | xargs ls -dils\r\n15982931 0 drwxr-xr-x 3 root wheel 96 Aug 9 11:25 \/private\/tmp\/pear\/temp\/pear-build-rootO1x6b4\/install-xdebug-3.2.2\r\n15983635 0 drwxr-xr-x 3 root wheel 96 Aug 9 11:25 \/private\/tmp\/pear\/temp\/pear-build-rootO1x6b4\/install-xdebug-3.2.2\/opt\r\n15983636 0 drwxr-xr-x 3 root wheel 96 Aug 9 11:25 \/private\/tmp\/pear\/temp\/pear-build-rootO1x6b4\/install-xdebug-3.2.2\/opt\/homebrew\r\n15983637 0 drwxr-xr-x 3 root wheel 96 Aug 9 11:25 \/private\/tmp\/pear\/temp\/pear-build-rootO1x6b4\/install-xdebug-3.2.2\/opt\/homebrew\/Cellar\r\n15983638 0 drwxr-xr-x 3 root wheel 96 Aug 9 11:25 \/private\/tmp\/pear\/temp\/pear-build-rootO1x6b4\/install-xdebug-3.2.2\/opt\/homebrew\/Cellar\/php\r\n15983639 0 drwxr-xr-x 3 root wheel 96 Aug 9 11:25 \/private\/tmp\/pear\/temp\/pear-build-rootO1x6b4\/install-xdebug-3.2.2\/opt\/homebrew\/Cellar\/php\/8.1.12\r\n15983640 0 drwxr-xr-x 3 root wheel 96 Aug 9 11:25 \/private\/tmp\/pear\/temp\/pear-build-rootO1x6b4\/install-xdebug-3.2.2\/opt\/homebrew\/Cellar\/php\/8.1.12\/pecl\r\n15983641 0 drwxr-xr-x 3 root wheel 96 Aug 9 11:25 \/private\/tmp\/pear\/temp\/pear-build-rootO1x6b4\/install-xdebug-3.2.2\/opt\/homebrew\/Cellar\/php\/8.1.12\/pecl\/20210902\r\n15983642 776 -rwxr-xr-x 1 root wheel 394950 Aug 9 11:25 \/private\/tmp\/pear\/temp\/pear-build-rootO1x6b4\/install-xdebug-3.2.2\/opt\/homebrew\/Cellar\/php\/8.1.12\/pecl\/20210902\/xdebug.so\r\n\r\nBuild process completed successfully\r\nInstalling '\/opt\/homebrew\/Cellar\/php\/8.1.12\/pecl\/20210902\/xdebug.so'\r\ninstall ok: channel:\/\/pecl.php.net\/xdebug-3.2.2\r\nExtension xdebug enabled in php.ini<\/pre>\n
Step 3: <\/b>After installing Xdebug<\/span>,<\/b> you must enable this extension in your php.ini file. To enable it, locate the php.ini file location and\u00a0 open php.ini file<\/span><\/p>\n
sudo nano \/opt\/homebrew\/etc\/php\/8.1\/php.ini<\/b><\/pre>\n
Paste these lines in php.ini file:\u00a0<\/span><\/p>\n
zend_extension=\"xdebug.so\"<\/span>\r\n\r\nxdebug.mode=debug<\/span>\r\n\r\nxdebug.start_with_request=yes\r\n\r\n<\/span><\/pre>\n
Run <\/span>sudo apachectl restart<\/b> command to restart service.<\/span><\/p>\n
Step 4: <\/b>Now run <\/span>php -v <\/b>command to check Xdebug is installed or not:<\/span><\/p>\n
yogendrapratapsingh@Yogendras-MacBook-Pro ~ % php -v\r\nPHP 8.1.12 (cli) (built: Oct 30 2022 12:39:49) (NTS)\r\nCopyright (c) The PHP Group\r\nZend Engine v4.1.12, Copyright (c) Zend Technologies\r\nwith Xdebug v3.2.2, Copyright (c) 2002-2023, by Derick Rethans\r\nwith Zend OPcache v8.1.12, Copyright (c), by Zend Technologies\r\n\r\n<\/pre>\n
If found any warning like:<\/span><\/p>\n
PHP Warning:\u00a0 Failed loading Zend extension 'xdebug.so' (tried: \/opt\/homebrew\/lib\/php\/pecl\/20210902\/xdebug.so (dlopen(\/opt\/homebrew\/lib\/php\/pecl\/20210902\/xdebug.so, 0x0009): tried: '\/opt\/homebrew\/lib\/php\/pecl\/20210902\/xdebug.so' (no such file)), \/opt\/homebrew\/lib\/php\/pecl\/20210902\/xdebug.so.so (dlopen(\/opt\/homebrew\/lib\/php\/pecl\/20210902\/xdebug.so.so, 0x0009): tried: '\/opt\/homebrew\/lib\/php\/pecl\/20210902\/xdebug.so.so' (no such file))) in Unknown on line 0<\/span>\r\n\r\nWarning: Failed loading Zend extension 'xdebug.so' (tried: \/opt\/homebrew\/lib\/php\/pecl\/20210902\/xdebug.so (dlopen(\/opt\/homebrew\/lib\/php\/pecl\/20210902\/xdebug.so, 0x0009): tried: '\/opt\/homebrew\/lib\/php\/pecl\/20210902\/xdebug.so' (no such file)), \/opt\/homebrew\/lib\/php\/pecl\/20210902\/xdebug.so.so (dlopen(\/opt\/homebrew\/lib\/php\/pecl\/20210902\/xdebug.so.so, 0x0009): tried: '\/opt\/homebrew\/lib\/php\/pecl\/20210902\/xdebug.so.so' (no such file))) in Unknown on line 0<\/span>\r\n\r\nPHP 8.1.12 (cli) (built: Oct 30 2022 12:39:49) (NTS)<\/span>\r\n\r\nCopyright (c) The PHP Group<\/span>\r\n\r\nZend Engine v4.1.12, Copyright (c) Zend Technologies<\/span>\r\n\r\n\u00a0\u00a0\u00a0\u00a0with Zend OPcache v8.1.12, Copyright (c), by Zend Technologies<\/span><\/pre>\n
Then update zend_extension=”xdebug.so” to zend_extension=”\/opt\/homebrew\/Cellar\/php\/8.1.12\/pecl\/20210902\/xdebug.so\u201d<\/b> in php.ini file. Here updated value will be the same as in Step 2. <\/span><\/p>\n
Conclusion<\/b><\/h2>\n
Finally, <\/span>you\u2019ve successfully installed Xdebug on <\/span>PHP 8.1.<\/span>With Xdebug, you can now debug PHP applications with ease.\u00a0<\/span><\/p>\n
Let us know in case of any issues during the installation process, and please feel free to reach out via comments.<\/span><\/p>\n
<\/div>","protected":false},"excerpt":{"rendered":"
Xdebug is an extension for PHP, and provides a range of features to improve the PHP development experience. It allows you to break during code execution and inspect all the variables in scope during a request. The purpose of this blog is to install Xdebug 3 on MacOS with PHP 8.1\u00a0 to debug PHP code. […]<\/p>\n","protected":false},"author":1599,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"iawp_total_views":371},"categories":[3602,1816],"tags":[5324,1701],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts\/57924"}],"collection":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/users\/1599"}],"replies":[{"embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/comments?post=57924"}],"version-history":[{"count":3,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts\/57924\/revisions"}],"predecessor-version":[{"id":58210,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts\/57924\/revisions\/58210"}],"wp:attachment":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/media?parent=57924"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/categories?post=57924"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/tags?post=57924"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}