Laravel项目创建教程：Homestead使用指南

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

本文旨在指导开发者使用 Homestead 这一官方 Vagrant Box 快速搭建 Laravel 开发环境并创建新的 Laravel 项目。我们将详细讲解如何配置 Homestead.yaml 文件，通过 Vagrant 命令启动虚拟机，以及如何在虚拟机中利用 Composer 创建 Laravel 项目，并最终在浏览器中访问新创建的应用。

Homestead 环境配置

Homestead 是 Laravel 官方提供的 Vagrant Box，它预装了开发 Laravel 应用所需的各种工具，例如 PHP、Nginx、MySQL、Redis 等。首先，确保你已经安装了 VirtualBox 和 Vagrant。

接下来，你需要克隆 Homestead 仓库。通常，我们会将 Homestead 仓库克隆到用户目录下，例如 ~/Homestead。

git clone https://github.com/laravel/homestead.git ~/Homestead

进入 Homestead 目录，并运行 bash init.sh 初始化 Homestead。

cd ~/Homestead
bash init.sh

初始化完成后，会在 Homestead 目录下生成一个 Homestead.yaml 文件，你需要根据自己的需求进行配置。

配置 Homestead.yaml

Homestead.yaml 文件是 Homestead 的核心配置文件，它定义了虚拟机的 IP 地址、内存、CPU 数量、共享目录、站点和数据库等信息。

一个典型的 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
    to: /home/vagrant/Code

sites:
  - map: homestead.test
    to: /home/vagrant/Code/Laravel/public

databases:
  - homestead

• ip: 虚拟机的 IP 地址，可以根据需要修改。
• memory: 虚拟机的内存大小，单位为 MB。
• cpus: 虚拟机的 CPU 核心数。
• provider: 虚拟机提供商，通常为 virtualbox 或 vmware。
• authorize: SSH 公钥的路径，用于免密码登录虚拟机。
• keys: SSH 私钥的路径。
• folders: 定义主机和虚拟机之间的共享目录。map 属性指定主机上的目录，to 属性指定虚拟机上的目录。
• sites: 定义站点。map 属性指定域名，to 属性指定虚拟机上的网站根目录。
• databases: 定义数据库名称。

重要提示： folders 部分的 map 属性定义了你本地代码存放的目录，例如 ~/Code。确保这个目录存在，并且你希望在虚拟机中访问这个目录下的代码。sites 部分的 to 属性指向 Laravel 项目的 public 目录，这个目录是网站的入口。

修改完 Homestead.yaml 文件后，需要重新加载 Homestead 虚拟机。

启动 Homestead 虚拟机

在 Homestead 目录下，运行以下命令启动虚拟机：

vagrant up

如果虚拟机已经启动，可以使用以下命令重新加载虚拟机，使配置生效：

vagrant reload --provision

--provision 参数会重新配置虚拟机，确保所有配置都已应用。

创建 Laravel 项目

虚拟机启动后，可以使用 SSH 登录到虚拟机：

vagrant ssh

登录到虚拟机后，进入共享目录，例如 /home/vagrant/Code，然后使用 Composer 创建新的 Laravel 项目：

cd Code
composer create-project laravel/laravel mylaravelapp

这条命令会创建一个名为 mylaravelapp 的 Laravel 项目，并将项目文件放在 /home/vagrant/Code/mylaravelapp 目录下。

配置 Hosts 文件

为了能够在浏览器中访问新创建的 Laravel 项目，需要在本地机器的 Hosts 文件中添加一条记录，将域名指向虚拟机的 IP 地址。

• Windows: 打开 C:\Windows\System32\drivers\etc\hosts 文件，以管理员身份运行文本编辑器。
• macOS/Linux: 打开 /etc/hosts 文件，需要使用 sudo 命令。

在 Hosts 文件中添加以下内容：

192.168.10.10 mylaravelapp.dev

将 192.168.10.10 替换为你在 Homestead.yaml 文件中配置的 IP 地址，mylaravelapp.dev 替换为你在 Homestead.yaml 文件中配置的域名。

访问 Laravel 项目

现在，你可以在浏览器中输入 http://mylaravelapp.dev 访问新创建的 Laravel 项目了。你应该能够看到 Laravel 的欢迎页面。

注意事项

• 确保 VirtualBox 和 Vagrant 版本是最新的。
• Homestead.yaml 文件中的路径必须正确，否则会导致共享目录或站点配置失败。
• 修改 Hosts 文件需要管理员权限。
• 如果遇到问题，可以查看 Homestead 的日志文件，位于 ~/Homestead/storage/logs 目录下。
• 如果域名无法访问，请检查 Hosts 文件是否配置正确，并确保 DNS 缓存已刷新。可以尝试重启电脑或者清除浏览器缓存。

总结

通过本文的教程，你应该能够成功使用 Homestead 创建新的 Laravel 项目。Homestead 提供了一个方便快捷的 Laravel 开发环境，可以让你专注于代码编写，而无需花费大量时间配置环境。掌握 Homestead 的使用，对于 Laravel 开发者来说是非常重要的。

到这里，我们也就讲完了《Laravel项目创建教程：Homestead使用指南》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！