
使用 Homestead 创建 Laravel 项目
homestead 是一个官方提供的、预配置的 laravel 开发环境,它简化了 laravel 项目的搭建过程。以下步骤将指导你如何使用 homestead 创建一个新的 laravel 项目。
1. 配置 Homestead.yaml 文件
Homestead.yaml 文件是 Homestead 的核心配置文件,它定义了虚拟机如何映射本地目录、配置站点和数据库。你需要根据你的项目需求修改这个文件。
找到你的 Homestead 安装目录,通常情况下,它位于用户主目录下的 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
to: /home/vagrant/Code
sites:
- map: homestead.test
to: /home/vagrant/Code/Laravel/public
- map: mylaravelapp.dev
to: /home/vagrant/Code/mylaravelapp/public
databases:
- homestead
- mylaravelapp解释:
- folders: 定义了本地目录与虚拟机目录的映射关系。例如,map: ~/Code 将你的本地 ~/Code 目录映射到虚拟机的 /home/vagrant/Code 目录。你可以在本地 ~/Code 目录中创建多个 Laravel 项目,它们都可以在虚拟机中访问。
- sites: 定义了站点配置。map: mylaravelapp.dev 将域名 mylaravelapp.dev 映射到虚拟机中的 /home/vagrant/Code/mylaravelapp/public 目录。/public 目录是 Laravel 项目的入口点。
- databases: 定义了数据库配置。这里配置了 homestead 和 mylaravelapp 两个数据库。
注意:
- 请根据你的实际项目目录和域名修改 folders 和 sites 配置。
- 确保你的 SSH 密钥已正确配置,否则 Homestead 将无法正常启动。
2. 启动和配置 Homestead 虚拟机
修改完 Homestead.yaml 文件后,你需要重新启动 Homestead 虚拟机以应用新的配置。
- 打开终端,进入 Homestead 目录。
- 运行以下命令:
vagrant reload --provision
这个命令会重新加载 Homestead 虚拟机,并执行配置脚本。这个过程可能需要一些时间,请耐心等待。
3. 通过 SSH 连接到 Homestead 虚拟机
虚拟机启动完成后,你可以通过 SSH 连接到虚拟机。
- 在终端中,进入 Homestead 目录。
- 运行以下命令:
vagrant ssh
这将打开一个 SSH 会话,你现在可以在虚拟机中执行命令。
4. 使用 Composer 创建 Laravel 项目
连接到虚拟机后,你可以使用 Composer 创建一个新的 Laravel 项目。
- 在 SSH 会话中,进入你想要创建项目的目录。例如,进入 /home/vagrant/Code 目录:
cd Code
- 运行以下命令创建 Laravel 项目:
composer create-project laravel/laravel mylaravelapp
mylaravelapp 是你的项目名称,你可以根据你的需要修改它。这个命令会从 Laravel 的官方仓库下载最新版本的 Laravel,并安装所有必要的依赖。
5. 配置 Hosts 文件
为了能够在浏览器中访问你的 Laravel 项目,你需要配置你的本地 Hosts 文件。
-
打开你的 Hosts 文件。
- Windows: C:\Windows\System32\drivers\etc\hosts
- macOS/Linux: /etc/hosts
你需要以管理员权限打开 Hosts 文件。
在 Hosts 文件中添加以下行:
192.168.10.10 mylaravelapp.dev
192.168.10.10 是你的 Homestead 虚拟机的 IP 地址,mylaravelapp.dev 是你在 Homestead.yaml 文件中配置的域名。
注意:
- 确保你的 Hosts 文件中没有其他与 mylaravelapp.dev 冲突的条目。
- 保存 Hosts 文件后,可能需要刷新 DNS 缓存才能使配置生效。
6. 访问你的 Laravel 项目
现在,你可以在浏览器中访问你的 Laravel 项目了。打开浏览器,输入 http://mylaravelapp.dev,你应该能够看到 Laravel 的欢迎页面。
总结
通过以上步骤,你已经成功地使用 Homestead 创建了一个新的 Laravel 项目。你可以开始开发你的应用了。
注意事项:
- 确保你的 Homestead 虚拟机正常运行。
- 仔细检查 Homestead.yaml 文件的配置,确保目录和域名映射正确。
- 配置 Hosts 文件后,可能需要刷新 DNS 缓存。
- 如果遇到问题,请查看 Homestead 的官方文档或搜索相关解决方案。










