Vagrant搭建PHP环境详细教程

一分耕耘，一分收获！既然都打开这篇《Vagrant搭建PHP环境教程详解》，就坚持看下去，学下去吧！本文主要会给大家讲到等等知识点，如果大家对本文有好的建议或者看到有不足之处，非常欢迎大家积极提出！在后续文章我会继续更新文章相关的内容，希望对大家都有所帮助！

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：

config.vm.provision "shell", inline:   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 才会生效。

好了，本文到此结束，带大家了解了《Vagrant搭建PHP环境详细教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！