This a php environment for developers. based on Vagrant & CentOS & laravel/homestead

Overview

Centstead

这是一个 PHP 调试环境 , 基于 centos,laravel/homestead.

介绍

  基于开发的实际需求,PHP开发者通常需要一个贴近生产环境,又易于维护的测试与开发环境.以往的选择:

  1. xampp, wamp, phpstudy… 集成环境,启动方便,占用小,但是需要往往不能提供 curl,pgsql,imagick… 插件, 自行编译成本很高。
  2. 基于虚拟机手工搭建一个linux环境,然而虚拟机的初始化过程却相当费时费力。

  似乎易用贴近生产环境很难平衡。 然而 Vagrant 的到来为我们提供了这种可能. Vagrant 提供了一个便捷的方式来管理和设置虚拟机。Vagrant 提出了盒子的概念. 一个盒子即是一个初始化过的虚拟系统, 需要的时候可以基于盒子快速生成虚拟机, 出现错误时又可以在几分钟之内快速销毁重建。

  Centstead 就是一个高度定制的 CentOS + php 盒子, 你可以通过 Centstead 提供的脚本 与 vagrant 命令方便的管理你的虚拟环境。

Centstead 预置软件: (可基于配置快速切换版本)
  • 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

#文档

开始

基础配置

共享文件夹

Nginx 网站配置

定制环境软件

文件拷贝

计划任务

Laravel 队列监听

数据库自动创建

SSH连接/管理虚拟环境

自定义虚拟环境

附录

Vagrant 介绍/技巧

团队配合

Fuck GFW

参与捉虫

开始

安装 & 设置

一、 首次安装

  在使用 Centstead 之前,需要先安装 Virtual BoxVagrant, 它们都提供 windows, mac ,linux 系统的安装程序。

二、安装 Centstead Vagrant 盒子

  VirtualBoxVagrant 安装好了之后, 接着下载 Centstead 盒子, Centstead 默认提供了两个版本的盒子,供自行选择 :

  1. 先锋版 virtualbox_avant.box ,预制 php 7.0 mysql 5.7
  2. 通用版 virtualbox_usual.box ,预制 php 5.6 mysql 5.6
1. 从 Vagrant 官方镜像安装

命令:

vagrant box add jason-chang/centstead-avant
#或者
vagrant box add jason-chang/centstead-usual
2. 从网盘下载安装

下载地址: 百度网盘

下载完成后, 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校验版本后依然会从官方源下载盒子.)

三、通过 GitHub 克隆 Centstead

box 安装完成后, 克隆 Centstead 代码库到任意目录.

cd some/directory
git clone https://github.com/jason-chang/centstead.git centstead

四、初始化配置文件

克隆完成后,cd 到 centstead 目录下 运行 init.sh / init.bat 执行初始化操作.

  1. 如果你使用 mac 或 linux,请执行 bash init.sh
  2. 如果你使用 windows,请执行 init.bat

初始化过程将在 centstead 目录中创建 config 文件夹,config 文件夹下包含两个文件:

config.yaml
主配置文件,几乎所有 censtead 配置工作都是通过修改 config.yaml 实现。文件格式上它遵循 yaml 标准.
after.sh
vagrant provision 完成后的钩子文件,可以用来执行 自定义虚拟环境 操作。

提示:

执行 init 脚本过程中需要安装部分 vagrant 插件,安装过程可能因为 GFW 原因安装失败 请 为 bash / cmd 设置代理.

至此使用 centstead 的脚手架工作都完成了, 然后:

  1. 根据盒子版本在**基础配置** 设置 box 字段 和 version 字段 ,
  2. 根据你的项目目录 配置共享文件夹 ,
  3. 根据你的项目域名 设置 nginx 站点,
  4. 启动 Vagrantbox 就可以享受 centstead 的福利了.

五、启动 Vagrant Box

配置好 config/config.yaml 文件后, 在 Centstead 目录下运行 vagrant up 命令, vagrant 将会启动虚拟机、配置共享文件夹、以及 Nginx 站点(并且写入主机的hosts).

然后,访问你设置的域名开始调试 php 程序吧!

销毁该机器,可以使用 vagrant destroy

为了更好的使用 centstead 请阅读 Vagrant 介绍

推荐:

同时推荐各位 , 使用支持 windows 和 mac 的 GUI 工具 vagrant-manager , 管理你的 Vagrant 虚拟机.

  1. windows 版本
  2. mac 版本

基础配置

配置参数:

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 网站配置

  对 Nginx 不熟?没问题,通过 sites 属性你可以方便地将“域名”映射到 Centstead 虚拟机的指定目录,config.yaml 中默认已经配置了一个示例站点。 和共享文件夹一样,你也可以配置多个站点。(不同于 homestead, Centstead 的站点是基于项目的, 每个项目支持多个子站点)

配置参数:

conf:   项目最终保存成的配置文件
servers:  项目包含的域名 servers
map:   支持的 域名 server name 多个域名可以空格分隔.
to:   指向的项目根入口目录.
type:   站点类型, 支持的配置值:

  1. 不设置/default(普通php站index.php为入口)
  2. static (静态文件站)
  3. proxy (反向代理站)
  4. laravel (项目网站)
  5. thinkphp (thinkphp网站)
  6. 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版本切换

通过 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/MariaDB版本切换

通过 mysql: 配置实现 支持的值: mysql55, mysql56, mysql57, mariadb55, mariadb10, mariadb101 对应不同 Mysql/MariaDB 版本.

示例:

mysql: mariadb101

提示:

Centstead 已经默认将主机的 33060 端口映射到 虚拟主机的 3306 端口。 并且预置了一个权限与 root 相同的 mysql 用户,用户名:vagrant 密码: vagrant。 故此可以通过 vagrant 用户连接 localhost:33060 管理虚拟环境的 Mysql/MariaDB 数据库。

PostgreSql版本切换

通过 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 开发者这里提供了 一个便捷的方式创建, 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连接/管理虚拟环境

连接 SSH

Centstead 已经默认将主机的 2222 端口映射到虚拟机的 22 端口,所以你可以 ssh://vagrant:[email protected]:2222 连接虚拟环境

Vagrant 用户

Centstead 默认添加了权限与 root 相同的 linux 用户,用户名:vagrant 密码: vagrant 故此可以通过 vagrant 用户连接 localhost:2222 管理虚拟机,另外由于 vagrant 具有完全的 sudo 权限, 如果你需要执行一个 root 权限的操作, 可以参考如下

sudo yum install php-yar

切换到 root 用户

  1. 你可以使用 vagrant 用户登录,输入 su -,然后输入密码: vagrant 切换到 root 用户。
  2. 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.service

附录

Vagrant 介绍

Vagrant 一个环境部署的脚手架工具, 在实际的应用中, 它可以支持 aws-ec2 docker …… 众多的类容器环境的部署. 然而本应用中直接把 vagrant 视作管理 Vmware/VirtualBox…… 多种虚拟环境的统一接口.

Vagrant 常用命令

vagrant up
# 初始化并且启动一个虚拟环境(初次执行 up 操作时会附带执行 provision 操作,以后将不会)

vagrant halt
# 关闭虚拟环境

vagrant provision
# 对虚拟环境重新执行初始化操作.
# Centstead 的 "创建nginx 站点","定制环境软件","共享文件夹", "拷贝文件", "自定义虚拟环境", "计划任务创建"都是在这一层执行.
# 所以如果对上述内容修改以后都要执行 `vagrant provision` 应用更改.

vagrant suspend
# 暂停/休眠虚拟环境

vagrant resume
# 恢复虚拟环境

vagtant destroy
# 摧毁虚拟环境
更多内容请看 官方文档

Vagrant Docs

团队配合

Fuck GFW

vagrant provision 前请注意由于GFW的原因初始化过程中,如果需要切换环境软件,可能会出现安装失败,请尽量使用个人ADSL网络,操作前尽量重连ADSL更换IP,然后默念三声 日你妹方校长 (GFW会根据IP计算HTTPS流量,HTTPS流量高后被断链的几率将增大)

为 bash / cmd 设置代理
> 在执行 `init.bat` `init.sh` 的过程中, 需要安装部分 `vagrant` 插件,同样可能会因为 GFW 导致失败.
> 执行之前可以 `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.

Issues
  • 用离线下载的方式 vagrant up会重新下载box

    用离线下载的方式 vagrant up会重新下载box

    HI,使用下面的方式添加的box 好像因为没有version导致vagrant up 启动时会重新下载box vagrant box add ./avant.box --name=jason-chang/centstead-avant

    opened by snowboy8 23
  • 修改系统默认的镜像源

    修改系统默认的镜像源

    把默认的镜像源修改成163等国内比较快的怎么样

    opened by lichunqiang 5
  • 这是什么意思 端口冲突吗?

    这是什么意思 端口冲突吗?

    Bringing machine 'default' up with 'virtualbox' provider... ==> default: Importing base box 'jason-chang/centstead-usual'... ==> default: Matching MAC address for NAT networking... ==> default: Setting the name of the VM: Centstead-1 ==> default: Fixed port collision for 80 => 8000. Now on port 2250. Vagrant found a port collision for the specified port and virtual machine. While this port was marked to be auto-corrected, the ports in the auto-correction range are all also used.

    VM: default Forwarded port: 443 => 44300

    我是用笔记本连接wifi上网的

    opened by clearlove130 1
  • css 本地和stead同步的问题

    css 本地和stead同步的问题

    问题是这样的,本地修改的css,但是访问的时候css还是第一次加载的,而且加载的css内容长度是修改后的css的内容长度,我自己谷歌了下,把nginx.conf中的sendfile参数设置成 off;以及对应站点的conf文件中的sendfile都改成false 但是没有效果 。希望帮忙看看

    进虚拟机看了下 文件 css文件内的全是@ @ 换行显示 ;; @jason-chang

    opened by maokeyang 2
Releases(1.1.4)
Owner
JasonChang
JasonChang
MageVagrant - Vagrant/Chef base box for running Magento

MageVagrant MageVagrant is a complete LAMP development environment for Magento. Specially created for the Magento Developer's Guide book. Features Aut

null 59 Sep 28, 2021
Magento-Vagrant-Puppet-Nginx - Installs magento and a nginx server

Magento-Vagrant-Puppet-Nginx Installs Magento MySQL PHP PHP-FPM Nginx n98-magerun Setup git submodule init git submodule update vagrant up Modify pupp

Christian Münch 63 Dec 3, 2019
Provides a foundation for developing with Magento Commerce in a Vagrant box

Provides a foundation for developing with Magento Commerce in a Vagrant box. The machine is based on CentOS 6.4. ==== List of installed software. Mage

Jason Evans 19 May 12, 2017
Simple Magento 2 Vagrant Box

Magento2 Vagrant Box A simple way to get magento2 up and running. It consists of a Debian Wheezy box provised via Puppet. The provider is Virtual Box.

beeplogic 258 Dec 6, 2021
Web Based Chat Application For Students, Developers, Learners

Web Based Chat Application Motive of this chat Application is to connect similar interest students closer. Many students faces difficulties to solve t

Aman Tamboli 2 Jan 7, 2022
🐘 A probe program for PHP environment (一款精美的 PHP 探針, 又名X探針、劉海探針)

Simplified Chinese | 简体中文 Traditional Chinese(Taiwan) | 正體中文(臺灣) Traditional Chinese(Hong Kong) | 正體中文(香港) Japanese | 日本語 ?? X Prober This is a probe

Km.Van 1.1k Jan 10, 2022
Full PHP development environment for Docker.

Full PHP development environment based on Docker. Use Docker First - Learn About It Later! Join Us Awesome People Laradock is an MIT-licensed open sou

laradock 11.1k Jan 17, 2022
Very flexible git hook manager for php developers

CaptainHook CaptainHook is an easy to use and very flexible git hook library for php developers. It enables you to configure your git hook actions in

CaptainHook 692 Jan 18, 2022
Workshop environment for Decoupled Drupal

Decoupled Drupal Workshop ?? Welcome to the Bluehorn Digital Decoupled Drupal workshop repository! This repository contains a decoupled ready Drupal b

Bluehorn Digital 5 Apr 9, 2021
MajorDoMo is an open-source DIY smarthome automation platform aimed to be used in multi-protocol and multi-services environment.

MajorDoMo (Major Domestic Module) is an open-source DIY smarthome automation platform aimed to be used in multi-protocol and multi-services environment. It is based on web-technologies stack and ready to be delivered to any modern device. It is very flexible in configuration with OOP paradigm used to set up automation rules and scripts. This platform can be installed on almost any personal computer running Windows or Linux OS.

Sergei Jeihala 359 Dec 30, 2021
A simple library to increase the power of your environment variables.

Environment A simple library (with all methods covered by php unit tests) to increase the power of your environment variables, contribute with this pr

João Paulo Cercal 55 Jan 20, 2021
The Phar Installation and Verification Environment (PHIVE)

The Phar Installation and Verification Environment (PHIVE) Installation and verification of phar distributed PHP applications has never been this easy

null 452 Jan 11, 2022
A Magento Development Environment Made of Docker Containers

Docker for Magento 1 Extension Development Tl;dr How do I use this? Clone it. Type docker-compose up -d. Install a Magento Mount your file share. Deve

Michael A. Smith 99 May 10, 2021
A simple shell script which loads a magento environment

A simple shell script to load up a Magento environment and execute PHP code Very experimental and should only be ran on dev servers REQUIRES php pcntl

beeplogic 29 Apr 19, 2021
A dockerized magento 2 community environment ready for development or production.

Painless Magento 2 & 1 A dockerized magento 2 community environment ready for development or production. It supports magento 1.9.x for development Ins

Cocoa Web Studio 8 May 6, 2021
Mage2click toolset to create and manage the Magento Docker development environment with mutagen.io file-sync for macOS and native filesystem mounts on Linux.

Mage2click - Magento Docker Toolset Mage2click toolset is a system-wide command-line tool for creating and managing simultaneously running Magento Doc

Mage2click 69 Dec 14, 2021
WordPlate is a wrapper around WordPress. It makes developers life easier. It is just like building any other WordPress website with themes and plugins. Just with sprinkles on top.

WordPlate is simply a wrapper around WordPress. It makes developers life easier. It is just like building any other WordPress website with themes and plugins. Just with sprinkles on top.

WordPlate 1.6k Jan 16, 2022
The swiss army knife for Magento developers, sysadmins and devops. The tool provides a huge set of well tested command line commands which save hours of work time. All commands are extendable by a module API.

netz98 magerun CLI tools for Magento 2 The n98 magerun cli tools provides some handy tools to work with Magento from command line. Build Status Latest

netz98 689 Jan 9, 2022
Humanize values that are readable only for developers.

PHP Humanizer Tests - 4.x Readme for 4.x version Humanize values to make them readable for regular people ;) Installation Run the following command: c

Coduo 1.5k Dec 27, 2021