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

想要快速搭建 Laravel 开发环境？本文为你提供详细的 Homestead 教程，教你如何利用 Laravel 官方 Vagrant Box – Homestead，轻松创建 Laravel 项目。我们将一步步讲解 Homestead 的配置，包括 Homestead.yaml 文件的设置，如何通过 Vagrant 命令启动虚拟机，以及在虚拟机中使用 Composer 创建 Laravel 项目。更重要的是，我们将指导你配置本地 Hosts 文件，确保你能在浏览器中顺利访问新创建的 Laravel 应用。告别繁琐的环境配置，拥抱高效的 Laravel 开发体验，从 Homestead 开始！

本文旨在指导开发者使用 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 开发者来说是非常重要的。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。