{"id":1687,"date":"2024-09-11T17:50:02","date_gmt":"2024-09-11T14:50:02","guid":{"rendered":"https:\/\/plumrocket.com\/learn\/?p=1687"},"modified":"2024-10-10T11:05:10","modified_gmt":"2024-10-10T08:05:10","slug":"how-to-configure-xdebug-for-magento-2-application-via-phpstorm-or-vscode","status":"publish","type":"post","link":"https:\/\/plumrocket.com\/learn\/configuring-magento-2-xdebug","title":{"rendered":"How to Configure Xdebug for Magento 2 Application via PHPStorm or VSCode"},"content":{"rendered":"\n
\"How<\/figure>\n\n\n\n

Finding the cause of errors in heavy frameworks like Magento 2 can take time and effort. Tools like echo, var_dump, and debug_backtrace cannot cover or significantly limit developers’ needs. Xdebug for Magento 2 can successfully address this challenge for developers.<\/p>\n\n\n\n

Xdebug is a powerful PHP extension designed specifically to help developers<\/a> in debugging. It has a wide range of features that streamline the error-finding process and offer valuable insights. Installing this application can sometimes be tricky, so we prepared a step-by-step tutorial on configuring Xdebug for Magento 2 application via PHPStorm or VSCode.<\/p>\n\n\n\n

Using Xdebug for Magento 2<\/h2>\n\n\n\n

Step debugging is a tool that allows you to execute code line by line while monitoring the values of variables and objects. You can also keep track of which specific function is used after a specific line of code is executed, analyze the program execution flow, and much more.<\/p>\n\n\n\n

For a step debbugging in php exists an Xdebug extension. It has many features, but the most valuable are step debugging and breakpoints (you can set breakpoints to pause execution at specific points in your code). These and other features are very useful when debugging code and can cover a wide range of developer needs.<\/p>\n\n\n\n

How to Configure Xdebug for Magento 2<\/h2>\n\n\n\n

The installation of Xdebug may differ slightly depending on the server’s operating system. In this tutorial, code examples are written for the Ubuntu operating system.<\/p>\n\n\n\n

Step #1. Install Xdebug<\/h3>\n\n\n\n

To install Xdebug, run the following command:<\/p>\n\n\n\n

<\/div>
sudo apt install php8.3-xdebug<\/code><\/pre><\/div>\n\n\n\n
If you receive the error Unable to locate package php8.3-xdebug<\/em>, before installing the package you need to add a repository containing the following command:<\/p>\n\n\n\n
<\/div>
sudo add-apt-repository ppa:ondrej\/php\nsudo apt update\n<\/code><\/pre><\/div>\n\n\n\n
Now, after checking the PHP version, you can see that the Xdebug extension has been installed:<\/p>\n\n\n\n
\"How<\/figure>\n\n\n\n
Step #2. Configure Xdebug<\/h3>\n\n\n\n
To have Magento 2 Xdebug work correctly, you need to make a number of settings, which are specified in the php.ini<\/code> file. Execute the following command to find the path to the file:<\/p>\n\n\n\n
<\/div>
php8.3 \u2013ini<\/code><\/pre><\/div>\n\n\n\n
\"How<\/figure>\n\n\n\n
The following configurations must be added to the end of the php.ini<\/code> file:<\/p>\n\n\n\n
<\/div>
xdebug.mode=debug\nxdebug.trigger_value=runcode\n<\/code><\/pre><\/div>\n\n\n\n
Step #3. Install Browser Extension to Trigger Xdebug<\/h3>\n\n\n\n
There are two ways of testing Magento 2 using Xdebug: via VSCode or PHPStorm. Both require the installation of a browser extension to trigger Xdebug. These extensions add cookies to HTTP requests that trigger Xdebug and initiate a debugging session.<\/p>\n\n\n\n
You can install these extensions, such as Xdebug helper<\/a>, through the browser store.<\/p>\n\n\n\n
\"How<\/figure>\n\n\n\n
In the extension configurations, you need to specify the idekey<\/code>, which will match the value xdebug.trigger_value<\/code>.<\/p>\n\n\n\n
<\/p>\n\n\n\n
\"How<\/figure>\n\n\n\n
Step #4. Start Magento 2 Xdebug Testing (VSCode and PhpStorm Explained)<\/h3>\n\n\n\n
Once you have installed and configured Xdebug and set up a browser extension to trigger it, you’re ready to begin testing Magento 2 in either VSCode or PhpStorm. Below, we offer a detailed step-by-step guide to help you through the process.<\/p>\n\n\n\n
Testing Magento 2 with Xdebug in VsCode<\/h4>\n\n\n\n
\n
Step-by-step guide:<\/p>\n\n\n\n
  1. Install an extension that allows PHP code debugging. You may use PHP DEVSENSE<\/a> or PHP Debug extensions<\/a>.<\/li>
  2. If you test Magento 2 in a local environment, you may proceed to launch the debugging process in VSCode. Click Run > Start Debugging (or F5 shortcut) > Listen for Xdebug.<\/li>
  3. Add a breakpoint on any line that requires debugging. Place the cursor on the left area from the code line number to trigger the red dot (circle) and click on it.<\/li><\/ol>\n<\/div><\/div>\n\n\n\n
    \"Testing<\/figure>\n\n\n\n
    <\/p>\n\n\n\n
    Testing Magento 2 with Xdebug in PhpStorm<\/h4>\n\n\n\n
    \n
    Step-by-step guide:<\/p>\n\n\n\n
    1. Click Run > Start Listening for PHP Debug Connections.<\/li>
    2. Set the breakpoint on a line that requires debugging. To do so, navigate the cursor to the line number and click the red dot.<\/li>
    3. After the first debug launch, PhpStorm will offer to automatically add the server and map the local environment and server files.  If the development is carried out in a local environment, it\u2019s enough to click Accept.<\/li><\/ol>\n\n\n\n
      <\/p>\n<\/div><\/div>\n\n\n\n
      \"Testing<\/figure>\n\n\n\n
      \n
      1. After the connection is accepted, the debugging session will start.<\/li><\/ol>\n<\/div><\/div>\n\n\n\n
        \"Testing<\/figure>\n\n\n\n
        We hope you found this article useful. If you have any difficulties, we are happy to help you with our\u00a0Magento development services<\/a>. Please comment and share. Thanks for reading!<\/p>\n","protected":false},"excerpt":{"rendered":"
        Xdebug is a powerful PHP extension designed specifically to help developers in debugging. It has a wide range of features that streamline the error-finding process and offer valuable insights. Installing this application can sometimes be tricky, so we prepared a step-by-step tutorial on configuring Xdebug for Magento 2 application via PHPStorm or VSCode.<\/p>\n","protected":false},"author":11,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_mi_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0},"categories":[144,163],"tags":[],"yoast_head":"\nHow to configure Magento 2 Xdebug via PHPStorm & VSCode<\/title>\n<meta name=\"description\" content=\"A step-by-step guide on configuring Xdebug for Magento 2 via PHPStorm or VSCode. Debug complex projects for efficient work.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/plumrocket.com\/learn\/configuring-magento-2-xdebug\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How to configure Magento 2 Xdebug via PHPStorm & VSCode\" \/>\n<meta property=\"og:description\" content=\"A step-by-step guide on configuring Xdebug for Magento 2 via PHPStorm or VSCode. Debug complex projects for efficient work.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/plumrocket.com\/learn\/configuring-magento-2-xdebug\" \/>\n<meta property=\"og:site_name\" content=\"Magento Tutorials for Beginners & Professionals\" \/>\n<meta property=\"article:published_time\" content=\"2024-09-11T14:50:02+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2024-10-10T08:05:10+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/plumrocket.com\/learn\/wp-content\/uploads\/2024\/09\/magento-xdebug-configuration.png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"5 minutes\" \/>\n<!-- \/ Yoast SEO plugin. -->","_links":{"self":[{"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/posts\/1687"}],"collection":[{"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/users\/11"}],"replies":[{"embeddable":true,"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/comments?post=1687"}],"version-history":[{"count":15,"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/posts\/1687\/revisions"}],"predecessor-version":[{"id":1940,"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/posts\/1687\/revisions\/1940"}],"wp:attachment":[{"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/media?parent=1687"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/categories?post=1687"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/tags?post=1687"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}