当前位置：首页 > 文章列表 > 文章 > php教程 > Homestead搭建Laravel项目教程详解

Homestead搭建Laravel项目教程详解

2025-07-29 15:21:28 0浏览收藏

想要快速搭建 Laravel 开发环境？本教程将手把手教你使用 Homestead，Laravel 官方提供的 Vagrant Box，告别繁琐的本地环境配置。通过详细讲解 Homestead.yaml 文件的配置，包括虚拟机 IP 地址、共享文件夹、站点域名和数据库设置，让你轻松掌握 Homestead 的核心。文章还涵盖了启动虚拟机、使用 Composer 创建 Laravel 项目、配置 hosts 文件等关键步骤，确保你能够成功搭建起一个可用的 Laravel 开发环境。无论是新手还是经验丰富的开发者，都能通过本教程快速上手 Homestead，提升 Laravel 项目的开发效率。立即开始你的 Laravel Homestead 之旅吧！

使用 Homestead 创建新的 Laravel 项目教程

本文档旨在指导开发者如何使用 Homestead 搭建 Laravel 开发环境并创建新的 Laravel 项目。通过配置 Homestead.yaml 文件、启动虚拟机、使用 Composer 创建项目以及配置 hosts 文件，开发者可以快速搭建起一个可用的 Laravel 开发环境。

Homestead 环境配置

Homestead 是 Laravel 官方提供的 Vagrant Box，用于简化 Laravel 开发环境的搭建。以下步骤将指导你如何配置 Homestead 并创建一个新的 Laravel 项目。

1. 修改 Homestead.yaml 文件

Homestead 的核心配置文件是 Homestead.yaml。该文件定义了虚拟机 IP 地址、共享文件夹、站点配置和数据库配置等信息。找到你的 Homestead 目录，通常位于用户根目录下，编辑 Homestead.yaml 文件。

---
ip: "192.168.10.10"
memory: 2048
cpus: 1
provider: virtualbox
authorize: ~/.ssh/id_rsa.pub
keys:
- ~/.ssh/id_rsa

folders:
- map: ~/Code  # 本地代码目录，例如：D:/Code
  to: /home/vagrant/Code # 虚拟机中的代码目录

sites:
- map: homestead.test # 站点域名
  to: /home/vagrant/Code/Laravel/public # 站点根目录
- map: mylaravelapp.dev # 新建 Laravel 项目的域名
  to: /home/vagrant/Code/mylaravelapp/public # 新建 Laravel 项目的根目录

databases:
- homestead
- mylaravelapp # 新建 Laravel 项目的数据库名

注意：

folders 部分定义了本地目录和虚拟机目录的映射关系。将 ~/Code 替换为你本地存放代码的目录，例如 D:/Code。
sites 部分定义了站点域名和对应的虚拟机目录。homestead.test 是一个示例，你可以根据需要修改。mylaravelapp.dev 是我们将要创建的 Laravel 项目的域名。
databases 部分定义了数据库。mylaravelapp 是我们将要创建的 Laravel 项目的数据库名。

2. 启动 Homestead 虚拟机

修改完 Homestead.yaml 文件后，进入 Homestead 目录，执行以下命令来重新加载并配置虚拟机：

vagrant reload --provision

该命令会重新启动虚拟机，并根据 Homestead.yaml 文件的配置进行相应的设置，包括共享文件夹、站点配置和数据库配置等。

3. SSH 连接到 Homestead 虚拟机

虚拟机启动完成后，可以使用 SSH 连接到虚拟机：

vagrant ssh

该命令会打开一个终端，连接到 Homestead 虚拟机。

4. 使用 Composer 创建 Laravel 项目

连接到虚拟机后，进入共享的代码目录，例如 /home/vagrant/Code，使用 Composer 创建一个新的 Laravel 项目：

cd Code
composer create-project laravel/laravel mylaravelapp

该命令会创建一个名为 mylaravelapp 的 Laravel 项目，并将项目文件存放在 /home/vagrant/Code/mylaravelapp 目录下。Composer 会自动下载 Laravel 框架和相关的依赖包。

注意：

mylaravelapp 是你想要创建的 Laravel 项目的目录名，你可以根据需要修改。
确保虚拟机已经安装了 Composer。如果没有安装，可以使用以下命令安装：
```
sudo apt-get update
sudo apt-get install composer
```

5. 配置 hosts 文件

为了能够通过域名访问 Laravel 项目，需要在本地的 hosts 文件中添加域名解析。hosts 文件通常位于：

Windows: C:\Windows\System32\drivers\etc\hosts
Linux/macOS: /etc/hosts

使用文本编辑器打开 hosts 文件，添加以下内容：

192.168.10.10 mylaravelapp.dev

注意：

192.168.10.10 是 Homestead 虚拟机的 IP 地址，应该与 Homestead.yaml 文件中配置的 IP 地址一致。
mylaravelapp.dev 是你为 Laravel 项目配置的域名，应该与 Homestead.yaml 文件中 sites 部分配置的域名一致。

6. 访问 Laravel 项目

完成以上步骤后，就可以在浏览器中访问 Laravel 项目了。在浏览器中输入 http://mylaravelapp.dev，如果一切配置正确，你应该能够看到 Laravel 的欢迎页面。

注意事项

确保 Homestead 虚拟机已经启动。
确保 Homestead.yaml 文件配置正确，特别是 folders 和 sites 部分。
确保本地的 hosts 文件配置正确，域名解析指向 Homestead 虚拟机的 IP 地址。
如果遇到问题，可以查看 Homestead 的日志文件，位于 ~/.homestead/Homestead.log。

总结

通过以上步骤，你可以使用 Homestead 快速搭建 Laravel 开发环境并创建新的 Laravel 项目。Homestead 提供了一个便捷的方式来管理 Laravel 开发环境，避免了在本地安装和配置各种软件的麻烦。希望本教程能够帮助你更好地使用 Homestead 进行 Laravel 开发。

今天关于《Homestead搭建Laravel项目教程详解》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！