ModStart

模块化的快速开发框架

License Apache2.0 GitHub last commit GitHub last release
Laravel Laravel Laravel

ModStart是基于Laravel的模块化快速开发框架

🔥 当前版本

最新版本 GitHub last release，功能完善，模块市场丰富，欢迎交流。

💡 系统简介

ModStart 是一个基于 Laravel 模块化快速开发框架。基于 Apache 2.0 开源协议发布，免费且不限制商业使用。模块市场包含了丰富的模块，后台一键快速安装，让开发者能够从冗长的代码中提效。

功能架构

技术栈

💥 系统特性

  • 简洁优雅、灵活可扩展
  • 后台RBAC权限管理
  • 模块化开发，积木式搭建系统
  • 组件按需加载静态资源
  • 丰富的数据表格、数据表单功能
  • 内置文件上传，无需繁琐的开发
  • 丰富的模块市场，后台一键快速安装

🎨 系统演示

前台演示地址

http://cms.demo.tecmz.com/系统介绍 - 图20 (opens new window)

用户密码自行注册使用

后台演示地址

http://cms.demo.tecmz.com/admin系统介绍 - 图21 (opens new window)

账号：demo 密码：123456 （演示账号只可以查看不能操作）

🌐 开发文档

https://modstart.com/doc系统介绍 - 图22 (opens new window)

🔧 系统安装

环境要求

  • PHP 5.6 或 7.0
  • MySQL >=5.0
  • PHP Extension：Fileinfo
  • Apache/Nginx

强力推荐使用PHP 5.6 或 7.0 版本，系统稳定性最好

安装步骤

  1. 配置 apache/nginx 服务器，请将网站的根目录配置到 <网站目录>/public
  2. 访问 http://www.xxx.com/install.php
  3. 使用安装引导向导进行安装

系统介绍 - 图23

Nginx参考配置

  1. server {
  2.     listen       80;
  3.     server_name  xx.com;x
  4.     charset utf-8;
  5.     index index.php index.html;
  6.     root /var/www/html/xxx.com/public;
  7.     autoindex off;
  8.     location ^~ /.git {
  9.         deny all;
  10.     }
  11.     location / {
  12.         try_files $uri $uri/ /index.php?$query_string;
  13.     }
  14.     location ~ \.php$ {
  15.         fastcgi_pass   127.0.0.1:9000;
  16.         fastcgi_index  index.php;
  17.         fastcgi_param  PHP_VALUE  "open_basedir=/var/www/html/xxx.com/:/tmp/:/var/tmp/";
  18.         fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
  19.         include fastcgi_params;
  20.     }
  21.     location ~ \.(gif|jpg|jpeg|png|bmp|ico|css|js)$ {
  22.        expires max;
  23.     }
  24.     location ~* \.(eot|ttf|woff|woff2)$ {
  25.         add_header Access-Control-Allow-Origin '*';
  26.     }
  27. }

Apache参考配置

  1. <VirtualHost *:80>
  2.     　　ServerName xxx.com
  3.     　　DocumentRoot d:/wwwroot/xxx.com/public
  4. </VirtualHost>

集成环境

环境预检

为方便系统环境快速配置，我们提供了服务器端安装环境预检程序。使用方式如下：

  • 通过连接下载文件 https://modstart.com/env_check.zip ，解压出 env_check.php 文件。
  • 将 env_check.php 文件上传到服务器空间，配置通过访问 http://www.xxx.com/env_check.php 来查看安装环境是否配置成功，如果环境预检成功，可以看到如下提示。

系统介绍 - 图27

升级指南

参照 https://modstart.com/doc/install/upgrade.html系统介绍 - 图28 (opens new window)

版本策略

ModStart 的版本发行将会参考主流 web 框架的发行策略，尽量降低版本升级带来的影响，最大程度的考虑兼容性问题，小版本的升级将尽量不改动任何功能接口；同时我们也将会提供更新日志，详细说明新版本的改动以及可能造成的影响。

对于小版本的发行，开发者可以放心的升级，基本不用担心代码兼容性问题。只有像从 v2.0.0 到 v3.0.0 这样的大版本升级才可能会有兼容性问题，小版本则基本是完全兼容的（小版本升级也可能会有不兼容的情况，但几率很小）。

🔨 快速开发

以一个增删改查页面的基本构成，通过学习下面的内容将可以帮助大家快速理解 ModStart 基本使用方法。

创建数据表

在Laravel的迁移目录创建数据库迁移文件

  1. class CreateNews extends Migration
  2. {
  3.     public function up()
  4.     {
  5.             Schema::create('news', function (Blueprint $table) {
  6.                 $table->increments('id');
  7.                 $table->timestamps();
  8.                 $table->string('title', 200)->nullable()->comment('');
  9.                 $table->string('cover', 200)->nullable()->comment('');
  10.                 $table->string('summary', 200)->nullable()->comment('');
  11.                 $table->text('content')->nullable()->comment('');
  12.             });
  13.         }
  14.     }
  15.     public function down()
  16.     {
  17.     }
  18. }

创建控制器

增加路由控制器代码，同时按照

  1. class NewsController extends Controller
  2. {
  3.     use HasAdminQuickCRUD;
  4.     protected function crud(AdminCRUDBuilder $builder)
  5.     {
  6.         $builder
  7.             ->init('news')
  8.             ->field(function ($builder) {
  9.                 $builder->id('id','ID');
  10.                 $builder->text('title', '名称');
  11.                 $builder->image('cover', '封面');
  12.                 $builder->textarea('summary', '摘要');
  13.                 $builder->richHtml('content', '内容');
  14.                 $builder->display('created_at', '创建时间');
  15.                 $builder->display('updated_at', '更新时间');
  16.             })
  17.             ->gridFilter(function (GridFilter $filter) {
  18.                 $filter->eq('id', 'ID');
  19.                 $filter->like('title', '标题');
  20.             })
  21.             ->title('新闻管理');
  22.     }
  23. }

增加路由和导航

在 routes.php 增加路由信息

  1. $router->match(['get', 'post'], 'news/news', 'NewsController@index');
  2. $router->match(['get', 'post'], 'news/news/add', 'NewsController@add');
  3. $router->match(['get', 'post'], 'news/news/edit', 'NewsController@edit');
  4. $router->match(['get', 'post'], 'news/news/delete', 'NewsController@delete');
  5. $router->match(['get', 'post'], 'news/news/show', 'NewsController@show');

在 ModuleServiceProvider.php 中注册菜单信息

  1. AdminMenu::register(function () {
  2.     return [
  3.         [
  4.             'title' => '新闻管理',
  5.             'icon' => 'list',
  6.             'sort' => 150,
  7.             'url' => '\App\Admin\Controller\NewsController@index',
  8.         ]
  9.     ];
  10. });

这样一个简单的增删改查页面就开发完成了

🌭 开发前必读

开发前的配置

开发环境请打开 debug 模式，方便查看日志文件，操作方式如下：

在 .env 文件中设置 APP_DEBUG=true

📋 常见问题

我们列举了常见问题，请查看官方标准指南

https://modstart.com/doc/qa.html系统介绍 - 图29 (opens new window)

如有其他问题推荐使用官方讨论交流群或在线讨论

https://modstart.com/forum系统介绍 - 图30 (opens new window)

✨ 使用交流

加入我们

如果您对这个项目感兴趣，非常欢迎加入项目开发团队，参与这个项目的功能维护与开发。

欢迎任何形式的贡献（包括但不限于以下）：

  • 贡献代码
  • 完善文档
  • 撰写教程
  • 完善注释
  • …

QQ交流群

QQ交流群：467107293

系统介绍 - 图31