Vagrant默认启动的ubuntu/jammy64盒子不含PHP 8.0等开发组件，仅提供最小化Ubuntu系统；php -v报错因未预装PHP，需通过provision脚本安装或改用Laravel Homestead等预配box。
直接用 vagrant init ubuntu/jammy64 启动的默认盒子不带 PHP 8.0，也不含 Nginx、MySQL 或 xdebug——它只是个干净的 Ubuntu 系统。想开箱即用跑 PHP 8.0，必须手动装环境或换预配好的 box。
为什么 vagrant up 后 php -v 还是报 command not found
因为 Vagrant 默认启动的是最小化系统镜像（如 ubuntu/jammy64），没预装任何 PHP。你看到的“虚拟机起来了”，只是 Linux 内核和基础 shell 跑通了，不是开发环境就绪了。
- 别指望
vagrant up自动装 PHP：Vagrant 只管启停虚拟机，软件安装得靠provision脚本或你自己 SSH 进去装 - 最省事的做法是换 box：比如用 Laravel Homestead（内置 PHP 8.0+、Nginx、MySQL、Redis、xdebug），执行
vagrant box add laravel/homestead再vagrant init laravel/homestead - 如果坚持用官方 Ubuntu box，必须在
Vagrantfile里加 provision 块，例如用 shell 脚本执行apt update && apt install -y php8.0-cli php8.0-fpm php8.0-mysql - 注意 PHP 8.0 在 Ubuntu 22.04（jammy）源里是默认版本，但 Ubuntu 20.04（focal）默认只有 PHP 7.4；选 box 前先查清楚 base OS 版本
PHP 解释器路径填 /usr/bin/php 还是 /usr/sbin/php-fpm？
填 /usr/bin/php。PhpStorm 的 CLI Interpreter 需要的是可执行的 PHP 二进制文件，不是 FPM 进程管理器。
-
/usr/sbin/php-fpm是守护进程，不能直接执行脚本；/usr/bin/php才是 CLI 模式入口 - 运行
vagrant ssh -c "which php"确认真实路径，常见位置还有/usr/local/bin/php（源码编译安装时） - 如果装了多个 PHP 版本（如 php7.4 和 php8.0），用
update-alternatives --config php切换默认，再查which php - 别填
php（无路径），Shell alias 或 PATH 查找在 PhpStorm 远程解释器上下文中不生效
xdebug 3 断点不触发？重点检查 client_host 和 start_with_request
不是 PhpStorm 没监听，而是请求根本没发到你的机器。xdebug 3 默认不自动连接，必须显式开启且指定目标 IP。
PHP 8.5.12 RC 1
下载
PHP 8.5.12 RC 1 候选版修复 BZ2、DOM、PDO、Opcache/JIT 和扩展内存安全问题，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
立即学习“PHP免费学习笔记（深入）”；
- 在 Vagrant 虚拟机的
php.ini中确认这三行都存在且未被注释： xdebug.mode = debug-
xdebug.client_host = 10.0.2.2（VirtualBox 默认网关，宿主机侧 IP） -
xdebug.start_with_request = yes（否则只靠 XDEBUG_SESSION_START 触发，容易漏） - 不要用
xdebug.remote_*配置项（xdebug 2 遗留写法，已废弃） - 改完配置后必须
vagrant reload --provision或手动sudo systemctl restart php8.0-fpm
共享文件夹同步慢或文件不更新？别用默认 vboxsf
VirtualBox 自带的 vboxsf 共享机制在大项目（尤其 node_modules）下 I/O 极差，保存一个 PHP 文件延迟 1–2 秒很常见。
- 改用 rsync：在
Vagrantfile中设config.vm.synced_folder ".", "/vagrant", type: "rsync", rsync__args: ["--verbose", "--archive", "--delete", "-z"] - 启用自动同步：加
rsync__auto: true，这样宿主机文件变化会自动推送到虚拟机（注意别让 IDE 自动保存时触发冲突） - 如果用 NFS（macOS/Linux），需宿主机装
nfs-client，且Vagrantfile中明确写type: "nfs"；Windows 不原生支持 NFS，别试 - rsync 是单向同步（宿主 → 虚拟机），所以编辑必须在宿主机进行；不要在
vagrant ssh里改 /vagrant 下的文件，改了也不会反向同步回来
最容易被忽略的一点：Vagrant 的网络端口映射和 PhpStorm 的调试监听是两套独立机制。即使 80 端口能访问网站，不代表 9003（xdebug 默认端口）已映射或防火墙放行——务必检查 vagrant ssh-config 输出的端口，再确认 VirtualBox 设置里是否勾选了端口转发规则。
