Fix Xdebug-PhpStorm MageBox Setup

I need Xdebug breakpoints firing reliably in PhpStorm on my Apple-Silicon Mac. The code runs inside MageBox, so the container, php.ini, and PhpStorm all have to agree on ports, IDE keys, and paths.

Right now the debugger never connects, which suggests a configuration tangle somewhere between:
• php.ini (xdebug.mode, xdebug.client_host, xdebug.client_port)
• PhpStorm (Servers, path mappings, debug port)
• MageBox’s own overrides and exposed ports

Deliverable
– Clean, documented config files and IDE settings that let me hit a breakpoint in a sample Magento route from the first page load—no manual port fiddling.

Acceptance test
1. I start MageBox with your settings on my Mac.
2. I open the project in PhpStorm.
3. A breakpoint in index.php and at least one other file that I need, stops execution, variables are inspectable.
4. Xdebug works with at least one other project in the above configuration, so I know it's a reliable fix.

Please keep notes on any changes so I can reapply them after updates.