Homestead怎么安装运行laravel项目

发布时间：2023-03-17 15:52:53 作者：iii
来源：亿速云阅读：237

# Homestead怎么安装运行laravel项目

## 前言

Laravel Homestead 是 Laravel 官方推荐的本地开发环境，它预装了 Nginx、PHP、MySQL、PostgreSQL、Redis 等常用服务，并提供了统一的 Vagrant 虚拟机管理方式。本文将详细介绍如何在 Homestead 环境中安装和运行 Laravel 项目。

---

## 一、环境准备

### 1. 系统要求
- **操作系统**：Windows 10/11、macOS 或 Linux
- **硬件要求**：
  - 至少 4GB 内存（推荐 8GB+）
  - 20GB 可用磁盘空间
- **软件依赖**：
  - [VirtualBox](https://www.virtualbox.org/) 6.1+ 或 [VMware Workstation](https://www.vmware.com/)
  - [Vagrant](https://www.vagrantup.com/) 2.2.0+
  - Git（可选，用于版本控制）

### 2. 安装必要工具
```bash
# 以 macOS 为例（Homebrew 安装）
brew install --cask virtualbox vagrant

二、安装 Homestead

1. 下载 Homestead 镜像

vagrant box add laravel/homestead

注：首次下载约需 1GB 流量，耗时取决于网络速度。

2. 克隆 Homestead 仓库

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

3. 初始化配置

# 生成 Homestead.yaml 配置文件
bash init.sh

三、配置 Homestead

1. 编辑 `Homestead.yaml`

主要配置项：

ip: "192.168.56.56"
memory: 2048
cpus: 2
provider: virtualbox

folders:
  - map: ~/code/laravel-project
    to: /home/vagrant/code

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

databases:
  - homestead

2. 修改本地 hosts 文件

# Windows: C:\Windows\System32\drivers\etc\hosts
# macOS/Linux: /etc/hosts
192.168.56.56 homestead.test

四、启动 Homestead

1. 启动虚拟机

cd ~/Homestead
vagrant up

首次启动会自动下载并配置虚拟机，约需 10-30 分钟。

2. 验证运行状态

vagrant ssh
ls /home/vagrant/code  # 应看到同步的本地项目文件

五、安装 Laravel 项目

方案A：全新创建项目

vagrant ssh
cd /home/vagrant/code
composer create-project laravel/laravel .

方案B：部署已有项目

将项目文件放入本地映射目录（如 ~/code/laravel-project）
在虚拟机中安装依赖：

vagrant ssh
cd /home/vagrant/code
composer install
cp .env.example .env
php artisan key:generate

六、数据库配置

1. 连接信息

主机: 127.0.0.1 或 localhost
端口: 3306 (MySQL) / 5432 (PostgreSQL)
用户名: homestead
密码: secret

2. 创建数据库

mysql -u homestead -psecret -e "CREATE DATABASE my_app"

或在 .env 中配置：

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=my_app
DB_USERNAME=homestead
DB_PASSWORD=secret

七、访问项目

1. 通过配置的域名访问

浏览器打开：http://homestead.test

2. 常用开发命令

# 在虚拟机中执行
php artisan serve  # 开发服务器（可选）
php artisan migrate  # 数据库迁移
npm install && npm run dev  # 前端构建

八、日常使用技巧

1. 管理虚拟机

vagrant halt    # 关闭
vagrant suspend # 暂停
vagrant reload --provision  # 重启并重载配置

2. 文件同步问题解决

如果文件修改未同步：

vagrant rsync-auto

3. 多项目配置

sites:
  - map: project1.test
    to: /home/vagrant/code/project1/public
  - map: project2.test
    to: /home/vagrant/code/project2/public

九、常见问题解决

1. 启动时报错 “VT-x not available”

进入 BIOS 启用虚拟化技术（Intel VT-x/AMD-V）
关闭 Hyper-V（Windows 用户）

2. 端口冲突

修改 Homestead.yaml 中的 ip 或关闭本地占用端口的程序。

3. Composer 安装慢

vagrant ssh
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

结语

通过 Homestead 可以快速搭建符合 Laravel 最佳实践的开发环境。相比本地直接安装，它能保证团队成员的开发环境一致性，避免”在我机器上能跑”的问题。建议结合 Laravel Sail 或 Laravel Valet 根据实际需求选择方案。

官方文档参考：Laravel Homestead Docs “`

（全文约1350字，实际字数可能因格式调整略有变化）