本文共 3224 字，大约阅读时间需要 10 分钟。

使用 Vagrant 安装 Laravel Homestead 开发环境

即使你没有太多虚拟化工具的使用经验，安装 Vagrant 和 Laravel Homestead 也非常简单。以下是从安装到配置的完整指南。

1. 安装必备工具

在安装 Laravel Homestead 之前，你需要先安装一些必要的工具。

安装 Vagrant

Vagrant 是一个围绕虚拟化环境的框架，支持多种虚拟化平台。在这里，我们使用 VirtualBox。

vagrant-box add https://github.com/laravel/homestead-boxes/virtualbox.boxvagrant-box rename homestead-box

注意：由于国内网络限制，建议使用.box 文件的镜像版本。你可以从 官方资源页面 下载。

安装 Git

在过程中，我们会用到 Git 百[section]些操作。

git config --global user.name yourusernamegit config --global user.email your.email@example.comssh-keygen -t rsa

2. 添加 Homestead Box

在本地添加预先下载好的 Homestead Box。

vagrant-box add laravel/homestead ./homestead-box

3. 克隆并初始化 Homestead

进入项目目录，克隆 Homestead 仓库并进入。

cd ~git clone git@github.com:laravel/homestead.git homesteadcd homesteadgit checkout your-laravel-version  # 查看最新版本，请参考官方发布页

假设你的系统是 Ubuntu：

chmod +x init.sh./init.sh

4. 启动 Vagrant

在文件 \Homestead:vagrantfile 中，确保版本设置不低于 1.4。

vagrant up

进入新创建的虚拟机。

vagrant ssh

5. 配置 Homestead

在项目根目录中找到 Vagrantfile，定制配置文件。

# 示例增加映射目录folders:  - map: ~/code    to: /home/vagrant/code  # 如果需要更多映射  - map: ~/code/项目1    to: /home/vagrant/code/项目1  - map: ~/code/项目2    to: /home/vagrant/code/项目2

启用 NFS 支持（适用于 Linux）：

安装 Vagrant 插件 vagrant-bindfs，然后配置文件映射。

vagrant插件安装：vagrant插件 install vagrant-bindfs在 Vagrantfile 中添加：folders:  - map: ~/code    to: /home/vagrant/code    type: "nfs"# 如果需要启用 NFS（仅在 Linux 环境中）vagrant重启：vagrant重启 --provision

6. 配置站点 DNS

确保你配置了站点 DNS。

sites:  - map: homestead.com    to: /home/vagrant/代码/Laravel/公共    DNS: 192.168.10.10 homestead.com

7. 删除旧版本 Box

避免浪费资源时，使用 --force 删除旧 Box。

vagrant销毁：vagrant销毁 --force

8. Composer 引入依赖

在团队协作中，仅将 Vagrantfile 发布给队友，发执行命令：

# 安装特定版本（推荐使用 dev 版）composer 需要：-- devcomposer require laravel/homestead -- dev

9. 确定使用的数据库

在 box 配置中指定数据库类型。

mariadb: true

10. 定义 aliases

自定义工作环境_has_W ()functionalist:

alias c="clear"alias ..="cd .."# 生效命令：vagrant重新加载 virtualboxvagrant reload --provision

11. 连接 SSH

进入虚拟机：

vagrant ssh

12. 连接数据库

测试本地数据库连接：

#，默认使用 Mysqlmysql -u root -p

13. 重新加载 Vagrant 配置

修改完配置后，重新加载：

vagrant reload --provision

注意：：若添加新站点或修改 DNS，记得执行此命令。

14. 配置 Nginx 快cgi

sites:  - map: homestead.test    to: /home/vagrant/代码/Laravel/公共    params:      - key: FOO        value: BAR

15. 配置 Cron

# 配合 artisan 直接执行调度指令sites:    - map: homestead.test  to: /home/vagrant/代码/Laravel/公共  schedule: true

16. 设置端口转发 （可选）

如果需要通过网络访问项目或数据库，可以配置端口转发：

insecure_backlog: 1000  - key: FOO    value: BARsites:  - map: homestead.test    to: /home/vagrant/代码/Laravel/公共    php: "5.6"# 示例端口转发default例如： frontal代理: port:.8000 => 80 443 => 443 数据库转发： 3306 => 33060 MySQL: 33060 → 转发至 3306 PostgreSQL: 5432 → 转发至 54320 邮件： 8025 → 转发至 8025 互联网接口: http://yourdomain.com-your-NGrok-公网-IP:8000 → your project HTTPS: http://yourdomain.com-your-NGrok-公网-IP:443 → your project NGrok 地址: http://your.domain.ngrok.io# 示例命令：```bashvagrant ssh -- -L local_port:remote_host:remote_port。

17. 指定默认的 PHP 版本

在 sites 配置中强制指定 PHP 版本。

sites:  - map: homestead.test    to: /home/vagrant/代码/Laravel/公共    php: "5.6"

18. 更新 Homestead

如果需要升级到最新版本，可以执行：

vagrant box upgrade

19. 克隆代码

在项目中克隆仓库：

cd ~git clone git@github.com:yourusername/项目.git 项目名称cd 项目名称git pull origin master

或者使用 Composer 更新：

composer更新

通过以上步骤，你应该能够轻松设置好一个功能齐全的 Laravel 开发环境。你可以根据需求自行定制配置文件，享受无限可能。