xwom 是基于 Yii2 的综合管理业务快速开发引擎 [ 1.0 版本 ]

本引擎采用YII V2.0.32搭建，其运行环境与yii2(php>=5.6)一致。
xwom旨在为yii2爱好者提供一个基础功能稳定完善的系统，使开发者更专注于业务功能开发。xwom没有对yii2做任何的修改、封装，但是把yii2的一些优秀特性几乎都用在了xwom上， 但xwom提倡简洁、快速上手，基于xwom开发可以无需文档，可以在此基础开发其实际应用，譬如：cms内容管理系统、门户网站、商城、ERP、OA、采编、采集等。

一、更新记录Records

1.0.0beta1 开启xwom开发引擎beta1，预装常用扩展组件，对配置文件做细致的注释说明。

二、帮助Help

（1）QQ群： 170794993 欢迎xwom爱好者加入。

（2）Email： chareler@163.com

（3）如有纰漏或不足，勿吐槽，欢迎提出建议，直接Issues 或 Email。

三、功能

• 多语言
• 菜单管理
• GII 模板
• 加载X-admin (layui) 模板
• RBAC实现管理员、角色、部门、团队、单位、应用 6个维度权限管理
• 开启API应用
• 计划管理
• 流程管理WorkFlow（BPM）工作流驱动业务数据流转
• 全栈全局设置管理
  包括：
  • 全栈基础配置
  • 全栈邮件配置
  • 全栈短信配置
  • 全栈多语言包管理
  • 全栈搜索引擎配置
  • 全栈DB引擎配置
  • 全栈数据可视化迁移
  • 全栈变量配置
  • 全栈常量配置
  • 全栈API设置
  • 系统信息
  • IP黑名单
• 全栈日志管理
  • 全局日志
  • 短信日志
  • 邮件日志
  • 行为日志
• 开启APP子应用开发

四、快速体验Experience

demo地址 http://xwom.womtech.cn 测试管理员账号：参见QQ群 170794993 群内公告

更多核心功能，请继续关注

友情提示：数据每天、每6小时，将还原更新一次，如果您提交操作数据，如果不见了，切勿诧异，您懂的。

五、项目说明：

1、管理台项目在site1——backend（站点1）->web，m站项目在site1——backend（站点1）->wap

2、前台项目在site2——frontend（站点2）->web，m站的在site2——frontend（站点2）->wap

3、API项目在site3——API （站点3 )->web，m站的在site3——API （站点3 )->wap

4、项目的框架、外部扩展、组件基本上通过composer来管理

六、项目结构和注意事项，请参看

开发注意事项，请参看开源地址：https://github.com/jinowom/xwom_open 的readme.md 的第十小节、第十一小节、第十二小节。

七、运行效果

八、安装 Installation

友情提示：建议php版本>=7.1
开源地址：https://github.com/jinowom/xwom_open
克隆当前项目

git clone https://github.com/jinowom/xwom_open.git

1、composer install or composer install --ignore-platform-reqs

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

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

3、配置web服务器

4、完成
附:web服务器配置

• Apache

  <VirtualHost *>
    ########此处下面是xwom开发引擎开源地址#
    DocumentRoot path/to/xwom/backend/web/
  ServerName localhost
    #<Directory "path/to/xwom/backend/web/">
    ########此处下面是xwom开发引擎开源地址#
    <Directory "path/to/xwom/backend/web/">
      
            #SetOutputFilter DEFLATE
            #Options FollowSymLinks
            #Options Indexes FollowSymLinks Includes MultiViews ExecCGI
            Options Indexes FollowSymLinks MultiViews
            AllowOverride All
            Order allow,deny
            Allow from all
            DirectoryIndex index.html index.php
  
            # use mod_rewrite for pretty URL support
            RewriteEngine on
            # If a directory or a file exists, use the request directly
            RewriteCond %{REQUEST_FILENAME} !-f
            RewriteCond %{REQUEST_FILENAME} !-d
            # Otherwise forward the request to index.php
            RewriteRule . index.php
    </Directory>
  </VirtualHost>
  

• Nginx

   略
  

九 配置Configuration

common/main-local.php

    'components' => [
        'db' => [
            'class' => 'yii\db\Connection',
            'dsn' => 'mysql:host=localhost;dbname=xxx',
            'username' => 'xxx',
            'password' => '',
            'charset' => 'utf8',
        ],
        //……
    ],

backend/main.php

    'modules' => [
        /** migration数据库库迁移模块业务 **/
        'migration' => [
            'class' => 'migration\Module',
        ],
        //……
        /**  workflow BPM2.0**/
        'workflow' => [
            'class' => 'jinostart\workflow\manager\Module',
            'layout' => '//main',
        ],
    ],

    'components' => [
     //……
        /** workflow BPM2.0    * **/
        'view' => [
            'theme' => [
                'pathMap' => [
                    '@app/views' => '@backend/themes/default/views',
                    '@app/widgets' => '@backend/themes/default/widgets',
                    '@vendor/jinostart/yii2-workflow-manager/src/views' => '@backend/themes/default/modules/workflow/views'
                ],
            ],
        ],
        'workflowSource' => [
            'class' => 'jinostart\workflow\manager\components\WorkflowDbSource',
        ],
        //……
    ],

backend/main-local.php

//加载 kartikgii扩展组件，并集成自定义Gii，美哒哒 
  $config['modules']['gii']['class'] = 'yii\gii\Module';
  $config['modules']['gii']['allowedIPs'] = ['127.0.0.1','::1'];//只允许本地访问gii  用逗号隔开，添加自己的指定地址
  $config['modules']['gii']['generators'] = [
          'kartikgii-crud' => ['class' => 'warrence\kartikgii\crud\Generator'],
        /*重新定义gii model & crud的生成模板*/
         'model'=> [
             'class' => 'yii\gii\generators\model\Generator',
             'baseClass'=> 'base\BaseActiveRecord',
             'templates'=> [
                 'xwom'=>'@backend/components/gii/model/default',
             ]
         ],
         'module'=> [
             'class' => 'yii\gii\generators\module\Generator',
             'templates'=> [
                 'xwom'=>'@backend/components/gii/module/default',
             ]
         ],
         'crud' => [
             'class' => \backend\components\gii\crud\Generator::class,//'class' => \backend\components\gii\crud\Generator::className(),
             'templates' => [
                 'xwom' => '@backend/components/gii/crud/default',
                 'default' => '@vendor/yiisoft/yii2-gii/src/generators/crud/default',//这是yii 自己自带的
             ]
         ],
         'controller' => [
             'class' => \backend\components\gii\controller\Generator::class,
             'templates' => [
                 'xwom' => '@backend/components/gii/controller/default',
                 'default' => '@vendor/yiisoft/yii2-gii/src/generators/controller/default',//这是yii 自己自带的
             ]
         ],
         'extension' => [
             'class' => \backend\components\gii\extension\Generator::class,
             'templates' => [
                 'xwom' => '@backend/components/gii/extension/default',
                 'default' => '@vendor/yiisoft/yii2-gii/src/generators/controller/default',//这是yii 自己自带的
             ]
         ],
      ];

十、特别鸣谢Links

• Yii2
• Yii2 Extension
• 开发组成员：WeihuaWang YanchengLiu CharlesLee