# 3.0 框架运行环境
> 需要注意以下环境安装文档仅说明msf框架运行的环境依赖，我们已经将运行环境通过Docker标准化，无须手工一步一步安装，如果对此部分不感兴趣，请直接跳转到[Docker](3.3docker.md)
- Linux，FreeBSD，MacOS(有兼容问题)
- Linux内核版本2.3.32以上(支持epoll)
- PHP-7.0及以上版本（生产环境建议使用PHP-7.1）
- gcc-4.4以上版本
- cmake-2.4+，编译为libswoole.so作为C/C++库时需要使用cmake
- [swoole-1.9.15](https://github.com/swoole/swoole-src/archive/v1.9.15.tar.gz)及以上版本（暂不支持Swoole-2.0）
- [hiredis-0.13.3](https://github.com/redis/hiredis/archive/v0.13.3.tar.gz)
- [yac](https://github.com/laruence/yac/archive/yac-2.0.2.tar.gz)
- [phpredis](http://pecl.php.net/get/redis-3.1.2.tgz)
- composer
## 约定
本手册的所有示例代码都是来自[php-msf-demo](https://github.com/pinguo/php-msf-demo)，用户可以克隆后，查看源代码。
## CentOS-6.5
### export
```bash
$>export SRC_DIR=/home/worker/src/
$>export CURL_INSTALL_DIR=${HOME}/libcurl
$>export phpversion=7.1.8
$>export PHP_INSTALL_DIR=${HOME}/php
$>export LIB_MEMCACHED_INSTALL_DIR=/usr/local/
```
### yum
```bash
$>yum -y install \
ca-certificates gcc gcc-c++ perl-CPAN m4 autoconf apr-util yum-utils \
gd libjpeg libtool libpng zlib gettext libevent net-snmp net-snmp-devel net-snmp-libs\
freetype libtool-tldl libxml2 unixODBC inotify-tools \
libxslt libmcrypt freetds ImageMagick jemalloc jemalloc-devel \
gd-devel libjpeg-devel libpng-devel zlib-devel \
freetype-devel libtool-ltdl libtool-ltdl-devel \
libxml2-devel zlib-devel bzip2-devel gettext-devel \
curl-devel gettext-devel libevent-devel \
libxslt-devel expat-devel unixODBC-devel \
openssl-devel libmcrypt-devel freetds-devel \
ImageMagick-devel pcre-devel openldap openldap-devel libc-client-devel
```
### curl
```bash
$>cd ${SRC_DIR} \
&& wget -q -O curl-7.49.0.tar.gz https://curl.haxx.se/download/curl-7.49.0.tar.gz \
&& tar xzf curl-7.49.0.tar.gz \
&& cd curl-7.49.0 \
&& ./configure --prefix=${CURL_INSTALL_DIR} \
&& make 1>/dev/null \
&& make install
```
### libmemcached
```bash
$>cd ${SRC_DIR} \
&& wget -q -O libmemcached-1.0.18.tar.gz https://launchpad.net/libmemcached/1.0/1.0.18/+download/libmemcached-1.0.18.tar.gz \
&& tar xzf libmemcached-1.0.18.tar.gz \
&& cd libmemcached-1.0.18 \
&& ./configure --prefix=$LIB_MEMCACHED_INSTALL_DIR --with-memcached 1>/dev/null \
&& make 1>/dev/null \
&& make install
```
### PHP-7.1.8
```bash
$>cd ${SRC_DIR} \
&& wget -q -O php-${phpversion}.tar.gz http://cn2.php.net/distributions/php-${phpversion}.tar.gz \
&& tar xzf php-${phpversion}.tar.gz \
&& cd php-${phpversion} \
&& ./configure \
--prefix=${PHP_INSTALL_DIR} \
--with-config-file-path=${PHP_INSTALL_DIR}/etc \
--with-config-file-scan-dir=${PHP_INSTALL_DIR}/etc/php.d \
--sysconfdir=${PHP_INSTALL_DIR}/etc \
--with-libdir=lib64 \
--enable-mysqlnd \
--enable-zip \
--enable-exif \
--enable-ftp \
--enable-mbstring \
--enable-mbregex \
--enable-fpm \
--enable-bcmath \
--enable-pcntl \
--enable-soap \
--enable-sockets \
--enable-shmop \
--enable-sysvmsg \
--enable-sysvsem \
--enable-sysvshm \
--enable-gd-native-ttf \
--enable-wddx \
--enable-opcache \
--with-gettext \
--with-xsl \
--with-libexpat-dir \
--with-xmlrpc \
--with-snmp \
--with-ldap \
--enable-mysqlnd \
--with-mysqli=mysqlnd \
--with-pdo-mysql=mysqlnd \
--with-pdo-odbc=unixODBC,/usr \
--with-gd \
--with-jpeg-dir \
--with-png-dir \
--with-zlib-dir \
--with-freetype-dir \
--with-zlib \
--with-bz2 \
--with-openssl \
--with-curl=${CURL_INSTALL_DIR} \
--with-mcrypt \
--with-mhash \
&& make 1>/dev/null \
&& make install
```
### php-yaml
```bash
$>cd $SRC_DIR \
&& wget -O yaml-0.1.5.tar.gz http://pyyaml.org/download/libyaml/yaml-0.1.5.tar.gz \
&& tar xzf yaml-0.1.5.tar.gz \
&& cd yaml-0.1.5 \
&& ./configure --prefix=/usr/local \
&& make >/dev/null \
&& make install \
&& cd $SRC_DIR \
&& wget --http-user=pinguo-ops --http-passwd=iR0n6O3lNk5YtO3vH7Cd http://ops-packages.camera360.com/soft/yaml-2.0.0.tgz \
&& tar xzf yaml-2.0.0.tgz \
&& cd yaml-2.0.0 \
&& $PHP_INSTALL_DIR/bin/phpize \
&& ./configure --with-yaml=/usr/local --with-php-config=$PHP_INSTALL_DIR/bin/php-config \
&& make >/dev/null \
&& make install
```
### php-mongodb
```php
$>cd ${SRC_DIR} \
&& wget http://pecl.php.net/get/mongodb-1.2.8.tgz \
&& tar zxvf mongodb-1.2.8.tgz \
&& cd mongodb-1.2.8 \
&& ${PHP_INSTALL_DIR}/bin/phpize \
&& ./configure --with-php-config=$PHP_INSTALL_DIR/bin/php-config 1>/dev/null \
&& make clean \
&& make -j \
&& make install
```
### php-redis
```bash
$>cd ${SRC_DIR} \
&& wget http://pecl.php.net/get/redis-3.1.2.tgz \
&& tar zxvf redis-3.1.2.tgz \
&& cd redis-3.1.2 \
&& ${PHP_INSTALL_DIR}/bin/phpize \
&& ./configure --with-php-config=$PHP_INSTALL_DIR/bin/php-config 1>/dev/null \
&& make clean \
&& make 1>/dev/null \
&& make install
```
### php-imagick
```bash
$>cd ${SRC_DIR} \
&& wget http://pecl.php.net/get/imagick-3.4.3.tgz \
&& tar zxvf imagick-3.4.3.tgz \
&& cd imagick-3.4.3 \
&& ${PHP_INSTALL_DIR}/bin/phpize \
&& ./configure --with-php-config=$PHP_INSTALL_DIR/bin/php-config 1>/dev/null \
&& make clean \
&& make 1>/dev/null \
&& make install
```
### php-xdebug
```bash
$>cd ${SRC_DIR} \
&& wget http://pecl.php.net/get/xdebug-2.5.3.tgz \
&& tar zxvf xdebug-2.5.3.tgz \
&& cd xdebug-2.5.3 \
&& ${PHP_INSTALL_DIR}/bin/phpize \
&& ./configure --with-php-config=$PHP_INSTALL_DIR/bin/php-config 1>/dev/null \
&& make clean \
&& make 1>/dev/null \
&& make install
```
### php-igbinary
```bash
$cd ${SRC_DIR} \
&& wget http://pecl.php.net/get/igbinary-2.0.1.tgz \
&& tar zxvf igbinary-2.0.1.tgz \
&& cd igbinary-2.0.1 \
&& ${PHP_INSTALL_DIR}/bin/phpize \
&& ./configure --with-php-config=$PHP_INSTALL_DIR/bin/php-config 1>/dev/null \
&& make clean \
&& make 1>/dev/null \
&& make install
```
### php-memcached
```bash
$>cd ${SRC_DIR} \
&& wget http://pecl.php.net/get/memcached-3.0.3.tgz \
&& tar xzf memcached-3.0.3.tgz \
&& cd memcached-3.0.3 \
&& ${PHP_INSTALL_DIR}/bin/phpize \
&& ./configure --enable-memcached --with-php-config=$PHP_INSTALL_DIR/bin/php-config \
--with-libmemcached-dir=$LIB_MEMCACHED_INSTALL_DIR --disable-memcached-sasl 1>/dev/null \
&& make 1>/dev/null \
&& make install
```
### php-yac
```bash
$>cd ${SRC_DIR} \
&& wget https://github.com/laruence/yac/archive/yac-2.0.2.tar.gz \
&& tar zxvf yac-2.0.2.tar.gz \
&& cd yac-yac-2.0.2 \
&& ${PHP_INSTALL_DIR}/bin/phpize \
&& ./configure --with-php-config=${PHP_INSTALL_DIR}/bin/php-config \
&& make 1>/dev/null \
&& make install
```
### phpunit
```bash
$>cd ${SRC_DIR} \
&& wget -O phpunit.phar https://phar.phpunit.de/phpunit.phar \
&& mv phpunit.phar ${PHP_INSTALL_DIR}/bin/phpunit \
&& chmod +x ${PHP_INSTALL_DIR}/bin/phpunit
```
### composer
```bash
$>cd ${SRC_DIR} \
&& curl -sS https://getcomposer.org/installer | $PHP_INSTALL_DIR/bin/php \
&& chmod +x composer.phar \
&& mv composer.phar ${PHP_INSTALL_DIR}/bin/composer
```
### hiredis
```bash
$>cd ${SRC_DIR} \
&& wget -O hiredis-0.13.3.tar.gz https://github.com/redis/hiredis/archive/v0.13.3.tar.gz \
&& tar zxvf hiredis-0.13.3.tar.gz \
&& cd hiredis-0.13.3 \
&& make -j \
&& make install \
&& echo "/usr/local/lib" > /etc/ld.so.conf.d/local.conf \
&& ldconfig
```
### php-swoole
```bash
$>cd ${SRC_DIR} \
&& wget -q -O swoole-1.9.18.tar.gz https://github.com/swoole/swoole-src/archive/v1.9.18.tar.gz \
&& tar zxvf swoole-1.9.18.tar.gz \
&& cd swoole-src-1.9.18/ \
&& ${PHP_INSTALL_DIR}/bin/phpize \
&& ./configure --with-php-config=$PHP_INSTALL_DIR/bin/php-config --enable-async-redis --enable-openssl \
&& make clean 1>/dev/null \
&& make 1>/dev/null \
&& make install
```
### php-inotify
```bash
$>cd ${SRC_DIR} \
&& wget http://pecl.php.net/get/inotify-2.0.0.tgz \
&& tar zxvf inotify-2.0.0.tgz \
&& cd inotify-2.0.0 \
&& ${PHP_INSTALL_DIR}/bin/phpize \
&& ./configure --with-php-config=$PHP_INSTALL_DIR/bin/php-config 1>/dev/null \
&& make clean \
&& make 1>/dev/null \
&& make install
```
### jq
```bash
$>cd ${SRC_DIR} \
&& wget https://github.com/stedolan/jq/releases/download/jq-1.5/jq-linux64 \
&& mkdir -p /home/worker/bin \
&& mv jq-linux64 ${HOME}/bin/jq \
&& chmod +x ${HOME}/bin/jq
```
### git
```bash
$>cd ${SRC_DIR} \
&& mkdir -p ${SRC_DIR} \
&& yum -y remove git \
&& wget https://www.kernel.org/pub/software/scm/git/git-2.13.0.tar.gz \
&& tar zxvf git-2.13.0.tar.gz \
&& cd git-2.13.0 \
&& make configure \
&& ./configure --prefix=/usr/local/ --with-curl=${CURL_INSTALL_DIR} \
&& make -j \
&& make install
```
- 0 文档说明
- 1 为什么研发新框架
- 1.1 传统php-fpm工作模式的问题
- 1.2 压测数据对比
- 1.3 小结
- 2 微服务框架研发概览
- 2.1 通信框架技术选型
- 2.2 swoole
- 2.3 协程原理
- 2.4 异步、并发
- 2.5 小结
- 3 框架运行环境
- 3.1 环境变量
- 3.2 运行代码
- 3.3 docker
- 3.4 小结
- 4 框架结构
- 4.1 结构概述
- 4.2 控制器
- 4.3 模型
- 4.4 视图
- 4.5 同步任务
- 4.6 配置
- 4.7 路由
- 4.8 小结
- 5 框架组件
- 5.1 协程
- 5.2 类的加载
- 5.3 异步Http Client
- 5.4 请求上下文
- 5.5 连接池
- 5.6 对象池
- 5.7 RPC
- 5.8 公共库
- 5.9 RESTful
- 5.10 多语言
- 5.11 杂项
- 5.12 小结
- 6 常见问题
- 7 附录