利用 Vagrant 实现 Laravel 多个开发环境 (Ubuntu 18.4、Ubuntu 16.4) (with Bug)

日景的个人博客 / 0 / 0 / 创建于 6年前

开发 laravel，虽然用 Homestead 十分方便，但 Homestead 在某种程度是个黑盒子，也无法用在生产环境，在最后的部署，依然会吃尽苦头，所以不妨利用 vagrant，快速、方便打造一个与生产环境相近的开发环境。
本文暂未在 Windows 系统中测试，其中 将本地与虚拟机文件同步类型改为 nfs ，根据 vagrant 文档，暂不支持 Windows 系统，所以本文很有可能不适用于 Windows 系统。

1. 利用 vagrant，安装多个系统

前往 vagrant 官网下载页面，下载、安装 vagrant。另外，自行安装 VirtualBox
vagrant 安装 Ubuntu 18.4、Ubuntu 16.4
- 在 vagrant cloud，可以下载、安装 box，一步到位，但下载过程太过漫长，建议按下述方式分开进行。
- 下载 box
  - 前往 http://cloud-images.ubuntu.com/ ，用下载软件下载相应的 vagrant box
- 将下载好的 box 复制到相应的目录，添加 box
  - vagrant box add ubuntu16 xenial-server-cloudimg-amd64-vagrant.box
  - vagrant box add ubuntu18 bionic-server-cloudimg-amd64-vagrant.box
- 初始化 box。这里的 box 名称，与上一步的名称一致
  - vagrant init ubuntu16
  - vagrant init ubuntu18
- 这时目录下多了一个 Vagrantfile 文件，取消这个文件中这一行的注释：config.vm.network "forwarded_port", guest: 80, host: 8080
  - 由于挂载多个系统，注意后者的 host 端口不要冲突，我将 ubuntu18 设为 8018，ubuntu16 设为 8016
- 启动 box：vagrant up
- 此时，在 VirtualBox 可以看到两个系统已经打开
参考文档，同步本地及虚拟机文件
- 修改 Vagrantfile，把 # config.vm.synced_folder "../data", "/vagrant_data" 修改为：config.vm.synced_folder "/Users/dayscene/code", "/home/vagrant/code" ，注意调整 /Users/dayscene/code 为个人本地目录。
- 重启虚拟机：vagrant reload --provision
- 进入 box：vagrant ssh ，发现在 /home/vagrant 目录下多了一个 code 目录，其中文件与本地文件一致。

2. 安装 Nginx，MySQL，PHP

主要参考 digitalocean 的这篇文章搭建 LNMP

进入 box：vagrant ssh 。进入后，先更新系统安装源：sudo apt-get update
安装 Nginx：sudo apt-get install nginx
- 在浏览器中分别访问 http://localhost:8018/、http://localhost:8016/，看到 Nginx 默认页面，表示 Nginx 安装成功。
安装 MySQL 5.7：sudo apt-get install mysql-server
- 在 ubuntu16，安装过程中会跳出设置 root 用户密码的弹窗。
- 在 ubuntu18，需要额外配置：
  - sudo mysql_secure_installation
  - root 用户默认采用 auth_socket 登录，因此无法直接通过 mysql -uroot -p 登录，需要稍作修改：
    - 先进入 mysql：sudo mysql
    - 修改 root 用户：alter user 'root'@'localhost' identified with mysql_native_password by 'password'; 最后一个单词 password，需要改为你的密码
    - 更新修改：flush privileges;
    - 查看 root 用户的 plugin 是否为 mysql_native_password：select user,authentication_string,plugin,host from mysql.user;
安装 PHP 7.2
- 在 ubuntu16，PHP 默认源的版本是 7.0，目前 Laravel 5.7 要求 PHP 的最低版本是 7.1，显然不能满足开发需求。参考这篇文章，安装 PHP 7.2
  - 增加 ppa 源：
    - sudo apt-get install python-software-properties
    - sudo add-apt-repository ppa:ondrej/php
    - sudo apt-get update
  - 安装 PHP：sudo apt-get install php7.2-fpm php7.2-mysql
- 在 ubuntu18，直接安装：sudo apt-get install php-fpm php-mysql
- 在两个系统查看 PHP 的安装版本：php -v ，都是 PHP 7.2
安装 composer
- 先安装依赖：sudo apt-get install curl php-cli php-mbstring git unzip
- 下载 installer：curl -sS https://getcomposer.org/installer -o composer-setup.php
- 验证 installer：
  - 前往 https://composer.github.io/pubkeys.html，复制 SHA-384 签名
  - 利用 PHP 自带的 hash_file 函数进行验证：
    - php -r "if(hash_file('SHA384','composer-setup.php')==='上一步复制的 SHA-384 签名') {echo 'verified';} echo PHP_EOL;"，如果输出 verified，表示通过验证。
- 执行安装：sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
- 删除 installer：rm composer-setup.php
- 可选：如果后续 composer 安装太慢，可以使用 laravel-china 的国内镜像
  - composer config -g repo.packagist composer https://packagist.laravel-china.org
至此，已基本完成开发环境的搭建，新建一个项目看看：composer create-project laravel/laravel blog --prefer-dist "5.7.*"
- 发现报错：Your requirements could not be resolved to an installable set of packages.
- 原因是部分 PHP 扩展没有安装，安装扩展：sudo apt-get install php7.2-xml
- 删除上一步安装失败的 blog 项目：rm -rf blog/ ，再次安装，没有报错。
- 虽然当前安装没有问题，后续 composer 安装第三库时仍可能出现此类问题，届时再按类似方法解决：
  - 在搜索引擎此类报错是由于哪个扩展没有安装引起
  - 查找安装源是否有这个扩展：sudo apt list | grep php7.2 ，若有，即可直接安装。
配置 Nginx。Nginx 的配置文件在 /etc/nginx 目录，打开该目录，发现其网站配置结构为：在 sites-available 目录添加各个网页配置，若想该配置生效，再在 sites-enabled 目录创建一个软链接
- 创建一个配置文件：sudo vi /etc/nginx/sites-available/blog.test ，参考 laravel 文档部署，写入：
```
server {
    listen 80;
    server_name blog.com;
    root /home/vagrant/code/blog/public;

    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location = /favicon.ico { access_log off; log_not_found off; }
    location = /robots.txt  { access_log off; log_not_found off; }

    error_page 404 /index.php;

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php7.2-fpm.sock;
    }

    location ~ /\.(?!well-known).* {
        deny all;
    }
}
```
- 创建一个软链接：sudo ln -s /etc/nginx/sites-available/blog.test /etc/nginx/sites-enabled/
- 删除默认配置文件：sudo unlink /etc/nginx/sites-enabled/default
- 测试配置文件语法是否正确：sudo nginx -t
- 重启 Nginx：sudo service nginx reload
浏览器中访问，发现 laravel 报错："/home/vagrant/code/blog/storage/logs/laravel-2019-01-14.log" could not be opened: failed to open stream: Permission denied
- 看回 laravel 文档安装，需要给 storage 、bootstrap/cache 目录写入权限，于是调整这两个目录的权限：sudo chmod -R 777 storage/ bootstrap/cache 。然而，这个操作并不生效。
- 搜索一番，问题应该出在本地及虚拟机共享文件夹，但惭愧的是，我没有找到解决方法。后来，我将共享文件的类型改为 nfs ，暂时解决了这个问题：
  - 再次修改 Vagrantfile ，把之前修改的 config.vm.synced_folder "/Users/dayscene/code", "/home/vagrant/code" ，增加一个 type ：config.vm.synced_folder "/Users/dayscene/code", "/home/vagrant/code", type: "nfs" 。取消这行的注释，增加私有网络设置：config.vm.network "private_network", ip: "192.168.33.10"
  - 再重启虚拟机：vagrant reload --provision
  - 此时，已经可以修改相应目录的权限。在浏览器也可以看到 laravel 默认页面。