Skip to content

ABN-298: Dev tooling — FRP proxy, Xdebug, debug mode, README#80

Merged
dgjlindsay merged 1 commit intomainfrom
doug/ABN-298-dev-tooling
Apr 13, 2026
Merged

ABN-298: Dev tooling — FRP proxy, Xdebug, debug mode, README#80
dgjlindsay merged 1 commit intomainfrom
doug/ABN-298-dev-tooling

Conversation

@dgjlindsay
Copy link
Copy Markdown
Contributor

Summary

Development environment improvements for the Magento plugin.

  • FRP reverse proxy: frpc.toml + start-proxy.sh with GCP Secret Manager fallback. Patches PHP router to trust X-Forwarded-Host for HTTPS detection and auto-sets Magento base URLs via custom-entrypoint.sh (survives container restarts)
  • Xdebug: Installed automatically (mode=off, no perf impact). make debug activates it + disables caches for hot reload
  • Makefile: New targets (run, debug, stop, proxy), auto-detect staging/sandbox from gcloud account, custom port support
  • README: Full rewrite documenting dev workflow, debugging, proxy, and tests

Test plan

  • make install completes with Xdebug installed
  • make run starts proxy and prints URLs
  • make debug activates Xdebug, breakpoints work in VSCode
  • Proxy URL serves Magento over HTTPS without redirect loops
  • make stop cleans up proxy and resets base URLs

🤖 Generated with Claude Code

Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request significantly enhances the development environment by introducing Xdebug support, an FRP reverse proxy for HTTPS callbacks, and a comprehensive README update. Key improvements include dynamic environment detection in the Makefile and new scripts for container patching. Feedback focuses on improving error visibility during proxy startup, resolving potential file permission issues in logs, refining Xdebug configuration cleanup to be version-specific, addressing security concerns regarding HTTPS detection headers, and ensuring consistency by using standard Magento CLI commands instead of third-party tools in generated scripts.

Comment thread Makefile Outdated
Comment thread Makefile Outdated
Comment thread dev/install-xdebug Outdated
Comment thread dev/patch-proxy
Comment thread dev/patch-proxy Outdated
Copy link
Copy Markdown

@claude claude Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No critical issues found. Dev tooling only — no application or Magento module code changed.

…rite

- Add FRP reverse proxy (frpc.toml + start-proxy.sh) with GCP Secret
  Manager fallback for auth token
- Patch container's PHP router to trust X-Forwarded-Host for HTTPS
  detection (FRP terminates TLS but sends X-Forwarded-Proto: http)
- Auto-set Magento base URLs to proxy domain via custom-entrypoint.sh
  (survives container restarts, entrypoint base URL resets)
- Install Xdebug automatically (mode=off) during make install
- Add make debug target: activates Xdebug + disables all caches for
  hot reload
- make run/stop now manage the FRP proxy lifecycle and print URLs
- Auto-detect staging/sandbox environment from gcloud account
- Support custom port via make install PORT=<n>
- Rewrite README: document full dev workflow including debugging,
  proxy, and tests

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@dgjlindsay dgjlindsay force-pushed the doug/ABN-298-dev-tooling branch from 97044f4 to f8b395c Compare April 13, 2026 13:44
@dgjlindsay dgjlindsay merged commit 266eab8 into main Apr 13, 2026
18 checks passed
@dgjlindsay dgjlindsay deleted the doug/ABN-298-dev-tooling branch April 13, 2026 15:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants