feehi/cms-core

Feehi CMS core

FeehiCMS (English) 首款编写单元测试、功能测试、验收测试的yii2开源系统

基于yii2的CMS系统，运行环境与yii2(php>=5.4)一致。FeehiCMS旨在为yii2爱好者提供一个基础功能稳定完善的系统，使开发者更专注于业务功能开发。 FeehiCMS没有对yii2做任何的修改、封装，但是把yii2的一些优秀特性几乎都用在了FeehiCMS上，虽提供文档， 但FeehiCMS提倡简洁、快速上手，基于FeehiCMS开发可以无需文档，反倒FeehiCMS为yii2文档提供了最好的实例, _(*1)

, _(*2)

更新记录

2.0.0 修复bug,增加1.0.0系列alpha、beta、rc版所有的功能, _(*3)

1.0.0rc2 修复bug, _(*4)

1.0.0rc1 优化使用, _(*5)

1.0.0beta 3 修复bug, _(*6)

1.0.0beta2 增加自定义图片类型设置,优化管理员角色创建和修改, _(*7)

1.0.0beta1 修复bug, _(*8)

1.0.0alpha3 重写文章tag,修复两次model validate, _(*9)

1.0.0alpha2 修复bug, _(*10)

1.0.0alpha1 增加restful api,单元测试,行为测试,验收测试,替换为yii2最新模板,优化composer安装依赖替换fxp/composer-asset-plugin为Asset Packagist,重写rbac权限管理替换为yii2内置实现, _(*11)

0.1.3 版本已经集成swoole作为FeehiCMS应用服务器，详细配置及使用参见yii2-swoole, _(*12)

帮助

1. 开发文档http://doc.feehi.com, _(*13)

2. QQ群 258780872, _(*14)

3. 微信
   , _(*15)

4. Email job@feehi.com, _(*16)

5. bug反馈, _(*17)

功能

• 多语言
• 单元测试
• 功能测试
• 验收测试
• RBAC权限管理
• restful api
• 文章管理

• 操作日志, _(*18)

  FeehiCMS提供完备的web系统基础通用功能，包括前后台菜单管理,文章标签,广告,banner,缓存,网站设置,seo设置,邮件设置,分类管理,单页..., _(*19)

快速体验

1. 使用演示站点 演示站点后台 用户名:feehicms 密码123456, _(*20)

   • php7.0.0
     • 后台 http://demo.cms.feehi.com/admin
     • 前台 http://demo.cms.feehi.com
     • api http://demo.cms.feehi.com/api/articles
   • swoole (docker)
     • swoole演示前台 http://swoole.demo.cms.qq.feehi.com
     • swoole演示后台 http://swoole-admin.demo.cms.qq.feehi.com
   • php7.1.8 (docker)
     • 备用演示前台1 http://demo.cms.qq.feehi.com
     • 备用演示api1 http://demo.cms.qq.feehi.com/admin
     • 备用演示后台1 http://demo.cms.qq.feehi.com/api
   • php5.4 (docker)
     • 备用演示前台2 http://php54.demo.cms.qq.feehi.com
     • 备用演示后台2 http://php54.demo.cms.qq.feehi.com/admin
     • 备用演示api2 http://php54.demo.cms.qq.feehi.com/api

2. 使用Docker容器, _(*21)

   $ docker pull registry.cn-hangzhou.aliyuncs.com/liufee/cms
   $ docker run --name feehicms -h feehicms -itd -p 80:80 liufee/cms
   

安装

前置条件: 如未特别说明，本文档已默认您把php命令加入了环境变量，如果您未把php加入环境变量，请把以下命令中的php替换成/path/to/php 1. 使用归档文件(简单，适合没有yii2经验者), _(*22)

使用此方式安装，后台超管用户名和密码会在安装过程中让您填入 1. 下载FeehiCMS源码 点击此处下载最新版 2. 解压到目录 3. 配置web服务器(参见下面) 4. 浏览器打开 http://localhost/install.php 按照提示完成安装(若使用php内置web服务a器则地址为 http://localhost:8080/install.php ) 5. 完成, _(*23)

1. 使用composer (推荐使用此方式安装), _(*24)

   使用此方式安装，默认的后台超级管理员用户名admin密码123456, _(*25)

   composer的安装以及国内镜像设置请点击 此处, _(*26)

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

   1. 使用composer下载创建FeehiCMS项目 以下两个命令任选其一。如果喜欢简单且日后不需要升级FeehiCMS请选择命令一,如果日后需要平滑升级FeehiCMS请选择命令二, _(*28)

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

      bash $ composer create-project feehi/feehicms webApp //此命令创建的FeehiCMS项目能够通过运行composer update平滑升级到FeehiCMS新版本(FeehiCMS以composer包提供,未来可能主力维护此版本), _(*29)

   2. 依次执行以下命令初始化yii2框架以及导入数据库 bash $ cd webApp $ php ./init --env=Development #初始化yii2框架，线上环境请使用--env=Production $ php ./yii migrate/up --interactive=0 #导入FeehiCMS sql数据库，执行此步骤之前请先到common/config/main-local.php修改成正确的数据库配置
   3. 配置web服务器(参加下面)
   4. 完成

附:web服务器配置(注意是设置"path/to/frontend/web为根目录), _(*30)

• php内置web服务器(仅可用于开发环境,当您的环境中没有web服务器时), _(*31)

  cd /path/to/cms
  php ./yii serve  
  
  #至此启动成功，可以通过localhost:8080/和localhost:8080/admin来访问了，在线安装即访问localhost:8080/install.php
  

• Apache, _(*32)

  DocumentRoot "path/to/frontend/web"
  <Directory "path/to/frontend/web">
    # 开启 mod_rewrite 用于美化 URL 功能的支持（译注：对应 pretty URL 选项）
    RewriteEngine on
    # 如果请求的是真实存在的文件或目录，直接访问
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    # 如果请求的不是真实文件或目录，分发请求至 index.php
    RewriteRule . index.php
  
    # ...其它设置...
  </Directory>
  

• Nginx, _(*33)

  server {
   server_name  localhost;
   root   /path/to/frontend/web;
   index  index.php index.html index.htm;
   try_files $uri $uri/ /index.php?$args;
  
   location ~ /api/(?!index.php).*$ {
      rewrite /api/(.*) /api/index.php?r=$1 last;
   }
  
   location ~ \.php$ {
       fastcgi_pass   127.0.0.1:9000;
       fastcgi_index  index.php;
       fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
       include        fastcgi_params;
       try_files $uri=404;
   }
  }
  

运行测试

1. 仅运行单元测试,功能测试(不需要配置web服务器) bash cd /path/to/webApp vendor/bin/codecept run
2. 运行单元测试,功能测试,验收测试(需要配置完web服务器)
   1. 分别拷贝backend,frontend,api三个目录下的tests/acceptance.suite.yml.example到各自目录，并均重名为acceptance.suite.yml,且均修改里面的url为各自的访问url地址
   2. 与上(仅运行单元测试,功能测试)命令一致

项目展示

• lcs消费金融
• 吉安市食品药品监督管理局
• 微信公众号益乐游戏
• Usens Dev博客
• 最美容颜
• 云上旅游集团
• 微信公众号蚂蚁鲜生
• ......

运行效果

, _(*34)

, _(*35)

, _(*36)

, _(*37)

, _(*38)

, _(*39)

, _(*40)