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

Homestead新建Laravel项目教程全解析

2025-07-17 09:42:25 0浏览收藏

目前golang学习网上已经有很多关于文章的文章了，自己在初次阅读这些文章中，也见识到了很多学习思路；那么本文《Homestead 新建 Laravel 项目教程详解》，也希望能帮助到大家，如果阅读完后真的对你学习文章有帮助，欢迎动动手指，评论留言并分享~

使用 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学习网公众号！