Skip to content

Add Editor Integration and WSL Configuration pages - #136

Open
bidi47 wants to merge 1 commit into
alma-linux-10from
docs/add-editor-integration-wsl-config
Open

bidi47 wants to merge 1 commit into
alma-linux-10from
docs/add-editor-integration-wsl-config

Conversation

@bidi47

@bidi47 bidi47 commented Sep 24, 2026

Copy link
Copy Markdown
Member
  • The biggest content gap versus general "Linux dev box on WSL" guides was
    editor integration: nothing covered VS Code Remote-WSL, PhpStorm's WSL
    interpreter, or Xdebug (which the playbook doesn't install). Resolves WSL: Create Ansible playbook for AlmaLinux 9 #9.
  • Filesystem placement/performance, .wslconfig tuning, and backup/
    portability (wsl --export/--import) were similarly absent.
    Resolves Enhanced file structure and added AlmaLinux8 playbooks. #10, testing Almalinux 9 Ansible  #11, strange permission issue #12.
  • Adds docs/book/v2/editor-integration.md: VS Code Remote-WSL (code .),
    PhpStorm WSL interpreter setup, Xdebug install + config for both
    editors, and PHPUnit runner setup.
  • Adds docs/book/v2/wsl-configuration.md: why projects should live in
    the WSL filesystem rather than /mnt/c, opening a WSL project from
    Windows (\\wsl.localhost, explorer.exe .), .wslconfig tuning
    (memory/CPU/swap/vmIdleTimeout/mirrored networking), and
    wsl --export/--import as the non-destructive alternative to the
    already-documented --unregister.
  • Wires both into mkdocs.yml's v2 nav, between Virtualhosts and FAQ.

The biggest content gap versus general "Linux dev box on WSL" guides
was editor integration: nothing covered VS Code Remote-WSL, PhpStorm's
WSL interpreter, or Xdebug (which the playbook doesn't install).
Filesystem placement/performance, .wslconfig tuning, and backup/
portability (wsl --export/--import) were similarly absent.

- Add docs/book/v2/editor-integration.md: VS Code Remote-WSL (code .),
  PhpStorm WSL interpreter setup, Xdebug install + config for both
  editors, and PHPUnit runner setup.
- Add docs/book/v2/wsl-configuration.md: why projects should live in
  the WSL filesystem rather than /mnt/c, opening a WSL project from
  Windows (\\wsl.localhost, explorer.exe .), .wslconfig tuning
  (memory/CPU/swap/vmIdleTimeout/mirrored networking), and
  wsl --export/--import as the non-destructive alternative to the
  already-documented --unregister.
- Wire both into mkdocs.yml's v2 nav, between Virtualhosts and FAQ.
@bidi47
bidi47 requested a review from arhimede September 24, 2026 15:50

## PhpStorm (WSL interpreter)

PhpStorm can also run against the PHP interpreter inside AlmaLinux 10 directly, rather than a local Windows PHP install.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

what the line mean ?
you must install PHPStorm inside WSL or usuall inside windows ?

4. Choose `From WSL`, select the `AlmaLinux-10` distro, and point it at `/usr/bin/php`.
5. Confirm and apply.

PhpStorm can now index, run, and debug using the same PHP install the playbook provisioned, instead of a separate Windows copy.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

same question like above


PhpStorm can now index, run, and debug using the same PHP install the playbook provisioned, instead of a separate Windows copy.

> If your project files live inside the WSL filesystem (the default and recommended location - see [WSL Configuration](wsl-configuration.md)), open the project from its `\\wsl.localhost\AlmaLinux-10\...` path in PhpStorm so file watching and indexing stay fast.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

If ?
it is supposed to live inside WSL, that's the purpose of this erpository

This branch has not been deployed

No deployments
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.

WSL: Create Ansible playbook for AlmaLinux 9

2 participants