当前位置：首页 > 文章列表 > 文章 > php教程 > Vagrant搭建PHP环境详细教程

Vagrant搭建PHP环境详细教程

2026-01-16 09:00:42 0浏览收藏

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

Vagrant 搭建 PHP 开发环境的核心是通过 Vagrantfile 定义可复现的 Linux 虚拟机（如 ubuntu/jammy64），再用 Shell 或 Ansible 自动安装 PHP、Nginx/Apache 和 MySQL/SQLite，而非直接安装 PHP 环境。

如何用vagrant安装php环境_vagrant搭建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 页面。