Vagrant 搭建 PHP 开发环境的核心是通过 Vagrantfile 定义可复现的 Linux 虚拟机（如 ubuntu/jammy64），再用 Shell 或 Ansible 自动安装 PHP、Nginx/Apache 和 MySQL/SQLite，而非直接安装 PHP 环境。
用 Vagrant 搭建 PHP 开发环境，核心是通过配置文件定义一个可复现的 Linux 虚拟机（如 Ubuntu），再在其中安装 PHP、Web 服务器（Nginx/Apache）和数据库（MySQL/SQLite）。它不直接“安装 PHP 环境”，而是自动化部署整套环境。关键在于写对 Vagrantfile，并合理选择或定制 Box。
选对 Box 并初始化项目
Box 是 Vagrant 的基础镜像，推荐使用官方或社区维护的轻量、更新及时的镜像：
- ubuntu/jammy64（Ubuntu 22.04 LTS）：PHP 8.1 默认已预装，适合新项目
- hashicorp/bionic64（Ubuntu 18.04）：PHP 7.2/7.4 兼容性好，适合老项目
- 避免使用年久失修或无人维护的第三方 Box，容易出现依赖冲突或安全问题
执行以下命令初始化：
vagrant init ubuntu/jammy64
vagrant up
用 Shell 或 Ansible 自动装 PHP 和扩展
Vagrant 支持 provisioner（供应器）自动执行安装任务。最简单的是内置的 Shell provisioner：
立即学习“PHP免费学习笔记（深入）”；
config.vm.provision "shell", inline: <<-SHELL
apt-get update
apt-get install -y php8.1-cli php8.1-mysql php8.1-curl php8.1-xml php8.1-mbstring
php -v
SHELL
如果需要更稳定、可复用的配置，建议用 Ansible（需本地安装 Ansible）：
- 新建
playbook.yml，用community.general.php_packages模块统一管理 PHP 版本与扩展 - 在
Vagrantfile中启用：config.vm.provision "ansible", playbook: "playbook.yml"
挂载代码目录并配置 Web 服务
开发时代码通常放在宿主机，需同步到虚拟机：
config.vm.synced_folder "./www", "/var/www/html", owner: "www-data", group: "www-data"
然后安装 Nginx 并启用 PHP-FPM：
apt-get install -y nginx php8.1-fpm- 修改
/etc/nginx/sites-available/default，确保location ~ \.php$指向unix:/run/php/php8.1-fpm.sock - 重启服务：
systemctl restart nginx php8.1-fpm
完成后访问 http://192.168.33.10（Vagrant 默认私有网络 IP），即可看到 PHP 页面。
常用调试与维护技巧
日常开发中几个实用操作：
- 进入虚拟机：
vagrant ssh；退出后用exit - 重跑 provisioner（重新装环境）：
vagrant provision - 暂停/恢复虚拟机：
vagrant suspend/vagrant resume - 彻底重装（清空状态）：
vagrant destroy && vagrant up - 查看 PHP 配置：
vagrant ssh -c "php --ini"
不复杂但容易忽略：每次改完 Vagrantfile 或 provision 脚本，记得运行 vagrant reload --provision 才会生效。
