ModStart?是一個基于?Laravel?模塊化極速開發(fā)框架。模塊市場擁有豐富的功能應用，支持后臺一鍵快速安裝，讓開發(fā)者能快的實現(xiàn)業(yè)務功能開發(fā)。

系統(tǒng)完全開源，基于?Apache 2.0?開源協(xié)議，免費且不限制商業(yè)使用。

ModStart?致力于服務開發(fā)者，為開發(fā)者節(jié)省時間，讓大家有更多的時間讀書、健身、開源、投資、幫朋友、陪家人，感謝您支持我們的開源事業(yè)。

• 官方網(wǎng)站
• Demo / 在線演示
• 模塊市場
• 源碼地址 / 碼云
• 源碼地址 / GitHub

技術棧

• Laravel
• Vue
• Element UI
• jQuery
• ...

特性

• 簡潔優(yōu)雅、靈活可擴展
• 后臺RBAC權限管理
• Ajax頁面無刷新
• 組件按需加載靜態(tài)資源
• 內(nèi)置豐富的表格常用功能
• 內(nèi)置文件上傳，無需繁瑣的開發(fā)
• 模塊市場，只需在管理頁面點擊鼠標即可完成插件的安裝、更新和卸載等操作

功能一覽

• 會員模塊通用且完整，支持完整的API調用
• 大文件分片上傳，進度條顯示，已上傳文件管理
• 強大的模塊擴展功能，所有模塊可以無縫集成，支持在線安裝、卸載模塊
• 完善的開發(fā)助手，實現(xiàn)模塊、主題的的一鍵創(chuàng)建
• 完善的后臺權限管理，支持基于RBAC的權限管理系統(tǒng)
• 后臺管理支持使用手機、平板、PC，無論何時何地都可方便管理
• 第三方登錄（QQ、微信、微博、支付寶、微信小程序）
• 第三方支付支持（微信、支付寶、支付寶當面付、微信掃碼、微信小程序）
• 第三方云存儲支持，支持云儲存分片上傳（阿里云、百度云、華為云、騰訊云、FTP、七牛云、UCloud、又拍云）
• 第三方短信支持（阿里云、騰訊云、華為云、百度云、253云通訊、聚合、七牛云、融云、賽郵、UCloud、云片、網(wǎng)易云）
• 豐富優(yōu)秀的模塊支持：
  • 視頻點播課
  • 一物一碼防偽溯源
  • 文章投稿系統(tǒng)
  • Markdown文檔管理
  • 視頻管理系統(tǒng)
  • 郵件營銷系統(tǒng)
  • 視頻直播系統(tǒng)
  • 文庫系統(tǒng)
  • 相冊系統(tǒng)
  • 問答系統(tǒng)
  • IT工具箱
  • 幫助中心系統(tǒng)
  • 短連接系統(tǒng)
  • 論壇系統(tǒng)
  • 個人博客系統(tǒng)
  • 發(fā)卡系統(tǒng)
  • 積分商城
  • 兼職招聘系統(tǒng)
  • 課程報名系統(tǒng)
  • 活動報名系統(tǒng)
  • 簡單商城系統(tǒng)
  • 網(wǎng)盤系統(tǒng)
  • 微信公眾號管理系統(tǒng)
  • 在線客服系統(tǒng)
  • 圖床系統(tǒng)
  • 通用CMS系統(tǒng)

加入我們

如果您對這個項目感興趣，非常歡迎加入項目開發(fā)團隊，參與這個項目的功能維護與開發(fā)。

歡迎任何形式的貢獻（包括但不限于以下）：

• 貢獻代碼
• 完善文檔
• 撰寫教程
• 完善注釋
• ...

安裝

環(huán)境要求

• Laravel 5.1 版本

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

• Laravel 9.0 版本

  • PHP 8.0?PHP 8.1
  • MySQL?>=5.0
  • PHP Extension：Fileinfo
  • Apache/Nginx

安裝步驟

1. 配置 apache/nginx 服務器，請將網(wǎng)站的根目錄配置到 <網(wǎng)站目錄>/public
2. 訪問?http://www.xxx.com/install.php
3. 使用安裝引導向導進行安裝

Nginx參考配置

server {
    listen       80;
    server_name  xx.com;x
    charset utf-8;
    index index.php index.html;
    root /var/www/html/xxx.com/public;
    autoindex off;
    location ^~ /.git {
        deny all;
    }
    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
    location ~ \.php$ {
        fastcgi_pass   127.0.0.1:9000;
        fastcgi_index  index.php;
        fastcgi_param  PHP_VALUE  "open_basedir=/var/www/html/xxx.com/:/tmp/:/var/tmp/";
        fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
    location ~ \.(gif|jpg|jpeg|png|bmp|ico|css|js)$ {
       expires max;
    }
    location ~* \.(eot|ttf|woff|woff2)$ {
        add_header Access-Control-Allow-Origin '*';
    }
}

Apache參考配置

    　　ServerName xxx.com
    　　DocumentRoot d:/wwwroot/xxx.com/public

集成環(huán)境

• 寶塔一鍵安裝教程：https://modstart.com/doc/install/baota.html
• PHPStudy一鍵安裝教程：https://modstart.com/doc/install/phpstudy.html
• WampServer安裝教程：https://modstart.com/doc/install/wampserver.html
• Docker一鍵安裝教程：https://modstart.com/doc/install/docker.html
• 原生環(huán)境安裝教程：https://modstart.com/doc/install/start.html

環(huán)境預檢

為方便系統(tǒng)環(huán)境快速配置，我們提供了服務器端安裝環(huán)境預檢程序。使用方式如下：

1. 通過連接下載文件?https://modstart.com/env_check.zip?，解壓出?env_check.php?文件。
2. 將?env_check.php?文件上傳到服務器空間，配置通過訪問?http://www.xxx.com/env_check.php?來查看安裝環(huán)境是否配置成功，如果環(huán)境預檢成功，可以看到如下提示。

升級指南

ModStart?的升級需要執(zhí)行以下基本步驟，請確保每個步驟正確。

說明：升級前請全量備份網(wǎng)站數(shù)據(jù)庫和代碼，避免升級操作有誤造成系統(tǒng)不能正常運行。

自動升級

從1.5.0開始，系統(tǒng)提供自動升級功能。當有新版本出現(xiàn)時，在后臺可以通過自動升級操作一鍵升級。

在自動升級前請備份好舊的系統(tǒng)數(shù)據(jù)，避免升級失敗造成的數(shù)據(jù)丟失等情況。

手動升級

1 舊的系統(tǒng)備份

假如舊系統(tǒng)的部署目錄為?/wwwroot/test.com， 請重新命名為?/wwwroot/test.com.bk

Linux參考命令

mv /wwwroot/test.com /wwwroot/test.com.bk

Windows參考操作

請按照描述自行操作

2 解壓最新的代碼

解壓最新的代碼到?/wwwroot/test.com

Linux參考命令

mkdir -p /wwwroot/test.com
cp xxx.zip /wwwroot/test.com
cd /wwwroot/test.com
unzip xxx.zip

Windows參考操作

請按照描述自行操作

3 遷移自安裝模塊

如果您的系統(tǒng)不是行業(yè)定制版，可能有些模塊是您自行安裝的，這時需要將?module/?目錄中的自安裝模塊復制到升級后的系統(tǒng)中。

Linux參考命令

cp -av /wwwroot/test.com.bk/module/xxx /wwwroot/test.com/module

Windows參考操作

請按照描述自行操作

4 復制配置文件

從老的項目代碼中復制以下配置文件到新的代碼中。

• 配置文件：.env
• 上傳文件：public/data

Linux參考命令

cp -av /wwwroot/test.com.bk/.env /wwwroot/test.com/
cp -av /wwwroot/test.com.bk/public/data /wwwroot/test.com/public/

Windows參考操作

請按照描述自行操作

5 升級數(shù)據(jù)庫

說明：系統(tǒng)的升級會伴隨著數(shù)據(jù)庫字段和系統(tǒng)配置的升級，系統(tǒng)的版本發(fā)布都會包含歷史系統(tǒng)的所有操作，執(zhí)行該步驟可以升級系統(tǒng)數(shù)據(jù)庫字段、操作等

Linux參考命令

php /wwwroot/test.com/artisan migrate
php /wwwroot/test.com/artisan modstart:module-install-all 

6 清除緩存并完成升級

• 如果您啟用了?Redis?等外部緩存依賴，請清除緩存后再重新訪問系統(tǒng)。
• 如果您使用的是系統(tǒng)自帶的文件緩存，直接訪問新系統(tǒng)。

快速開始

在日常開發(fā)中，最常見的即是增刪改查代碼，使用ModStart開發(fā)此類功能，會變得非常簡單。

下面將會給大家介紹?ModStart?的使用方法，以及一個增刪改查頁面的基本構成。通過學習下面的內(nèi)容將可以幫助大家快速理解這個系統(tǒng)的基本使用方法。

創(chuàng)建數(shù)據(jù)表

在Laravel的遷移目錄創(chuàng)建數(shù)據(jù)庫遷移文件

class CreateNews extends Migration
{
    public function up()
    {
            Schema::create('news', function (Blueprint $table) {
                $table->increments('id');
                $table->timestamps();
                $table->string('title', 200)->nullable()->comment('');
                $table->string('cover', 200)->nullable()->comment('');
                $table->string('summary', 200)->nullable()->comment('');
                $table->text('content')->nullable()->comment('');
            });
        }
    }
    public function down()
    {
    }
}

創(chuàng)建控制器

增加路由控制器代碼，同時按照

class NewsController extends Controller
{
    use HasAdminQuickCRUD;
    protected function crud(AdminCRUDBuilder $builder)
    {
        $builder
            ->init('news')
            ->field(function ($builder) {
                $builder->id('id','ID');
                $builder->text('title', '名稱');
                $builder->image('cover', '封面');
                $builder->textarea('summary', '摘要');
                $builder->richHtml('content', '內(nèi)容');
                $builder->display('created_at', '創(chuàng)建時間');
                $builder->display('updated_at', '更新時間');
            })
            ->gridFilter(function (GridFilter $filter) {
                $filter->eq('id', 'ID');
                $filter->like('title', '標題');
            })
            ->title('新聞管理');
    }
}

增加路由和導航

在?routes.php?增加路由信息

$router->match(['get', 'post'], 'news/news', 'NewsController@index');
$router->match(['get', 'post'], 'news/news/add', 'NewsController@add');
$router->match(['get', 'post'], 'news/news/edit', 'NewsController@edit');
$router->match(['get', 'post'], 'news/news/delete', 'NewsController@delete');
$router->match(['get', 'post'], 'news/news/show', 'NewsController@show')

;在?ModuleServiceProvider.php?中注冊菜單信息

AdminMenu::register(function () {
  return [
    [
      'title' => '新聞管理',
      'icon' => 'list',
      'sort' => 150,
      'url' => '\App\Admin\Controller\NewsController@index',
    ]
  ];
});

開發(fā)完成

這樣一個簡單的增刪改查頁面就開發(fā)完成了

開發(fā)前必讀

開發(fā)前的配置

開發(fā)環(huán)境請打開 debug 模式（即在?.env?文件中設置?APP_DEBUG=true?）

公共樣式

ModStart?使用了一些基礎樣式對頁面進行布局，既簡單又強大，開始開發(fā)前需要對此有所了解。

公共樣式對編寫頁面組件非常有幫助，能顯著提高開發(fā)效率，建議編寫組件前先查閱一遍文檔。

LICENSE

Apache 2.0