Laravel 开发环境搭建-笔记

原文连接

开发环境搭建 - Windows
https://laravel-china.org/docs/laravel-development-environment/5.5/development-environment-windows/938

前言

1. 以下大部分是原文连接内容，怕自己理解不到位，纯手动打字加深理解。上方有原文连接
2. .不实战一次，你永远不知道会犯下多少愚蠢的错误。记录了WINDOWS环境下安装时犯下的各种低级错误

总结

1. .跟着教程手打一次，越发理解配置命令背后的含义。有些事情当你没到达某种境界时，你以为你知道，其实你根本不知道。多敲多思考，不懂就找好朋友百度解决问题。
2. 碰到问题耐心解决，时间允许情况下，尽量总结并做到知其然，知其所以然。这些错误会成为宝贵的经验沉淀。
3. 深刻理解并同意课程理念，逐渐发现入门教程也有最好教程一说，很多原理都描述得很细致。需要多练习才能get。
4. .东西学得多，自然忘记得快，笔记是个好的解决方案。
5. 第一次用md，没想到写笔记这么舒服，确实好用。

homestead.yaml配置总结：

1.ip: "192.168.10.10"

IP映射，需要在终端配置hosts IP才能访问虚拟域名。

2authorize: ~/.ssh/id_rsa.pub

指派登录虚拟机授权连接的公钥文件，填写的是主机的公钥文件地址，虚拟机初始化此文件里的内容会被默认复制存储到虚拟机的/home/vagrant/.ssh/authorized_keys中，从而实现ssh免密码登录

3.KEYS

是数组选项，填写的是本机SSH私钥文件地址。虚拟机初始化时，会将此处填写的的【所有】SSH私钥文件赋值到虚拟机的/home/vagrant/.ssh文件夹中，从而使虚拟机能共享主机上的ssh私钥文件，使虚拟机具备等同于主机的身份认证。PS:这里解析了为什么GitHub配置一个SSH公钥即可实现GITHUB对虚拟机和主机共同认证！即主机对GITHUB认证 私钥通过，虚拟机初始化时复制私钥到KEYS到虚拟机中，默认虚拟机也同理通过。

4.folders

关键字	说明	记录
map	本机文件夹，即需要建立映射关系的文件夹	no inpuct file specifield 注意映射关系的文件名的大小写
to	虚拟机文件夹，即虚拟机中建立与本机映射关系的文件夹

5.databases 配置连接的数据库名称

6.用文本编辑时，记得ctrl+s

相关连接

（转）为什么我的项目页面打开这门慢（重点推荐）
（转）后面还有一个NPM RUN CPU占用率过高的问题

---

正文：步骤简略

1. 安装VirtualBox
2. 安装Vagrant
3. 导入Homestead Box虚拟机盒子
4. 安装Git
5. 安装Homestead管理脚本
6. 配置Homestead.yaml文件
7. 启动Homestead

安装VirtualBox

VirtualBox百科词条
https://baike.baidu.com/item/VirtualBox/5842786?fromtitle=virtual%20box&fromid=3961028&fr=aladdin

简单理解：模拟出你想要的系统
安装：点击下一步即可

安装Vagrant

百度词条
https://baike.baidu.com/item/Vagrant/1321946?fr=aladdin

简单理解：创建和部署虚拟化开发环境。
安装：next

刚开始使用vagrant命令时，总是把 vagrant up 输入成 vargant 。习惯性认为是var赋值之意 。后来从mysql grant权限以及查询其英文词意得出灵感，才理解 grant是 承认;同意;授予之意。此处转化为程序语境，有点类似“赋予权限” 。使用外国人开发的东西，还是得抓一下英文基本功才能更好理解……

Homestead介绍

原文连接提供的homestead，实际是打包好N种开发所需的软件和vagrant盒子。主要是提供一个优秀的开发环境，在盒子中已经移植好PHP、Composer、Nginx、Mysql、git…等其他工具软件。

目的是为团队开发的成员搭建一致开发环境，确保成员环境一致，避免因环境配置出现不可预估的错误。这也是为什么Laravel学院要求初学者下载导入定制好的盒子~

1.Homestead 管理脚本

Homestead脚本使用Ruby和Shell脚本编写而成。原理是对vagrantfile文件做定制。将从
~/Homestead/Homestead.yaml读取配置信息。在provision时，解析为vagrant命令并进行对虚拟机的配置
同时提供了极其简单易用的接口，傻瓜化配置即可完成复杂任务

• IP配置，端口映射
• Nginx Site创建
• 数据库创建
• 主机文件夹挂在到虚拟机等任务

安装和使用Homestead

1. 下载和导入Homestead虚拟机盒子
2. 安装Git，为下载Homestead管理脚本做准备
3. 使用Git下载Homestead管理脚本

1.下载导入Homestead Box

Windows下需要使用导入命令,找到盒子所在的路径，cmd输入以下命令

> vagrant box add metadata.json

2.安装GIT

关键字：next
很多安装模式选项，得找时间研究一下

3.下载homestead管理脚本

克隆 summer主页的git项目 WINDOWS下，默认在 C盘 用户名/homstead。能找到该文件

> cd ~ 
> git clone https://git.coding.net/summerblue/homestead.git Homestead

完成后，为GIT创建分支 checkout v7.8.0（注意区分文件名大小写）

> cd ~/Homestead
> git checkout v7.8.0  #刚开始不知道checkout是什么，还以为是检查版本，后来发现这是git版本管理一个强大的功能

接下来初始化Homestead

> bash init.sh 

运行成功后会在~/Homestead目录生成三个文件

• Homestead.yaml主要配置信息文件，从中可以读到战点和数据库等信息
• after.sh-每一次homestead盒子重置后（provision）会调用shell脚本文件
• alsaes-每一次homestead盒子重置后，会被替换到虚拟机的~/.bash_alisases文件中，aliases放一些文件的各项配置信息进行详细

此处vagrant provision与vagrant reload搭配使用，可加载修改后的yaml文件配置，类似修改完apache后重启

Homestead.yaml配置文件

接下来再对 Homestead.yaml进行详细配置

> cd ~/Homestead/        #进入到Homestead/文件夹下
> explorer .             #打开该文件夹视图，然后打开homestead.yaml配置进行修改

另外一种使用命令快速打开Homestead.yaml文件

> subl ~/Homestead/Homestead.yaml  #subl是sublime打开文件的命令，需要单独配置，详见下方

 转：终端用sublime打开文件的方法 作者：**QUETAL**
 https://blog.csdn.net/u011240016/article/details/54434923

Homestead.yaml配置大致分为以下几种

1. 虚拟机配置
2. SSH秘钥登录设置
3. 共享文件夹配置
4. 站点配置
5. 数据库配置
6. 自定义变量

1.虚拟机配置

Homestead支持我们对虚拟机的IP，内存，CPU，虚拟机的默认提供者进行配置。这里我们基本不需要做任何配置。

ip: "192.168.10.10"  #ip映射，配置虚拟域名，需要在终端hosts添加该ip.后续有
memory: 2048
cpus: 1
provider: virtualbox

2.SSH秘钥登录配置

authorize 选项是指派登录虚拟机授权连接的公钥文件，此文件填写的是主机上的公钥文件地址，虚拟机初始化时，此文件里的内容会被默认复制存储到虚拟机/home/vagrant/.ssh/authorized_keys文件中，从而实现ssh免密码登录。在这里我们默认填写

authorize ~/.ssh/id.rsa.pub   #这就是为什么输入vagrant up && vagrant ssh即可免密码登录

keys是数组选项，填写的是本机SSH私钥文件地址。虚拟机初始化时，会将此处填写的所有SSH私钥文件赋值到虚拟机的/home/vagrant/.ssh/文件夹中，从而使虚拟机能共享主机上的SSH私钥文件，使虚拟机具备等同于主机的身份认证。此功能为SSH授权提供了便利。例如在后面章节中，我们只需要在Github配置一个SSH公钥即可实现GITHUB对虚拟机和主机共同认证（GitHub是代码托管，终端代码提交需要配置公钥连接）

keys:
- ~/.ssh/id_ras
- ~/.ssh/id_rsa.pub  #变化在这里，此处我们将公钥和私钥一起同步到虚拟机中

接下来生成ssh key，请先检查主机是否已生成过SSH key C:/……./用户/用户名/.ssh 可查看是否已配置

> ls -al ~/.ssh  #输入这个即可查询是否配置
> 
> #ls （选项）（参数）  
> #ls命令用来显示目标列表，在Linux中是使用率较高的命令
> # -a 显示所有档案及目录（ls内定将档案名或目录名称为“.”的视为影藏，不会列出）；
> # -l与“-C”选项功能相反，所有输出信息用单列格式输出，不输出为多列；
> # cannot access '/c/Users/用户名/.ssh': No such file or directory 即没有配置过

生成 SSH key

ssh-keygen -t rsa -C "[email protected]"
#上面的邮箱替换成自己的

接下来命令行会提示让你指定秘钥的名称，按回车键将 SSH KEY保存到默认文件名即可

Enter a file in which to save the key (/Users/you/.ssh/id_rsa): [Press enter]

设置密码，回车键默认为空密码

再次查看是否配置成功

ls -al ~/.ssh

如下图

SSH秘钥的连个文件

• id_rsa——–SSH秘钥 的 私钥 （Private Key）
• id_ras.pub———SSH秘钥的公钥 （Public Key）

3.共享文件夹配置

可以通过folders来致命本机要映射到Homestead虚拟机上的文件夹

• map对应的是我们本机的文件夹，例如 C:/Code 。
• to对应的是Homestead上的文件夹，即虚拟机中的文件夹。
• 一定一定要注意映射文件夹的大小写名字，否则会出现 no input file specified
• 一定一定要保存修改完后的配置文件，如果没有保存直接配置加载也没关系，你会学习到一系列有趣的问题（手动微笑）

folders:
    - map :~/Code 
    - to:/home/vagrant/Code 

---

联想：

• 相当于在本机修改程序文件，最终是会映射到虚拟机的文件夹上。
• PS：使用IDE最好是轻量级的，例如editplus、sublime等。如果ide有git相关插件。以后每次修改文件，会遍历整个目录树，机器不好的容易卡。例如laravel默认是9000个文件，映射到虚拟机的文件同样是9000个，那么修改代码时，相当于遍历18000个文件。这也间接体现了laravel为什么是重量级框架，集成了现代商业化项目大部分需要的功能。由于是深度配置，所以定制功能时的修改也相对麻烦。
• 关于laravel框架 和 ide 的选择上，适合自己的才是最好的，未必集成的功能越多就越好。具体看项目开发/开发者自身需求

---

默认Homestead会将我们本地的~/Code文件映射到/home/vagrant/Code文件夹上。目前还没有~/Code，需创建

> cd ~
> mkdir Code #在默认路径下创建Code文件夹
> 
> #可使用 explorer .打开该文件夹的视图

4.站点配置（网站根目录映射）

站点配置允许你在唉主机里，通过域名来访问虚拟机的Laravel应用。如下面sites配置所示，将homestead.test映射到一个Laravel项目的public目录上。这一行配置，会命令homestead为我们新建一个Nginx站点，并且把Web Root配置到指定目录下。Laravel应用的Nginx站点 Web Root 配置，默认就是根目录的public目录下

sites:
    - map: homestead.test
      to: /home/vagrant/Code/Laravel/public  #此处的Laravel还没创建，待会会用COMPOSER下载

另外，主机里直接访问虚拟机站点，必须通过绑定hosts来实现。终端需要修改hosts文件绑定到homestead.test到虚拟机IP192.168.10.10上，hosts完整路径为 C:\Windows\System32\Drivers\ect\hosts

> subl C:\Windows\System32\Drivers\ect\hosts

在hosts文件中添加

192.168.10.10  homestead.test

注意：WINDOWS 10因为权限设置相关问题，即使打开了该文件可能也无法修改成功，此处有两种方式替代

1. 打开该路径，复制hosts到任意目录并修改配置，最后覆盖

2. 使用powershell打开并修改
   2.1windows 开始菜单图标【即最左下角的菜单】—> 点击右键

   2.2 单击Windows PowerShell（管理员）

   2.3 cd drivers/etc

   2.4 notepad hosts

5.数据库配置

可以为homestead指定数据库名称，这里使用默认设置即可

databases:
    - homestead

运行Vagrant

完成相关配置后，开启虚拟机
以下为相关命令

命令行	说明	相关例子
vagrant init	初始化vagrant
vagrant up	启动vagrant
vagrant halt	关闭虚拟机	如果直接在cmd中exit 不halt，下次启动会出现仍在运行
vagrant ssh	通过SSH登录vagrant （需要先启动vagrant）	需要在homestead配置公钥而免密码登录
vagrant provision	重新应用更改vagrant配置	类似apache修改配置项后需要重启，此处同理
vagrant reload	重载虚拟机	搭配 vagrant provision && vagrant reload
vagrant destroy	删除vagrant

接下来开启Homestead

> cd ~/Homestead && vagrant up

第一次启动时，vagrant会做以下几件事

• 以导入的Homestead虚拟机盒子为模版，新建一台虚拟机（之前导入的homestead）
• 并按照homestead.yaml里的配置信息，对这台新建的虚拟机进行配置
• 配置完成后启动虚拟机

成功启动后还是在~/Homestead目录中，通过以下命名来来SSH登录Homestead虚拟机中

> vagrant ssh

> exit #退出当前虚拟机

> vagrant halt #关闭整个虚拟机