Homestead集锦

约定

• > 代表命令运行虚拟机命令行， $ 代表命令运行在Win命令行。

安装步骤¹

1. 首先安装 VictualBox和vagrant；
2. 执行vagrant box add laravel/homestead安装Homestead Vagrant box;

3. 安装Homestead：

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

4. 创建homestead.yaml文件：

   $ cd Homestead
   $ bash init.sh

5. 配置homestead:

   ---
   ip: "192.168.10.10" # 对外 ip
   memory: 2048
   cpus: 2
   provider: virtualbox # Vagrant 提供者
   
   authorize: ~/.ssh/id_rsa.pub
   
   keys:
        ~/.ssh/id_rsa
   folders:    # 共享文件夹 中括号只是避免显示问题，使用时请删除
       [-] map: D:/project
         to: /home/code
   
   sites:     #  Nginx 网站
       [-] map: med-hc-user.medlinker.com     # 本机访问域名
         to:  /home/code/med-hc-user/public # 虚拟机代码路径
         php: "7.0"                         # 使用的PHP版本

6. 修改hosts文件：

   # 此ip地址同 homestead.yaml 文件中的ip
   192.168.10.10  med-hc-user.medlinker.com

7. 启动vagrant:

   $ vargrant up
   # 移除虚拟机
   $ vagrant destroy --force

Homestead下安装php扩展

1. 安装扩展:

   > sudo pecl install 扩展名

2. 修改php.ini的配置文件，添加扩展

   # 修改一下两个文件
   > sudo vim /ect/php/7.1/fpm/php.ini
   > sudo vim /ect/php/7.1/cli/php.ini
   # 在文件中加入扩展
   > extension=扩展名  # 最好写绝对路径，扩展安装成功后会有提示

3. 重新启动php

   # 根据版本不同 有所区别
   > sudo service php7.0-fpm restart

4. 查看扩展是否安装成功

   # 有值则代表成功
   > php -m | grep 扩展名

Homestead+PhpStorm配置Xdebug

前提条件

• Homestead环境已经配置完成；
• php已经安装，且已配置好环境变量；
• PhpStrom已经安装。

配置步骤

1. 安装XDebug,按上面安装php扩展的方法安装xdebug;

2. 配置phpStorm:

   1. 配置vagrant,打开phpStorm的设置窗口，依次点击Preferences -> Tools -> Vagrant，开始配置Vagrant工具选项。

      • Vagrant executable配置vagrant的可执行文件。
      • Instance folder配置vagrant box的所在路径，一般为C:\Users\Administrator\Homestead;
      • Provider手动填写victualbox;

   2. 配置使用的php版本，打开Preferences -> Languages&Frameworks -> PHP，点击CLI Interpreter后面的...,在弹出的窗口中点击左上角的+，选择From Docker,Vagrant,VM，新建一个CLI,remote选择vagrant，Vagrant Instance 与 ①中的Instance folder 地址 一致其他选项依情况配置。
      
   3. 配置XDebug的监听端口，依次打开Preferences -> Languages&Frameworks -> PHP -> Debug,将XDebug>Debug port选项设置为9000，此值应该等同于php.ini配置中的xdebug.remote_port值。
   4. 配置代理，依次打开Preferences -> Languages&Frameworks -> PHP -> Debug -> DBGp Proxy，其中，IDE key同php.ini文件的p保持一致。 Host为虚拟机的ip，Port为③中设置的Debug port

   5. 配置项目信息，依次打开Preferences -> Languages&Frameworks -> PHP -> Servers ，点击左上角+添加项目。
   6. 打开菜单Run ->Edit Configurations，点击左上角+，选择PHP Web Page添加调试应用。

注意事项

• 修改php版本

  > update-alternatives --display php 查看所有 php 版本和当前版本
  > update-alternatives --config php 执行后，会列出当前 php 所有版本和编号，输入编号，切换到执行的版本
  # 或者 如果想切换到 7.0 版本 直接使用
  > php70 

• 如果你在 Homestead box 配置之后更改了 sites 属性，那么应该重新运行 vagrant reload --provision 来更新 Nginx 配置到虚拟机上。

• 在安装Homestead Box时，文件下载可能会很慢甚至报错，此时可以拿到根据命令行显示信息拿到类似

  的地址，此时用第三方工具下载后，再将盒子进行导入，导入步骤如下：

  1. 在此文件的同级目录下，新建metadata.json文件，内容为：

     {
         "name": "laravel/homestead",
         "versions": 
         [
             {
                 // 此处为下载的 box的版本
                 "version": "0.4.4",
                 "providers": [
                     {
                       "name": "virtualbox",
                         // 下载的box的名称
                       "url": "homestead-virtualbox-0.4.4.box"
                     }
                 ]
             }
         ]
     }

  2. 运行vagrant box add metadata.json 进行导入操作；
  3. 导入成功后，运行vagrant box list查看结果。

---

1. https://learnku.com/docs/lara... ↩