#SimfaseDevEnv

#介绍

SimfaseDevEnv是为php开发者提供的开发环境，构建在vagrant之上；Vagrant的Vagrangfile配置文件是在Homestead的ruby脚本之上进行的改变。整体与Homestead很像，但是做了一些更改，为了更适应中国国内的开发网络环境。

相对于Homestead，SimfaseDevEnv有以下主要不同的地方

• vagrant box的安装是本地导入的，不需要在线安装。（国内的网络环境太差）
• PHP版本是5.5 并没有使用php7（php7不是不好,它很优秀，但是目前国内生产环境用php7的不多）
• 全平台（osx/linux/Win)支持nfs（并不是Windows使用samba不好，只是samba不支持软链和硬链 开发symfony、nodejs等项目的时候就烦恼了）
• 软件工具能使用国内源的都切换成了国内源，比如ubuntu软件源、composer 、cnpm[taobao]
• 不生成类似于 .Homestead 的用户配置文件。（为的是可以灵活的安装多个SimfaseDevEnv）
• Windows也可以使用NFS服务

SimfaseDevEnv 可以在任何 Windows、Mac 或 Linux 上面运行，里面包含了 Nginx 网页服务器、PHP 5.5、MySQL、Redis、Memcached Nodejs。

如果使用的Windows,需要在BIOS中启用硬件虚拟化（VT-x）。

#内置软件

• Ubuntu 14.04
• Git 1.8
• PHP 5.5
• Nginx 1.8
• MySQL 5.5
• Node 5.8.0 (With n npm cnpm[taobao] Bower, Grunt, and Gulp)
• Redis 3
• Memcached
• Composer

#安装与配置

###1.安装 VirtualBox 与 Vagrant

在启动SimfaseDevEnv 环境之前，必须先安装 VirtualBox 和 Vagrant.目前SimfaseDevEnv不支持VMware和parallels。

####1.1 VirtualBox安装 Mac与Linux不限制 VirtualBox 版本，但是如果是Win用户建议安装 VitrualBox4.3.12（Win用户点此链接即可下载）

Win用户：VirtualBox安装完成后；如果你的C盘空间不够大，建议打开软件窗口，找到设置入口，点击常规 将默认虚拟电脑位置 更改到其他空间比较大的分区。比如 D:\VirtualBox VMs .

####1.2 Vagrant安装 Mac与Linux不限制 Vagrant 版本，但是如果是Win用户要求安装Vagran 1.7.4（Win用户点此链接即可下载）

因为Vagrant1.8.1 在win7/win10上有不少issue，有些问题还是很严重的。

2 增加 Vagrant 封装包

####2.1 下载simfase-dev-env-0.1.0.box

因为找不到好的方便的免费的http server。索性放到的百度云盘，如果有机会争取切换到我们公司的服务器上去。

####2.2 将simfase-dev-env-0.1.0.box包导入到Vagrant

当下载好simfase-dev-env-0.1.0.box后。你可以在终端机中输入以下命令导入。导入包可能会花费一点时间。

vagrant box add simfase-dev-env /where/is/your/simfase-dev-env-0.1.0.box

注意，Win用户需要注意添加 file:///来指向位置如：

vagrant box add simfase-dev-env file:///d:/download/simfase-dev-env-0.1.0.box

3 安装SimfaseDevEnv

因为SimfaseDevEnv做了一些脚本处理，所以并不能用 vagrant init simfase-dev-env直接初始化。需要下载我们处理过的脚本用作vagrant配置来启动SimfaseDevEnv.

可以将SimfaseDevEnv仓库下载到本地的任意位置，我们建议的是 Mac/Linux 用户将SimfaseDevEnv仓库 git clone 到 ~ 根下。Win用户将SimfaseDevEnv仓库 git clone 到 某盘符 根下。

git clone https://github.com/iMarlboro/SimfaseDevEnv.git SimfaseDevEnv

或者

git clone https://git.oschina.net/marlboro/SimfaseDevEnv.git SimfaseDevEnv

git clone 后，进入 SimfaseDevEnv目录,执行以下代码来初始化SimfaseDevEnv。当然也可以选择手动初始化，很简单，将SimfaseDevEnv/src/stubs下的所有文件，复制到 SimfaseDevEnv根目录下即可。

sh init.sh

注意 Win用户需要使用Cygwin或者Git Bash来执行

此时，就会看 SimfaseDevEnv根目录看到多出了SimfaseDevEnv.yaml等4个文件。

4 配置 SSH 密钥

然后需要编辑 SimfaseDevEnv目录下的SimfaseDevEnv.yaml文件。可以在文件中配置 SSH 公开密钥，以及主要机器与 SimfaseDevEnv 虚拟机之间的共享目录。

如果没有 SSH 密钥的话， 在 Mac 和 Linux 下，可以利用下面的命令来创建一个 SSH 密钥组:

ssh-keygen -t rsa -C "you@email.com"

在 Windows 下，你需要安装 Git 并且使用包含在 Git 里的 Git Bash 来执行上述的命令。另外也可以使用 PuTTY 和 PuTTYgen。

创建了好 SSH 密钥后，在SimfaseDevEnv目录下SimfaseDevEnv.yaml 文件中的 authorize 属性指明密钥路径（默认情况下已经有一个赋值，如果你的authorize不在所对应位置请更改 。 在Win下 ~表示在C盘的user/用户 目录下）。

5 配置共享文件夹

5.1 Mac/Linux

SimfaseDevEnv目录下的SimfaseDevEnv.yaml文件文件中的 folders 属性列出了所有你想在 SimfaseDevEnv 环境共享的文件夹列表。这些文件夹中的文件若有变动，他们将会同步在你的本机与 SimfaseDevEnv 环境里。你可以将你需要的共享文件夹都配置进去。 map表示宿主机器的目录，to表示SimfaseDevEnv环境目录。

如果要开启 NFS，只需要在SimfaseDevEnv.yaml中的 folders 中加入一个标识 type: nfs：

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

5.1 Win7/Win10

如果是Win用户开启NFS，一定要先安装vagrant-winnfsd 插件，使用如下命令：

vagrant plugin install vagrant-winnfsd 

#####可能的情况

部分Win用户可能会提示缺少childprocess,那么还需要先安装childprocess然后再安装vagrant-winnfsd代码如下（按顺执行）：

vagrant plugin install childprocess
vagrant plugin install vagrant-winnfsd 

安装完成后可以通过如下命令查看安装的插件列表

vagrant plugin list

注意：最后还需要增加增在SimfaseDevEnv.yaml的 folders中配置mount_options，切记：

	folders:
		- map: ~/Code
  		to: /home/vagrant/Code
  		type: nfs
  		mount_options: 
  		    - 'nolock,vers=3,udp,noatime'

本部分Win实现NFS，参考了文献speeding-up-homestead-on-windows-using-nfs

如果通过vagrant在线安装插件失败

毕竟vagrant server在国外，如果因为网络问题安装失败，那么可以将 gem包下载到本地再安装

下载childprocess ,点击链接进入后，右下侧有下载链接点击下载

下载vagrant-winnfsd,点击链接进入后，右下侧有下载链接点击下载

下载后，在bash中进入下载的目录运行

vagrant plugin install childprocess-x.x.x.gem 
vagrant plugin install vagrant-winnfsd-x.x.x.gem 

提示 x.x.x 表示你本次下载的软件的版本号

6 Bash Aliases

SimfaseDevEnv目录下的aliases文件中，我们增加了很多命令，方便在使用过程中快速操作（后面的章节会详细讲解用法），如果要增加 Bash aliases 到你的 SimfaseDevEnv 封装包中，只要将内容添 到aliases 文件中即可。

7 启动 Vagrant 封装包

编辑完 SimfaseDevEnv.yaml 后，在终端机里进入SimfaseDevEnv 文件夹并执行 vagrant up 命令。

Vagrant 会将虚拟机开机，并且自动配置共享目录。如果要移除虚拟机，可以使用 vagrant destroy --force 命令（这是彻底铲除虚机，不要轻易操作）。下面列表一些常用vagrant 命令

• vagrant up命令，开机。

• vagrant suspend 将虚拟机置于休眠状态。这时候主机会保存虚拟机的当前状态。再用vagrant up启动虚拟机时能够返回之前工作的状态。这种方式优点是休眠和启动速度都很快，只有几秒钟。缺点是需要额外的磁盘空间来存储当前状态。

• vagrant halt 则是关机。如果想再次启动还是使用vagrant up命令，不过需要多花些时间。

• vagrant destroy 则会将虚拟机从磁盘中删除。如果想重新创建还是使用vagrant up命令。

• vagrant reload 从Vagrantfile重新启动虚拟机。

• vagrant global-status 输出所有虚拟机当前运行状态，关机、已启动等。

SimfaseDevEnv中的aliases和after.sh仅仅在第一次 vagrant up是载入并执行加入到SimfaseDevEnv环境中，如果在这之后对它们进行过改动,且认为会使用到，那么需要进行以下命令重新载入shell

vagrant up --provision

至此，SimfaseDevEnv安装完成!

#常见用法

SSH 连接SimfaseDevEnv

要通过 SSH 连接上的 SimfaseDevEnv 环境，在终端机里进入 SimfaseDevEnv 根 目录并执行 vagrant ssh 命令。如果是Mac/Linux用户并开启了NFS，启动SimfaseDevEnv时，还会提示输入宿主机器当前用户密码。

另外，SimfaseDevEnv环境中目前有两个用户，root/vagrant 与 vagrant/vagrant

连接数据库

在 SimfaseDevEnv 封装包中，已经预装了 MySQL 数据库。

如果想要从本机上通过 Navicat 或者 Sequel Pro 连接 MySQL 数据库，可以连接 127.0.0.1 的端口 33061 (MySQL) 。而帐号密码是 homestead / secret或者root / 123456

注意： 从本机端应该只能使用这些非标准的连接端口来连接数据库。因为当程序如 Laravel 运行在虚拟机时，在 Laravel 的数据库配置文件中依然是配置使用默认的 3306 连接端口。

添加Nginx站点

在SimfaseDevEnv 环境中，Nginx的配置文件是/etc/nginx/nginx.conf，Nginx的站点配置文件放置在/usr/local/etc/nginx/sites中。

在开发过程中可能会需要增加多个 Nginx 站点来运行不同的开发程序。SimfaseDevEnv 环境添加多站点是否非常简单的。运行以下命令即可。

serve domain.app /home/vagrant/Code/path/to/public/directory

上面的命令，将为 /home/vagrant/Code/path/to/public/directory目录的站点添加一个Nginx配置文件到/usr/local/etc/nginx/sites中，同时添加了ssl配置，通过openssl生成的key相关文件在/usr/local/etc/nginx/ssl中。如此项目不仅仅可以通过http访问，同时可以通过https访问。并且，本函数自动的在Nginx中添加了pathinfo以及 index.php重定向（就是所谓的优雅路径），这种配置对当前的大部分框架是通用的，比如 Laravel、Kohana、Codeigniter、Lumen、Thinkphp等等等

注意添加完站点后，别忘了在宿主机器中添加hosts。如Mac/Linux 是在 /etc/hosts文件中，Win是在C:\Windows\System32\drivers\etc\hosts中。

添加虚拟域名有两种方法，第一种方法直接指向到SimfaseDevEnv环境如下：

192.168.11.11 domain.app

这种方法可以在宿主机器中使用浏览器直接访问 http://domain.app 或者 https://domain.app

第二种方法，指向到宿主机器

127.0.0.1 domain.app

这种方法可以在宿主机器中使用浏览器访问http://domain.app:8001 或者 https://domain.app:44301

####其他一些Nginx 辅助命令 另外，提供了其他一些快捷的创建Nginx站点的函数如：

serve-base domain.app /home/vagrant/Code/path/to/public/directory

以上命令与serve类似，但是不进行index.php 路径rewrite。此类配置方法适用于多文件程序，如wordpress、typecho等等

serve-symfony2 domain.app /home/vagrant/Code/path/to/public/directory

以上命令与serve类似，但是是专门针对symfony2框架的，将index.php的重定向，换成了app_dev.php

针对Nginx的命令，只是为了方便用户快速的创建Nginx配置，一些非通用的配置还是需要开发者手动的添加与编辑。

添加Mysql数据库

在SimfaseDevEnv环境中，mysql的配置文件位置在 /etc/mysql/my.cnf 在SimfaseDevEnv中预设了两个mysql超级用户 root/123456 和 homestead/secret (此用的创户是为了方便laravel开发者)

添加数据库可以使用mysql命令创建数据库，或通过 Navicat 、Sequel Pro 连接 MySQL 数据库来创建。

或者使用SimfaseDevEnv提供的函数来快速创建，使用方法

create-mysql database-name

连接端口

以下的端口将会被转发至 SimfaseDevEnv 环境：

• SSH: 2222 → Forwards To 22 (此端口是不可配置的，Vagrant会根据端口冲突情况自动更改)
• HTTP: 8001 → Forwards To 80
• HTTPS: 44301 → Forwards To 443
• MySQL: 33061 → Forwards To 3306

####增加额外端口

也可以自定义转发额外的端口至 Vagrant box，只需要指定协议：

	ports:
		- send: 93000
  		to: 9300
		- send: 7777
  		to: 777
  		protocol: udp

SimfaseDevEnv默认IP

SimfaseDevEnv的默认ip是192.168.11.11，如果需要更换成其他ip在SimfaseDevEnv.yaml中配置即可。

#备份与恢复

SimfaseDevEnv环境还提供方便的备份与恢复工具。为了方便大家升级SimfaseDevEnv时或者迁移数据时使用。

备份MySql

backup-mysql

此命令将mysql数据直接备份至 /vagrant/src/backup/mysql/db-年月日时分秒.sql

同时备份至 /vagrant/src/backup/mysql/latest.sql

恢复Mysql

import-mysql  db-年月日时分秒.sql

此命令将mysql数据直接将 /vagrant/src/backup/mysql/db-年月日时分秒.sql 恢复至当前数据库

备份Nginx

backup-nginx

此命令将/usr/local/etc/nginx 所有配置文件直接压缩备份至 /vagrant/src/backup/nginx/年月日时分秒.tar.gz

同时备份至 /vagrant/src/backup/nginx/latest.tar.gz

恢复Nginx

import-nginx 年月日时分秒.tar.gz

此命令将直接将 /vagrant/src/backup/nginx/年月日时分秒.tar.gz 恢复至当前系统的/usr/local/etc/nginx

备份所有

backup-all

此命令同时执行了backup-mysql 和 backup-nginx

恢复所有

import-all

此命令同时将latest.sql 和 latest.tar.gz恢复到当前系统

#软件说明

PHP

PHP的配置目录在/etc/php

sudo service php5-fpm start  //开启
sudo service php5-fpm stop //关闭
sudo service php5-fpm restart//重启

PHP安装了这些扩展

• apc
• apcu
• bcmath
• bz2
• calendar
• Core
• ctype
• curl
• date
• dba
• dom
• ereg
• exif
• fileinfo
• filter
• ftp
• gd
• gettext
• gmp
• hash
• iconv
• imap
• json
• libxml
• mbstring
• mcrypt
• memcache
• memcached
• mhash
• mysql
• mysqli
• mysqlnd
• openssl
• pcntl
• pcre
• PDO
• pdo_mysql
• pdo_pgsql
• pdo_sqlite
• pgsql
• Phar
• posix
• readline
• redis #默认未关闭 php的redis扩展。 laravel Redis Alias与扩展名重名，建议将laravel 的 Redis Alias改成Predis为佳。如果要关闭redis扩展，sudo php5dismod redis命令即可，开启也很简单 sudo php5enmod redis
• Reflection
• session
• shmop
• SimpleXML
• soap
• sockets
• SPL
• sqlite3
• standard
• sysvmsg
• sysvsem
• sysvshm
• tokenizer
• wddx
• xml
• xmlreader
• xmlwriter
• Zend OPcache
• zip
• zlib

Nginx

Nginx的配置目录在/etc/nginx/nginx.conf

sudo service nginx start  //开启
sudo service nginx stop //关闭
sudo service nginx restart//重启

MySql

MySql的配置文件在/etc/mysql/my.cnf

sudo service mysql start  //开启
sudo service mysql stop //关闭
sudo service mysql restart//重启

Memcached

Memcached的配置文件是 /etc/memcached.conf

sudo service memcached start  //开启
sudo service memcached stop //关闭
sudo service memcached restart//重启

Redis

Redis的配置文件是redis.conf

Redis默认是不自动启动的，需要手动启动。启动方法

sudo redis-server /etc/redis/redis.conf

关闭redis

sudo pkill redis-server

Nodejs

Nodejs 是使用n-install进行的安装，只在当前用户下进行了环境声明，所以使用nodejs的时候 不需要使用sudo，也不能使用sudo,除非开发者在全局环境中再声明一下。

相应的安装了

• n 可去看看文档
• Nodejs 已经安装了5.8.0 ，比如需要安装4.4.0 只需要n 4.4.0即可
• npm
• cnpm 使用的是淘宝NPM镜像，一般情况下请使用cnpm 而不是npm，因为npm源在qiang外太慢了。
• Bower
• Grunt
• Gulp

Composer

Composer 已经安装，同时将repo仓库地址改成了https://packagist.phpcomposer.com 。详见pak.phpcomposer ,Composer中文手册

一般情况下使用phpcomposer是没有问题的，但是phpcomposer与官方库同步并不是很频繁，如果某个软件的版本已经在官方更新，但是phpcomposer并没有同步过来这时候就会出现composer update/install错误，解决的方法就是 切换为官方https://packagist.org/ 库，切换方法将 ~/.composer 中的 config.json置空就行。或者在composer.json中将某个出问题的require指定上一个版本后再重新composer update/install，能暂时解决问题，等phpcomposer更新后，再删除版本指定。

升级composer时，请使用sudo

#其他

SimfaseDevEnv实现方法

SimfaseDevEnv环境 是基于ubuntu官方提供的vagrant box之上进行的扩展

SimfaseDevEnv环境的实现过程脚本都放在 SimfaseDevEnv/src/install中，有兴趣的开发者可以看看，有任何bug请不要吝啬提交issue。但是不要在当前SimfaseDevEnv中执行这些脚本，因为当前的SimfaseDevEnv已经将初始环境都安装好了。