通过Vagrant搭建laravel 开发环境

怼烎@ 2021-10-23 16:26 456阅读 0赞

# 通过Homestead搭建laravel 开发环境 #

### 1）主要工具:`VirtualBox`,`Vagrant`,`laravel/Homestead` ###

### 2) 使用laravel/Homestead的关键 ###

*  端口转发，使访问宿主机端口或ip或域名，可直接转发到虚拟机中相应的ip地址。
 *  目录映射，使虚拟机的目录与宿主机目录对应，可解决代码或数据存在宿主机上，方便修改。而运行代码时，虚拟机却可以直接读取宿主机上的代码或数据。

# 搭建过程 #

### step.1 安装`VirtualBox`及`Vagrant` ###

去官网下载，傻瓜式安装

### step.2 安装添加`laravel/Homestead Box` ###

$ vagrant box add laravel/homestead
    $ vagrant box list

### step.3 安装Homestead ###

这个是前面`laravel/homestead`的一个配置文件，别人把配置文件也做成一个项目了，特别方便，通过个Hoestead可以快速配置需要的环境。当然有了`laravel/Homestead Box`等于已经有了一个laravel运行的基本环境的操作系统了。

操作如下

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

### step.4 配置端口转发及虚拟域名、ip ###

创建 Homestead.yaml配置文件。 先进入`Homestead`目录

// Linux...
    $ ./ini.sh
    // Windows..
    $ init.bat

打开`Homestead.yaml`如下

---
    ip: "192.168.10.10"
    memory: 2048
    cpus: 2
    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/public
    
    databases:
        - homestead
    
    features:
        - mariadb: false
        - ohmyzsh: false
        - webdriver: false

可以看到`ip` 及 `sites` 这里就是虚拟ip及域名，我们希望在宿主机上通过这个ip或网址就能访问到我们的虚拟主机的laravel项目

怎么配置呢，主要是配置宿主机hosts

Linux 环境下修改这个文件 `/etc/hosts`

windows环境下修改这个文件 `C:\Windows\System32\drivers\etc\hosts`

hosts文件如下：

192.168.10.10 homestead.test

这样，当在浏览器中输入上面的`ip`，或`homestead.test`时，则可以正常访问到虚拟的站点。然而虚拟机的站点内容是什么呢？怎么把开发好的代码放在虚拟机中跑呢？继续看下面

### step.5 配置目录映射 ###

先看一下这个Homestead.yaml中的一段内容

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

在folders中，`map` 表示你主机的目录；`to`表虚拟机中的目录，将来访问虚拟机的这个目录时，将会自动映射去宿主机的目录。

在sites中，`map`表示虚拟域名，在虚拟中，是在虚拟机中哦，访问`homestead.test`（前面的hosts的`homestead.test`与这个是不一样的，也就是前面的homestead.test，只把转向hosts中定义的ip即`192.168.10.10`，而这个ip是虚拟机的），则访问站点，而这个站的根目录就在`/home/vagrant/code/public`这目录，而前面我们知道，虚拟机的`/home/vagrant/code`已经映射到 宿主机的`~/code`目录下了。

所以，这时我们可以知道，只要成laravel项目放在宿主机的这个目录下，虚拟机就能正常运行这个站点代码咯。

创建一个测试文件`~/code/public/index.php` 内容如下：

<?php
    phpinfo();

### step.6 运行虚拟机 ###

$ cd ~/Homestead
    $ vagrant up

浏览器中输入`http://homestead.test` 显示php服务器信息，环境搭建成功。

### step.7 下载安装laravel框架 ###

*  方法一：直接通过`git clone https://github.com/laravel/laravel.git` 把项目放到`~/code`中，注意需要去外git下来的外面的文件夹。目录结构要与Homestead.yaml中的一致； 注意，需要使用`composer install`把依赖安装了。
 *  方法二：通过composer 创建

$ cd ~/code
    $ composer create-project --prefer-dist laravel/laravel  mylaravel

指定版本的，则

$ cd ~/code
    $ composer create-project laravel/laravel  invate  --prefer-dist "5.5.*"

> –prefer-dist 与 --prefer-source的区别
> 
> –prefer-dist 会从github 上下载.zip压缩包，并缓存到本地。下次再安装就会从本地加载，大大加速安装速度。但她没有保留 .git文件夹,没有版本信息。适合基于这个package进行开发。
> 
> –prefer-source 会从github 上clone 源代码，不会在本地缓存。但她保留了.git文件夹，从而可以实现版本控制。适合用于修改源代码。

*  方法三：通过 laravel 的安装器安装，这种方式安装后，会所有依赖都一起安装了很方便

$ composer global require laravel/installer

注意，需要添加环境变量，默认是会自动添加的

macOS: $HOME/.composer/vendor/bin
    GNU / Linux 发行版: $HOME/.config/composer/vendor/bin
    Windows: %USERPROFILE%\AppData\Roaming\Composer\vendor\bin

使用laravel 的安装器创建项目

$ laravel new blog

### step.8 测下框架 ###

输入homestead.test，无限报错（我是使用git clone下来的，laravel依赖还没安装），laravel框架的依赖还需要安装

$ cd ~/code
    $ composer install

> 注意
> 
> 修改了Homestead.yaml后，需要使用`vagrant provision` 重新加载配置。直接使用`vagrant loard`是没有效的

# 使用Homestead的坑 #

## 坑1 启动不了 ##

从git 下载好Homestead后`git clone https://github.com/laravel/homestead.git ~/Homestead`

版本已切换为最新的稳定版本 `git checkout v9.0.7`

进入Homestead文件夹后，执行`vagrant up`后报错

D:\laravel\Homestead>vagrant up
    Check your Homestead.yaml (or Homestead.json) file, the path to your private key does not exist.