Win7 搭建 Linux + PHP 開發環境最佳實踐：VirtualBox + Arch Linux + PHPStorm 遠程調試全流程

前言

Windows 桌面體驗好但原生 *nix 工具鏈弱；Linux 桌面工具鏈強但體驗碎片化。最佳折中：Windows 宿主機 + VirtualBox 運行輕量 Arch Linux 虛擬機，代碼在虛擬機運行調試，PHPStorm 通過 SFTP 自動同步、Xdebug 遠程調試。

一、Arch Linux 虛擬機配置

資源分配

• 內存：512 MiB（極簡）或 1-2 GiB（舒適）
• CPU：1-2 核
• 網絡：**橋接模式**，路由器綁定 MAC 固定 IP（如 192.168.0.105），宿主機 192.168.0.100

核心軟件包

pacman -S openssh nginx mariadb php php-fpm xdebug vim
# 可選：mongodb php-mongo phpmyadmin

用戶與權限

useradd -m -G wheel -s /bin/bash devuser
passwd devuser
# PHP-FPM 以開發用戶運行，避免權限問題
# /etc/php/php-fpm.d/www.conf
user = devuser
group = devuser

Nginx 通配域名配置（一勞永逸）

# /etc/nginx/nginx.conf http 段
server {
    listen 80;
    server_name ~^(?<dir>.*)\.dev\.local$;  # 泛域名匹配
    root /home/devuser/$dir;
    index index.php index.html;
    autoindex on;

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/run/php-fpm/php-fpm.sock;
        fastcgi_index index.php;
        include fastcgi_params;
    }
}

將 *.dev.local 解析到 192.168.0.105（宿主機 hosts 或路由器 DNS）。新項目只需在 /home/devuser/ 建目錄，無需改 Nginx 配置。

二、PHPStorm 部署與同步

1. Settings → Build, Execution, Deployment → Deployment 新增 SFTP 服務器：
   Host: 192.168.0.105、User: devuser、Auth: Key/Password、Root path: /home/devuser
2. 映射本地項目路徑 → 遠程 /home/devuser/project-name
3. 勾選 Automatic Upload (Always)：保存即同步
4. 訪問 https://project-name.dev.local 即可預覽

三、Xdebug 遠程調試配置

虛擬機 php.ini / xdebug.ini

zend_extension=xdebug.so
xdebug.mode = debug
xdebug.client_host = 192.168.0.100  ; 宿主機 IP
xdebug.client_port = 9003           ; Xdebug 3 默認端口
xdebug.idekey = PHPSTORM
xdebug.start_with_request = trigger ; 觸發模式
xdebug.log = /tmp/xdebug.log        ; 調試連接問題用

PHPStorm 設置

1. Settings → PHP → Debug：Xdebug 端口 9003、勾選 Can accept external connections
2. Settings → PHP → Servers：新增 Server，Host project-name.dev.local、Port 80、Path Mapping：本地路徑 ↔ /home/devuser/project-name
3. Run → Edit Configurations → + → PHP Remote Debug：Server 選上一步、IDE Key PHPSTORM

觸發調試

• 瀏覽器安裝 Xdebug Helper 擴展，設置 IDE Key = PHPSTORM，點擊圖標切換 Debug 模式
• 或 URL 附帶 ?XDEBUG_SESSION_START=PHPSTORM
• API 測試：Postman 添加 Header Cookie: XDEBUG_SESSION=PHPSTORM

四、推薦輔助工具

五、核心優勢總結

• 環境一致性：開發/測試/生產均為 Linux，消除「我機器上能跑」問題
• 性能隔離：PHP 進程佔用虛擬機資源，不影響宿主機遊戲/辦公
• 工具鏈完整：原生 grep、sed、awk、systemd、docker、k8s 等
• 調試體驗：PHPStorm 斷點、變量觀察、調用棧、表達式求值全功能
• 遷移零成本：虛擬機導出 .ova 即可在別台電腦還原完整環境