这是一个 PHP 调试环境 , 基于 centos,laravel/homestead.
基于开发的实际需求,PHP开发者通常需要一个贴近生产环境,又易于维护的测试与开发环境.以往的选择:
- xampp, wamp, phpstudy… 集成环境，启动方便，占用小，但是需要往往不能提供 curl,pgsql,imagick… 插件, 自行编译成本很高。
- 基于虚拟机手工搭建一个linux环境，然而虚拟机的初始化过程却相当费时费力。
似乎易用与贴近生产环境很难平衡。 然而 Vagrant 的到来为我们提供了这种可能. Vagrant 提供了一个便捷的方式来管理和设置虚拟机。Vagrant 提出了盒子的概念. 一个盒子即是一个初始化过的虚拟系统, 需要的时候可以基于盒子快速生成虚拟机, 出现错误时又可以在几分钟之内快速销毁重建。
Centstead 就是一个高度定制的 CentOS + php 盒子, 你可以通过 Centstead 提供的脚本 与 vagrant 命令方便的管理你的虚拟环境。
- CentOS 7
- PHP 5.4 / 5.5 / 5.6 / 7.0
- Mysql 5.5 / 5.6 / 5.7
- MariaDB 5.5 / 10 / 10.1
- PostgreSQL 9.2 / 9.3 / 9.4 / 9.5
- Composer
- Nginx
- Redis
- Sqllite3
- Supervisor
- Xdebug
- Nodejs (npm webpack gulp bower)
- memcached
- Beanstalkd
#文档
在使用 Centstead 之前，需要先安装 Virtual Box 和 Vagrant, 它们都提供 windows, mac ,linux 系统的安装程序。
VirtualBox 和 Vagrant 安装好了之后, 接着下载 Centstead 盒子, Centstead 默认提供了两个版本的盒子,供自行选择 :
- 先锋版 virtualbox_avant.box ,预制 php 7.0 mysql 5.7
- 通用版 virtualbox_usual.box ,预制 php 5.6 mysql 5.6
命令:
vagrant box add jason-chang/centstead-avant
#或者
vagrant box add jason-chang/centstead-usual下载地址: 百度网盘
下载完成后, cd 到 .box 所在目录, 执行命令将 box 添加到 Vagrant 环境.
cd downlods/path
vagrant box add ./avant.box --name=jason-chang/centstead-avant
或者
vagrant box add ./usual.box --name=jason-chang/centstead-usual注意
网盘下载安装盒子的同学，在 初始化 后一定要修改
config/config.yml文件，去掉#version: ">=0"行前的注释#。 (因为vagrant离线形式安装盒子无法定义版本信息，如不开启此项,，vagrant校验版本后依然会从官方源下载盒子.)
box 安装完成后, 克隆 Centstead 代码库到任意目录.
cd some/directory
git clone https://github.com/jason-chang/centstead.git centstead克隆完成后,cd 到 centstead 目录下 运行 init.sh / init.bat 执行初始化操作.
- 如果你使用 mac 或 linux，请执行
bash init.sh - 如果你使用 windows，请执行
init.bat
初始化过程将在 centstead 目录中创建 config 文件夹，config 文件夹下包含两个文件:
config.yaml
主配置文件，几乎所有censtead配置工作都是通过修改config.yaml实现。文件格式上它遵循 yaml 标准.
after.sh
vagrant provision完成后的钩子文件，可以用来执行 自定义虚拟环境 操作。
提示:
执行 init 脚本过程中需要安装部分 vagrant 插件，安装过程可能因为 GFW 原因安装失败 请 为 bash / cmd 设置代理.
至此使用 centstead 的脚手架工作都完成了, 然后:
- 根据盒子版本在**基础配置** 设置
box字段 和version字段 , - 根据你的项目目录 配置共享文件夹 ,
- 根据你的项目域名 设置 nginx 站点,
- 启动 Vagrantbox 就可以享受 centstead 的福利了.
配置好 config/config.yaml 文件后, 在 Centstead 目录下运行 vagrant up 命令, vagrant 将会启动虚拟机、配置共享文件夹、以及 Nginx 站点(并且写入主机的hosts).
然后,访问你设置的域名开始调试 php 程序吧!
销毁该机器，可以使用 vagrant destroy
为了更好的使用 centstead 请阅读 Vagrant 介绍
推荐:
同时推荐各位 , 使用支持 windows 和 mac 的 GUI 工具 vagrant-manager , 管理你的 Vagrant 虚拟机.
配置参数:
ip: 虚拟机 ip
memory: 虚拟机内存
cpus: 虚拟机 cpu 核心数
provider: 虚拟机容器.(Vagrant 默认可以提供 多种虚拟机容器, 包括 Vmware 和 VirtualBox, 但是 Vmware 支持是付费的, 本人无米暂时只能支持 VirtualBox)
box: 基础盒子名称
version: 基础盒子版本, 此项默认关闭/注释, 离线安装盒子的用户请开启。
示例:
ip: "192.168.10.10"
memory: 2048
cpus: 1
provider: virtualbox
box: jason-chang/centstead-usual
#version: ">=0"config.yaml 文件中的 folders 属性列出了所有主机和 Centstead 虚拟机共享的文件夹，一旦这些目录中的文件有了修改，将会在本地和 Centstead 虚拟机之间保持同步，如果有需要的话，你可以配置多个共享文件夹（一般一个就够了）：
配置参数:
map: 主机文件目录
to: 映射到虚拟机的目录
type: 同步类型: 1.默认为空表示使用 shareFolder. 2. nfs （推荐） 表示使用 nfs 同步.
示例:
folders:
- map: ~/Projects
to: /home/vagrant/Projects如果要开启 NFS，只需简单添加一个标识到同步文件夹配置，如下:
folders:
- map: ~/Projects
to: /home/vagrant/Projects
type: nfs 对 Nginx 不熟？没问题，通过 sites 属性你可以方便地将“域名”映射到 Centstead 虚拟机的指定目录，config.yaml 中默认已经配置了一个示例站点。
和共享文件夹一样，你也可以配置多个站点。（不同于 homestead, Centstead 的站点是基于项目的, 每个项目支持多个子站点）
配置参数:
conf: 项目最终保存成的配置文件
servers: 项目包含的域名 servers
map: 支持的 域名 server name 多个域名可以空格分隔.
to： 指向的项目根入口目录.
type: 站点类型, 支持的配置值:
- 不设置/default(普通php站index.php为入口)
- static (静态文件站)
- proxy (反向代理站)
- laravel (项目网站)
- thinkphp (thinkphp网站)
- symfony (symfony2网站)
port： http 监听端口
ssl: https 监听端口
aliases： 所有在 centstead 中配置的站点 centstead 将智能的加入主机的 hosts 文件中, 这样当 vagrant 启动完成的时候后，可以直接浏览配置的域名了。
centstead 默认取 map 值加入 hosts 文件，但是由于 hosts 文件并不是非常强大, 类似 **.demo.app 的泛解析域名将不能支持, aliases 就是为此提供的自定义接口, 如果配置存在 aliases 则抓取 aliases 加入 hosts 文件
示例:
sites:
- conf: demo.app
servers:
- map: static.demo.app
to: /home/vagrant/Projects/Demo/static
type: static
- map: "demo.app *.demo.app"
to: /home/vagrant/Projects/Demo
aliases: "demo.app a.demo.app u.demo.app www.demo.app"
# port: 80
# ssl: 443默认情况下，每个站点都可以通过 HTTP（端口号：8000）和 HTTPS（端口号：44300）进行访问.
提示:
配置完成后, 执行
vagrant up就可以通过浏览器调试指定的网站了.如果是已经启动过的环境请执行vagrant provision应用新的站点配置.
为了更加贴近实际的生产环境, 我们往往需要配置特定的 php, mysql, postgre 版本. centstead 为此提供了非常简便的配置支持.
注意:
编辑
config.yaml后别忘了执行vagrant provision使配置生效。
通过 php: 配置实现
支持的值: php54, php55, php56 php70 对应不同 php 版本.
示例:
php: php70提示:
Centstead 已经默认配置好所有 php 版本的 xdebug 支持，只需要配合 xdebug helper + phpstorm/eclipse …… 远程调试 php 了。(默认调用调试端口 9000)
所有 php 版本均默认安装了, redis, memcached, postgre, mysql, gd, imgick, mbstring, mcrypt, curl, openssl, xdebug 插件, 但是如果 你还需要 安装 yar 呢怎么办, 去 自定义虚拟环境 看看.
通过 mysql: 配置实现
支持的值: mysql55, mysql56, mysql57, mariadb55, mariadb10, mariadb101 对应不同 Mysql/MariaDB 版本.
示例:
mysql: mariadb101提示:
Centstead 已经默认将主机的 33060 端口映射到 虚拟主机的 3306 端口。 并且预置了一个权限与 root 相同的 mysql 用户，用户名：vagrant 密码: vagrant。 故此可以通过
vagrant用户连接localhost:33060管理虚拟环境的Mysql/MariaDB数据库。
通过 pgsql: 配置实现
支持的值 pgsql92, pgsql93, pgsql94, pgsql95, 对应不同 PostgreSql 版本.
示例:
pgsql: pgsql95提示:
虽然国内使用
postgre的用户越来越多, 但是始终不如mysql, 所以默认盒子并没有安装postgre
但是配置此值稍等几分, PostgreSql 就配置好了
Centstead 已经默认将主机的 54320 端口映射到 虚拟主机的 5432 端口.
并且添加了权限与 root 相同的 postgre 用户, 用户名：vagrant 密码: vagrant.
故此可以通过 vagrant 用户连接 localhost:54320 管理虚拟机 PostgreSql 数据库.
初始化过程中我们可能想要将部分文件拷贝到虚拟环境, 配置可以参考如下
配置参数:
from: 文件所在目录
to: 拷贝到虚拟机的目录
示例：
copy:
- from: ~/copy.demo
to: /home/vagrant/copy.demo提示:
拷贝文件支持 目录和文件，但是不支持覆盖，如果要同步修改，请使用共享文件夹配置.
无论测试环境还是生产环境，我们都可能执行一些长期/定期轮训的任务, 通过 centstead 你可以方便的创建 crond 任务.
配置参数:
name: 任务名称
user：任务执行的用户
interval: 任务的执行频率
command: 任务的执行命令
示例：
schedules:
- name: redis_demo
user: vagrant
interval: "* 0 */1 * *"
command: "/usr/bin/redis-cli -h localhost DEL 'some-throttle'"如果你是一名 Laravel 开发者这里提供了 一个便捷的方式创建, Laravel 队列监听。
配置参数:
name: supervisor任务名称
driver：队列的驱动
queue: 队列名称
dir: 项目artisan所在目录
示例：
queues:
- name: demo.app.mails
driver: redis
queue: emails
dir: /home/vagrant/Code/Demo重要提示：
由于 vagrant 共享文件夹的挂载晚于 linux supervisor 系统服务, 每次
vagrant halt重启虚拟机后, 可能发现队列监听失效了.
请等待共享文件夹挂载完毕后，连入 SSH, 然后执行sudo systemctl restart supervisord.service重启队列监听.
然后可以通过ps aux | grep artisan命令验证队列监听是否在工作。
通常我们可能希望为不同的项目, 创建不同的虚拟机环境, 那么为什么不在虚拟机配置时自动生成相应数据库呢？
配置参数:
db: 数据库所在容器, 默认mysql.
示例：
databases:
- name: vagrant
- name: vagrant
db: pgsql注意:
postgre 用户再启动过程中可能会发现如下错误，请忽略: could not change directory to "/home/vagrant": 权限不够
连接 SSH
Centstead 已经默认将主机的 2222 端口映射到虚拟机的 22 端口，所以你可以 ssh://vagrant:vagrant@127.0.0.1:2222 连接虚拟环境
Vagrant 用户
Centstead 默认添加了权限与 root 相同的 linux 用户，用户名：vagrant 密码: vagrant 故此可以通过 vagrant 用户连接 localhost:2222 管理虚拟机，另外由于 vagrant 具有完全的 sudo 权限, 如果你需要执行一个 root 权限的操作, 可以参考如下
sudo yum install php-yar切换到 root 用户
- 你可以使用 vagrant 用户登录，输入
su -，然后输入密码: vagrant 切换到 root 用户。 - Centstead 默认修改内置的 root 用户密码为 vagrant, 可以直接使用密码
vagtant连接root用户。
公钥认证
如果你 配置了 authorize: 类似如下
authorize: ~/.ssh/id_rsa.pub则可以通过公钥认证，连接vagrant用户。
私钥导入虚拟环境
大多数情况下，我们的开发工作会是在实机环境，但是偶尔还是会在虚拟环境执行一些， github 或者 gitlab 的 pull/push 操作.
为虚拟机单独生成并导入一个秘钥？ NO
配置 keys: 就好了, Centstead 就会将指定的私钥文件导入到虚拟环境。
keys:
- ~/.ssh/id_rsa没有任何一个软件, 能够完全满足定制化的需求。
如果我们的虚拟环境, 需要其他的运行时软件, 或者 php 插件怎么办？
Centstead 为这种需求提供了一个钩子文件,就是 config.yaml 同级目录下的 after.sh 文件.
每次 vagrant provision 执行的最后都会执行这个钩子.
例如安装 yar 的需求，我们就可以编辑 after.sh 如下:
#!/bin/sh
# 安装 yar 插件
yum install php-yar
systemctl restart php-fpm.serviceVagrant 一个环境部署的脚手架工具, 在实际的应用中, 它可以支持 aws-ec2 docker …… 众多的类容器环境的部署. 然而本应用中直接把 vagrant 视作管理 Vmware/VirtualBox…… 多种虚拟环境的统一接口.
vagrant up
# 初始化并且启动一个虚拟环境（初次执行 up 操作时会附带执行 provision 操作，以后将不会）
vagrant halt
# 关闭虚拟环境
vagrant provision
# 对虚拟环境重新执行初始化操作.
# Centstead 的 "创建nginx 站点"，"定制环境软件"，"共享文件夹"， "拷贝文件"， "自定义虚拟环境"， "计划任务创建"都是在这一层执行.
# 所以如果对上述内容修改以后都要执行 `vagrant provision` 应用更改.
vagrant suspend
# 暂停/休眠虚拟环境
vagrant resume
# 恢复虚拟环境
vagtant destroy
# 摧毁虚拟环境> 在执行 `init.bat` `init.sh` 的过程中, 需要安装部分 `vagrant` 插件，同样可能会因为 GFW 导致失败.
vagrant provision前请注意由于GFW的原因初始化过程中，如果需要切换环境软件，可能会出现安装失败，请尽量使用个人ADSL网络，操作前尽量重连ADSL更换IP，然后默念三声日你妹方校长(GFW会根据IP计算HTTPS流量,HTTPS流量高后被断链的几率将增大)
> 执行之前可以 `set http_proxy=http://127.0.0.1:1080/`, 为 `cmd` 或者 `bash` 设置一个 `http` 代*理.
> 注意:全局设置的代理对于 `bash/cmd` 是不能生效的必须通过，`set http_proxy` 命令配置.
邮件: chaoyue.chang#qq.com 微信: sisisiy 交流反馈QQ群: 286807539
反馈问题及提出改进请发 Issue 或者 Pull Request.