README

基于yii2的CMS系统，运行环境与yii2（php≥5.4）一致。费希CMS旨在为yii2爱好者提供一个功能稳定、完善的系统，使开发者能更专注于业务功能的开发。费希CMS没有对yii2做任何修改或封装，但将yii2的一些优秀特性几乎都应用在了费希CMS上。虽然提供了文档，但费希CMS推崇简洁、快速上手，基于费希CMS进行开发时无需文档，反而费希CMS为yii2文档提供了最好的实例。

演示站点

演示站点后台 用户名:feehicms 密码123456

• 后台 http://demo.cms.feehi.com/admin
• 前台 http://demo.cms.feehi.com
• api http://demo.cms.feehi.com/api/articles

更新记录

帮助

1. 开发文档http://doc.feehi.com

2. QQ群 936448696

3. 微信
   

4. Email [email protected]

5. bug反馈

功能

• 多语言
• 单元测试
• 功能测试
• 验收测试
• RBAC权限管理
• restful api
• 文章管理
• 操作日志
• 适配手机

费希CMS提供完备的web系统基础通用功能，包括前后台菜单管理、文章标签、广告、banner、缓存、网站设置、SEO设置、邮件设置、分类管理、单页...

使用Docker

1.下载镜像

    $ docker pull registry.cn-hangzhou.aliyuncs.com/feehi/cms #FQ后建议直接使用docker pull feehi/cms

2.创建容器

    $ docker run --name feehicms -h feehicms -itd -v /path/to/data:/data -e DBDSN=sqlite:/data/feehi.db -e TablePrefix=feehi_ -e AdminUsername=admin -e AdminPassword=123456 -p 8080:80 feehi/cms

以上命令将自动初始化费希CMS，并导入数据库（默认数据库为sqlite）
如果需要使用其他数据库，如mysql，执行

    $ docker run --name feehicms -h feehicms -itd -e DBDSN=mysql:host=mysql-ip;dbname=feehi -e DBUser=dbuser -e DBPassword=dbpassword -e TablePrefix=feehi_ -e AdminUsername=admin -e AdminPassword=123456 -p 8080:80 feehi/cms

如果需要使用postgresql，则将DBDSN改为pgsql:host=pgsql-ip

也可以仅初始化费希CMS，然后通过web在线安装

    $ docker run --name feehicms -h feehicms -itd -p 8080:80 feehi/cms -o start

然后访问http://ip:port/install.php，根据提示选择数据库类型，填写数据库用户名、数据库密码、后台管理员用户名、密码完成安装。

以上方式启动的容器只能用作开发环境，容器启动命令最终调用为php -S 0.0.0.0:80，如果用作production，可以执行

    $ docker run --name feehicms -h feehicms -itd -p 8080:80 feehi/cms -m start

容器将启动php-fpm，并监听9000端口，配合nginx使用。nginx配置大致为

    location ~ \.php$ {
        ...
        fastcgi_pass fpm-ip:9000;
        fastcgi_param  SCRIPT_FILENAME  /usr/local/feehicms/frontend/web$fastcgi_script_name;
        ...
    }

因为yii2会生成js/css，以及新上传的文件（图片）需要nginx webroot使用php fpm容器同一个文件夹:/usr/local/feehicms/frontend/web

安装

前置条件：如未特别说明，本文档已默认您已将php命令加入环境变量，如果您未将php加入环境变量，请将以下命令中的php替换成/path/to/php

无论是使用归档文件还是composer，都有相应阶段让您填入后台管理用户名、密码

1. 使用归档文件（简单，适合没有yii2经验者）

   1. 下载费希CMS源码 点击此处下载最新版
   2. 解压到目录
   3. 配置web服务器web服务器配置
   4. 浏览器打开 https://127.0.0.1/install.php 按照提示完成安装（若使用php内置web服务器则地址为 https://127.0.0.1:8080/install.php）
   5. 完成

2. 使用composer（推荐使用此方式安装）

   有关composer的安装以及国内镜像设置，请点击 此处

   以下命令默认您已全局安装composer，如果您是局部安装的composer：请使用php /path/to/composer.phar来替换以下命令中的composer

   1. 使用composer创建费希CMS项目

          $ composer create-project feehi/cms webApp //此命令创建的FeehiCMS项目不能平滑升级新版本(目录结构简单,目前主力维护版本)

   2. 依次执行以下命令初始化yii2框架以及导入数据库

      $ cd webApp
      $ php ./init --env=Development #初始化yii2框架，线上环境请使用--env=Production
      $ php ./yii migrate/up --interactive=0 #导入FeehiCMS sql数据库，执行此步骤之前请先到common/config/main-local.php修改成正确的数据库配置

   3. 配置web服务器web服务器配置

   4. 完成

运行测试

1. 仅运行单元测试、功能测试（不需要配置web服务器）

   cd /path/to/webApp
   vendor/bin/codecept run

1. 运行单元测试、功能测试、验收测试（需要配置完web服务器）
   1. 分别复制backend、frontend、api三个目录下的tests/acceptance.suite.yml.example到各自目录，并均重命名为acceptance.suite.yml，且均修改里面的url为各自的访问url地址
   2. 与上（仅运行单元测试、功能测试）命令一致

项目展示

• 山东城市服务技师学院
• 优悦娱乐网
• 吉安市食品药品监督管理局
• 完美娱乐
• 房产网
• 中丞法拍网
• 51前途网
• 用友财务软件
• ......

运行效果