Laravel Homestead：Laravel 8 官方扩展 Homestead 安装文档
具体简介请查看官方文档，以下只讲解自己是如何安装和使用此虚拟机的步骤。
# 系统环境
- 操作环境：Win 10
- vagrant box 版本：
11.3.0 - homestead 版本：
12.3.2
# 准备工作
首次安装需要 Virtual Box、VMWare、Parallels 或 Hyper-V （四选一，我这用的是 VirtualBox，因为只有 VirtualBox 是免费的）
安装 VirtualBox，官网 下载最新版本安装。
安装 Vagrant，官网 下载最新版本安装。
下载 homestead vagrant box（近 2G 大小)，直接使用 vagrant 下载很慢，所以我这儿是先把 box 下载下来，然后再绑定到 vagrant 中去的：
box 官方版本下载链接：https://app.vagrantup.com/laravel/boxes/homestead
我下载的版本是 11.3.0 ，这里需要注意 box(v11.x) 和 homestead(v12.x) 的版本对应关系
下载 homestead：
git clone https://github.com/laravel/homestead.git，直接使用git命令下载即即可。
# 修改 Vagrant box 路径
新建环境变量即可：VAGRANT_HOME=你的路径
# Vagrant 命令
# 初始化
vagrant init
# 启动虚拟机
vagrant up
# 关闭虚拟机
vagrant halt
# 重启虚拟机
vagrant reload
# SSH 至虚拟机
vagrant ssh
# 挂起虚拟机
vagrant suspend
# 唤醒虚拟机
vagrant resume
# 查看虚拟机运行状态
vagrant status
# 销毁当前虚拟机
vagrant destroy
# 销毁虚拟机
vagrant destroy --force
# 查看 box list
vagrant box list
# 添加 box
vagrant box add 名称 路径
vagrant box add json文件
# 删除 box, 例子: vagrant box remove laravel/homestead --box-version 0
vagrant box remove 名称 --box-version 版本
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
# 安装
# 修改默认虚拟电脑位置
打开 Virtual Box -> 管理 -> 全局设定 -> 常规，修改默认虚拟电脑位置（我将其修改在 D盘，位置路径中不能含空格和中文），要是 C盘 容量够大，可以不用改。
# 注入 Vagrant Box
在下载的 homestead vagrant box 同目录下新建 box 的配置文件
metadata.json：{ "name": "laravel/homestead", "versions": [ { "version": "11.3.0", "providers": [ { "name": "virtualbox", "url": "D:/homestead/homestead_vagrant_box/virtualbox.box" } ] } ] }1
2
3
4
5
6
7
8
9
10
11
12
13
14
15字段说明：
"version"：你所使用的 Homestead Vagrant Box 虚拟机 的版本。"url"：你所使用的 Homestead Vagrant Box 虚拟机 的路径(绝对相对都可)。
在
metadata.json文件夹中，将配置信息注入到 Vagrant 中：若之前直接使用
vagrant box add laravel/homestead D:\homestead\homestead_vagrant_box\virtualbox.box此命令注入过 box，但是查看 box 列表时，含有版本为0的，需要先将其删除，再重新添加（先添加后删除也可），否则执行vagrant up时，提示Box 'laravel/homestead' could not be found后，会自动在下载某个东西。# 查看绑定的 vagrant box $ vagrant box list laravel/homestead (virtualbox, 0) # 删除版本为 0 的 box（若此版本不是 0 但与 homestead 不对应，也需删除） $ vagrant box remove laravel/homestead --box-version 01
2
3
4
5
6注入版本
11.3.0的 box# 注入 metadata.json $ vagrant box add metadata.json ... ==> box: Successfully added box 'laravel/homestead' (v11.3.0) for 'virtualbox'! $ vagrant box list laravel/homestead (virtualbox, 11.3.0)1
2
3
4
5
6
7
# 启动 Vagrant
进入下载好的
homestead项目的文件夹，执行命令（若已初始化，请忽略此步骤）：$ init.bat Homestead initialized!1
2需要启动 Virtual Box，选择 homestead box 配置其网络，设置 -> 网络 -> 网卡2 -> 连接方式选择
仅主机(Host-Only)网络，界面名称选择Virtual Box Host-Only Ethernet Adapter #2，不配置的话启动会失败。初始化 homestead 后，再启动 vagrant：
$ vagrant up Bringing machine 'homestead' up with 'virtualbox' provider... ==> homestead: Checking if box 'laravel/homestead' version '11.3.0' is up to date... ==> homestead: Setting the name of the VM: homestead ==> homestead: Clearing any previously set network interfaces... ==> homestead: Preparing network interfaces based on configuration... homestead: Adapter 1: nat homestead: Adapter 2: hostonly ==> homestead: Forwarding ports... ...1
2
3
4
5
6
7
8
9
10此命令等同于：打开 Virtual Box -> 工具 -> 导入 -> 选择 vagrant 注入 box 后的文件路径：
C:\Users\用户名\.vagrant.d\boxes\laravel-VAGRANTSLASH-homestead\11.3.0\virtualbox\box.ovf，再点击下一步、导入。
# 配置虚拟机
我们需要做的是，在虚拟机中创建项目，将该项目映射到 windows 的目录中，我们在 windows 环境下写代码，而代码在虚拟机的环境中被做处理，在 windows 环境下访问对应的站点查看运行结果。
# 启动虚拟机
- 打开虚拟机软件 -> 启动（若已启动，则点击显示）-> 输入密码
vagrant即可进入虚拟机。 - 进入下载好的
homestead项目的文件夹 -> 使用命令vagrant up启动虚拟机。
# 查看虚拟机目录
- 进入虚拟机图形界面点击左上角 Activities -> 打开 ImageMagick -> 单击这个图片 -> file -> open，便可以查看 ubuntu 目录。
- 在
homestead项目的文件夹下执行下面的命令，就可以在 windows 下操作 ubuntu 中的命令行了。$ vagrant ssh ... vagrant@homestead:~$ ls # 输入 ls ：查看当前目录的全部文件 Desktop Documents Downloads Music Pictures Public Templates vendor Videos vagrant@homestead:~$ mkdir Projects # 输入mkdir xx ：新建文件夹 vagrant@homestead:~$ cd Projects # 输入cd xx ：进入某个文件 vagrant@homestead:~/Projects$ cd .. # 输入cd .. ：返回到上一个目录1
2
3
4
5
6
7
# 项目目录映射
在虚拟机中创建
Projects文件夹用于存放项目映射：通过vagrant ssh在 windows 下操作虚拟机，mkdir Projects创建文件夹。在 windows 下创建一个目录存放项目，比如在D盘创建一个 projects 文件夹： D:\projects （虚拟机中的项目的实体就放在这里面了）。
配置映射：打开 windows 下
homestead目录中的Homestead.yaml文件，修改内容如下：# 此 IP 是用于访问虚拟机的 IP ip: "192.168.10.10" memory: 2048 cpus: 2 provider: virtualbox authorize: ~/.ssh/id_rsa.pub keys: - ~/.ssh/id_rsa folders: - map: D:\projects # windows 下的绝对路径，项目的实体 to: /home/vagrant/Projects # 虚拟机中的映射路径 sites: - map: 192.168.10.10 # 该项目的访问地址，即可访问 index.php to: /home/vagrant/Projects/demo/public # 虚拟机中 index.php 的存放目录1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18检查项目目录是否映射成功：
每次修改
Homestead.yaml内容，都要重启虚拟机# 在 homestead 目录下 $ vagrant reload --provision ... # 重启成功1
2
3
4在 windows 中打开浏览器，访问：192.168.10.10，显示了一段字符 ：No input file specified. 就代表映射成功了，因为没有 index.php ，所以就显示这段字符；若失败了，会显示 “无法显示此网页”。
将 ip 地址访问形式改成 url 的形式访问：
打开
Homestead.yaml，修改下面配置，保存后重启虚拟机。ip: "192.168.10.10" ... sites: - map: homestead.test # 此访问的 url to: /home/vagrant/Projects/demo/public ...1
2
3
4
5
6打开
C:\Windows\System32\drivers\etc\hosts，填入：192.168.10.10 homestead.test1便实现了url 与 ip 地址的映射了，访问 homestead.test 即可成功显示页面。
# 启动虚拟机报错
NodeJs 下载失败，需要修改homestead项目中，bin目录下wsl-init文件，将-sL改为-fsSL，修改后如下所示：
# NodeJS curl -fsSL https://deb.nodesource.com/setup_14.x | sudo -E bash -
# 全局访问 Homestead
Windows 环境
在系统的任意位置创建一个批处理文件
homestead.bat：脚本中实例路径
D:\Homestead调整为Homestead实际安装路径。@echo off set cwd=%cd% set homesteadVagrant=D:\Homestead cd /d %homesteadVagrant% && vagrant %* cd /d %cwd% set cwd= set homesteadVagrant=1
2
3
4
5
6
7
8
9
10创建文件之后，添加该文件所在目录路径到用户环境变量的
PATH键中。在系统的任意位置即可运行
homestead up或homestead ssh命令。
# 创建项目
windows环境，在 homestead 目录下，执行命令：
# 在 homestead 目录下，连接虚拟机
$ vagrant ssh
Welcome to Ubuntu 20.04.2 LTS (GNU/Linux 5.4.0-73-generic x86_64)
_ _ _
| | | | | |
| |__ ___ _ __ ___ ___ ___| |_ ___ __ _ __| |
| '_ \ / _ \| '_ ` _ \ / _ \/ __| __/ _ \/ _` |/ _` |
| | | | (_) | | | | | | __/\__ \ || __/ (_| | (_| |
|_| |_|\___/|_| |_| |_|\___||___/\__\___|\__,_|\__,_|
* Homestead v12.3.1 | Thanks for using Homestead
* Settler v11.3.0
Last login: Mon Aug 2 08:22:58 2021 from 10.0.2.2
# 查看目录
vagrant@homestead:~$ ls
Desktop Documents Downloads Music Pictures Public Templates vendor Videos
# 创建 Projects 文件夹
vagrant@homestead:~$ mkdir Projects
# 进入 Projects 目录
vagrant@homestead:~$ cd Projects
# 创建一个名为 demo 的 laravel 项目
vagrant@homestead:~/Projects$ laravel new demo
_ _
| | | |
| | __ _ _ __ __ ___ _____| |
| | / _` | '__/ _` \ \ / / _ \ |
| |___| (_| | | | (_| |\ V / __/ |
|______\__,_|_| \__,_| \_/ \___|_|
Creating a "laravel/laravel" project at "./demo"
Installing laravel/laravel (v8.5.22)
- Downloading laravel/laravel (v8.5.22)
- Installing laravel/laravel (v8.5.22): Extracting archive
Created project in /home/vagrant/Projects/demo
...
Application ready! Build something amazing.
# 创建成功
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
随后访问配置 Homestead.yaml 中对应的 index.php 的 IP 即可。
# 创建项目报错：
Creating a "laravel/laravel" project at "./demo"
https://repo.packagist.org could not be fully loaded (curl error 28 while downloading https://repo.packagist.org/packages.json: Connection timed out after 10004 milliseconds), package information was loaded from the local cache and may be out of date
[Composer\Downloader\TransportException]
curl error 28 while downloading https://repo.packagist.org/p2/laravel/laravel.json: Connection timed out after 10004 milliseconds
create-project [-s|--stability STABILITY] [--prefer-source] [--prefer-dist] [--repository REPOSITORY] [--repository-url REPOSITORY-URL] [--add-repository] [--dev] [--no-dev] [--no-custom-installers] [--no-scripts] [--no-progress] [--no-secure-http] [--keep-vcs] [--remove-vcs]
[--no-install] [--ignore-platform-req IGNORE-PLATFORM-REQ] [--ignore-platform-reqs] [--ask] [--] [<package>] [<directory>] [<version>]
2
3
4
5
6
7
8
9
将源更改为阿里云 Composer 国内镜像:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
# 新增站点
新增 sites
$ vim ~/.homestead/Homestead.yaml folders: - map: D:\Development\homestead\projects to: /home/vagrant/Projects # 在sites中新增一条map记录,修改后配置如下: sites: ### 默认 - map: homestead.test to: /home/vagrant/Projects/demo/public ### 新增一个网站 - map: another.test to: /home/vagrant/Projects/demo2/public1
2
3
4
5
6
7
8
9
10
11
12
13
14
15新增 host 记录
$ sudo vim /etc/hosts ### 新增一条host记录，IP是Homestead.yaml中"ip"，修改后如下： ### ... (略) ... 192.168.10.10 homestead.test 192.168.10.10 another.test1
2
3
4
5
6重启虚拟机
进入
homestead文件夹目录：vagrant reload --provision1打开浏览器，输入
http://another.test/, 即可正常访问。
# 连接 Homestead 数据库
# MySql
地址：192.168.10.10，端口：3306
用户名：homestead，密码：secret
使用客户端连接：
配置连接，输入地址、端口、用户、密码即可。
使用命令登录虚拟机：
先启动虚拟机，并用ssh连接，执行以下操作：
# 连接 mysql 数据库 vagrant@homestead:~$ mysql -h192.168.10.10 -uhomestead -p # 输入密码 Enter password: Welcome to the MySQL monitor. Commands end with ; or \g. Your MySQL connection id is 9 Server version: 8.0.25-0ubuntu0.20.04.1 (Ubuntu) Copyright (c) 2000, 2021, Oracle and/or its affiliates. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners. Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. # 显示全部数据库 mysql> show databases; +--------------------+ | Database | +--------------------+ | homestead | | information_schema | | mysql | | performance_schema | | sys | +--------------------+ 5 rows in set (0.00 sec)1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# PostgreSQL
地址：192.168.10.10，端口：3306
用户名：homestead，密码：secret
使用客户端连接：
配置连接，输入地址、端口、用户、密码即可。
使用命令连接：
先启动虚拟机，并用ssh连接，执行以下操作：
# 连接 postgresql 数据库 vagrant@homestead:~$ psql -U homestead -h localhost -W # 输入密码 Password: psql (13.3 (Ubuntu 13.3-1.pgdg20.04+1)) SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off) Type "help" for help. # 显示全部数据库 homestead=# \list List of databases Name | Owner | Encoding | Collate | Ctype | Access privileges -----------+-----------+----------+-------------+-------------+----------------------- homestead | homestead | UTF8 | en_US.UTF-8 | en_US.UTF-8 | postgres | postgres | UTF8 | en_US.UTF-8 | en_US.UTF-8 | template0 | postgres | UTF8 | en_US.UTF-8 | en_US.UTF-8 | =c/postgres + | | | | | postgres=CTc/postgres template1 | postgres | UTF8 | en_US.UTF-8 | en_US.UTF-8 | =c/postgres + | | | | | postgres=CTc/postgres (4 rows)1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
注意： 若无法使用IP(192.168.10.10)连接PostgreSQL数据库，需做以下操作：
查看
PostgreSQL版本：vagrant@homestead:$ psql -V psql (PostgreSQL) 13.3 (Ubuntu 13.3-1.pgdg20.04+1)1
2根据版本进入需要配置的目录，我这里版本是
13.3，所以进入的文件目录是13# 进入配置文件夹 vagrant@homestead:~$ cd /etc/postgresql/13/main/ # 查看全部文件及其权限 vagrant@homestead:/etc/postgresql/13/main$ ll # 省略其他... -rw-r----- 1 postgres postgres 5071 Sep 28 08:05 pg_hba.conf -rw-r--r-- 1 postgres postgres 28281 May 13 16:40 postgresql.conf1
2
3
4
5
6
7需要
postgresql.conf和pg_hba.conf文件的独写权限：# 记得修改文件权限 # 设置其他用户可独写 pg_hba.conf 文件 vagrant@homestead:/etc/postgresql/13/main$ sudo chmod o+rw pg_hba.conf # 设置其他用户可独写 pg_hba.conf 文件 vagrant@homestead:/etc/postgresql/13/main$ sudo chmod o+w postgresql.conf # 权限配置完成之后是这样的 vagrant@homestead:/etc/postgresql/13/main$ ll # 省略其他... -rw-r--rw- 1 postgres postgres 5071 Sep 28 08:05 pg_hba.conf -rw-r--rw- 1 postgres postgres 28281 May 13 16:40 postgresql.conf1
2
3
4
5
6
7
8
9
10postgresql.conf配置项改为listen_address='*'：# 使用上下键可以查看配置项 # 按"I"键，可进行编辑 # 编辑完成后按"Esc"退出编辑 # 退出编辑后，按"Shift" + ":"，然后输入命令即可："wq"(保存并退出)、"q"(仅退出) vagrant@homestead:/etc/postgresql/13/main$ vim postgresql.conf1
2
3
4
5配置
pg_hba.conf：在此文件最下面一行加：
# IPv4 local connections 允许所有ip连接: host all all 0.0.0.0/0 trust1
2编辑文件：
# 使用上下键可以查看配置项 # 按"I"键，可进行编辑 # 编辑完成后按"Esc"退出编辑 # 退出编辑后，按"Shift" + ":"，然后输入命令即可："wq"(保存并退出)、"q"(仅退出) vagrant@homestead:/etc/postgresql/13/main$ vim pg_hba.conf1
2
3
4
5重启
PostgreSql服务：# 重启 PostgreSql 服务 sudo service postgresql restart1
2重新按照上面连接的命令执行即可使用IP连接
# REDIS 服务
# 修改 redis 密码
注意修改以下密码部分
vagrant@homestead:~$ redis-cli
# 设置密码
127.0.0.1:6379> config set requirepass 密码
OK
# 验证密码，若提示 OK ，则配置成功
127.0.0.1:6379> auth 密码
OK
# 将密码覆盖写入配置中，否则重启便会失效
127.0.0.1:6379> config rewrite
OK
2
3
4
5
6
7
8
9
10
stop-writes-on-bgsave-error no
# 重启服务
sudo service redis-server restart
# 安装 FTP 文件服务
- 安装软件包；
sudo apt-get install vsftpd1 - 打开配置文件：
vim /etc/vsftpd.conf1 - 修改参数：
#这些设置系统默认是开启的，可以不管 listen=NO listen_ipv6=YES dirmessage_enable=YES use_localtime=YES xferlog_enable=YES connect_from_port_20=YES #下面的就要自定义设置了，建议系统默认的不管，然后复制下面的 #是否允许匿名访问，NO为不允许 anonymous_enable=NO #是否允许本地用户访问,就是linux本机中存在的用户，YES允许 local_enable=YES #是否开启写模式，YES为开启 write_enable=YES #新建文件权限，一般设置为022，那么新建后的文件的权限就是777-022=755 local_umask=022 #是否启动userlist为通过模式，YES的话只有存在于userlist文件中的用户才能登录ftp（可以理解为userlist是一个白名单），NO的话，白名单失效，和下面一个参数配合使用 userlist_enable=YES #是否启动userlist为禁止模式，YES表示在userlist中的用户禁止登录ftp（黑名单），NO表示黑名单失效，我们已经让userlist作为一个白名单，所以无需使用黑名单功能 userlist_deny=NO #指定哪个文件作为userlist文件，我们稍后编辑这个文件 userlist_file=/etc/vsftpd.user_list #是否限制本地所有用户切换根目录的权限，YES为开启限制，即登录后的用户不能访问ftp根目录以外的目录，当然要限制啦 chroot_local_user=YES #是否启动限制用户的名单list为允许模式，上面的YES限制了所有用户，可以用这个名单作为白名单，作为例外允许访问ftp根目录以外 chroot_list_enable=YES #设置哪个文件是list文件，里面的用户将不受限制的去访问ftp根目录以外的目录 chroot_list_file=/etc/vsftpd.chroot_list #是否开启写模式，开启后可以进行创建文件夹等写入操作 allow_writeable_chroot=YES #设置ftp根目录的位置,这个文件我们稍后自己创建 local_root=~/ftp #设置端口 listen_port=211
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40 - 重启服务：
sudo /etc/init.d/vsftpd restart1 - 设置用户：
# 添加用户 sudo useradd -d ~/ftp username # 配置密码 sudo passwd username1
2
3
4 - 创建 user_list 文件：将 username 添加进去，多个用户的话，换行添加下一个。
sudo vim /etc/vsftpd.user_list1 - 创建用户文件夹：
sudo mkdir ~/myftp1 - 连接 ftp：
# linux访问输入ftp 加 你的IP ftp xxx.xxx.xxx.xxx1
2
# 安装 PHP 扩展
# Imagick
安装 libmagickwand-dev 和 libmagickcore-dev，不知道有没有用
sudo apt-get install libmagickwand-dev libmagickcore-dev
使用pecl安装
# 进入 /etc/share 目录，此目录存放的全部软件包 vagrant@homestead:~$ cd /usr/share # 安装 imagick vagrant@homestead:/usr/share$ sudo pecl install imagick # 省略 ... Installing shared extensions: /usr/lib/php/20160303/ Installing header files: /usr/include/php/20160303/1
2
3
4
5
6
7使用源码安装
使用源码安装不知道哪儿不对，安装成功配置好后
imagick扩展没生效# 进入 /etc/share 目录，此目录存放的全部软件包 vagrant@homestead:~$ cd /usr/share # 下载 imagick vagrant@homestead:/usr/share$ sudo wget https://pecl.php.net/get/imagick-3.5.1.tgz # 解压 vagrant@homestead:/usr/share$ sudo tar xf imagick-3.5.1.tgz # 进入 imagick 目录 vagrant@homestead:/usr/share$ cd imagick-3.5.11
2
3
4
5
6
7
8编译并安装
注意：若php版本不同，则替换以下
7.1部分改成你需要的php版本号vagrant@homestead:/usr/share/imagick-3.5.1$ sudo /usr/bin/phpize7.1 # 省略 ... vagrant@homestead:/usr/share/imagick-3.5.1$ sudo ./configure --with-php-config=/usr/bin/php-config7.1 # 省略 ... # 安装 vagrant@homestead:/usr/share/imagick-3.5.1$ sudo make && sudo make install # 省略 ... Installing shared extensions: /usr/lib/php/20160303/ Installing header files: /usr/include/php/20160303/1
2
3
4
5
6
7
8
9配置
- 方法一（建议使用方法二，因为
php的配置文件较多，改起来比较麻烦）：# 进入配置文件夹 vagrant@homestead:/usr/share/imagick-3.5.1$ cd /etc/php/7.1/cli # 编辑配置文件 vagrant@homestead:/etc/php/7.1/cli$ sudo vim php.ini # 按 I 键可输入，按 Esc 退出输入后再按 :wq 退出并保存 填入 'extension=imagick.so' 并保存1
2
3
4
5
6 - 方法二：
vagrant@homestead:/usr/share/imagick-3.5.1$ cd /etc/php/7.1/mods-available/ vagrant@homestead:/etc/php/7.1/mods-available$ sudo vim imagick.ini # 按 I 键可输入，按 Esc 退出输入后再按 :wq 退出并保存 填入 'extension=imagick.so' 并保存 # 进入 fpm 文件 vagrant@homestead:/etc/php/7.1/mods-available$ cd /etc/php/7.1/fpm/conf.d vagrant@homestead:/etc/php/7.1/mods-available$ sudo ln -s /etc/php/7.1/mods-available/imagick.ini 20-imagick.ini1
2
3
4
5
6
7
- 方法一（建议使用方法二，因为
重启服务
vagrant@homestead:/etc/php/7.1/cli$ sudo service php7.1-fpm restart1