登录
首页 >  文章 >  php教程

Homestead新建Laravel项目教程全解析

时间:2025-07-17 09:42:25 240浏览 收藏

目前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学习网公众号!

相关阅读
更多>
最新阅读
更多>
课程推荐
更多>