首先配置Homestead环境并映射项目路径,接着设置Nginx站点与数据库,最后通过vagrant up启动虚拟机并访问myproject.test完成部署。

将PHP项目部署到Homestead环境,主要是利用Vagrant搭建的Laravel Homestead虚拟机来模拟生产服务器环境。整个过程包括配置Homestead、添加项目路径、设置Nginx站点、配置数据库等步骤。下面是一个清晰实用的部署流程。
1. 准备工作:安装Homestead环境
确保你已经安装了以下工具:
- VirtualBox 或 VMware(推荐VirtualBox)
- Vagrant
- 命令行工具(如Terminal或Git Bash)
接着克隆Homestead虚拟机:
git clone https://github.com/laravel/homestead.git ~/Homestead进入目录并检出稳定版本:
立即学习“PHP免费学习笔记(深入)”;
cd ~/Homestead && git checkout release初始化Homestead:
bash init.shWindows用户使用:init.bat
2. 配置Homestead.yaml文件
打开 ~/.homestead/Homestead.yaml 文件进行编辑。如果没有,可从模板生成:
cp ~/Homestead/Homestead.yaml ~/.homestead/Homestead.yaml修改关键配置项:
- folders: 映射本地项目目录到虚拟机
- sites: 配置Web站点访问路径
- databases: 创建项目所需数据库
示例配置:
folders:- map: /Users/yourname/code
to: /home/vagrant/code
sites:
- map: myproject.test
to: /home/vagrant/code/myproject/public
databases:
- myproject_db
3. 配置本地hosts文件
为了让系统识别自定义域名,需修改本地hosts文件:
sudo vim /etc/hosts添加一行:
192.168.10.10 myproject.test保存退出即可。
4. 启动并连接虚拟机
在Homestead目录下启动虚拟机:
vagrant up首次运行会下载镜像较慢,之后启动较快。启动完成后SSH连接:
vagrant ssh5. 部署PHP项目代码
将你的PHP项目复制到映射目录中,例如:
cp -r /path/to/your/project ~/code/myproject如果你使用Git,也可以直接在虚拟机内克隆:
git clone https://gitee.com/xxx/myproject.git /home/vagrant/code/myproject确保入口文件(如index.php)位于 public 目录,并且Nginx指向正确。
6. 安装依赖与权限设置
进入项目目录,安装Composer依赖:
cd /home/vagrant/code/myprojectcomposer install
设置存储和缓存目录权限:
sudo chmod -R 775 storage bootstrap/cache7. 检查数据库配置
如果项目需要数据库,在 .env 文件中配置数据库连接:
DB_CONNECTION=mysqlDB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=myproject_db
DB_USERNAME=homestead
DB_PASSWORD=secret
数据库会在虚拟机启动时自动创建,账号密码默认为 homestead / secret。
8. 访问项目
打开浏览器,访问:
http://myproject.test如果看到项目页面,说明部署成功。若出现404,请检查站点路径是否指向 /public 目录。
基本上就这些。只要配置好映射路径、站点域名和数据库,大多数PHP项目都能顺利运行在Homestead中。不复杂但容易忽略细节。











