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

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

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

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

技術(shù)棧

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

特性

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

功能一覽

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

加入我們

如果您對(duì)這個(gè)項(xiàng)目感興趣，非常歡迎加入項(xiàng)目開發(fā)團(tuán)隊(duì)，參與這個(gè)項(xiàng)目的功能維護(hù)與開發(fā)。

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

• 貢獻(xiàn)代碼
• 完善文檔
• 撰寫教程
• 完善注釋
• ...

安裝

環(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ù)器，請(qǐng)將網(wǎng)站的根目錄配置到 <網(wǎng)站目錄>/public
2. 訪問?http://www.xxx.com/install.php
3. 使用安裝引導(dǎo)向?qū)нM(jìn)行安裝

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)境預(yù)檢

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

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

升級(jí)指南

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

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

自動(dòng)升級(jí)

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

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

手動(dòng)升級(jí)

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

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

Linux參考命令

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

Windows參考操作

請(qǐng)按照描述自行操作

2 解壓最新的代碼

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

Linux參考命令

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

Windows參考操作

請(qǐng)按照描述自行操作

3 遷移自安裝模塊

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

Linux參考命令

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

Windows參考操作

請(qǐng)按照描述自行操作

4 復(fù)制配置文件

從老的項(xiàng)目代碼中復(fù)制以下配置文件到新的代碼中。

• 配置文件：.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參考操作

請(qǐng)按照描述自行操作

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

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

Linux參考命令

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

6 清除緩存并完成升級(jí)

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

快速開始

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

下面將會(huì)給大家介紹?ModStart?的使用方法，以及一個(gè)增刪改查頁面的基本構(gòu)成。通過學(xué)習(xí)下面的內(nèi)容將可以幫助大家快速理解這個(gè)系統(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)建控制器

增加路由控制器代碼，同時(shí)按照

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)建時(shí)間');
                $builder->display('updated_at', '更新時(shí)間');
            })
            ->gridFilter(function (GridFilter $filter) {
                $filter->eq('id', 'ID');
                $filter->like('title', '標(biāo)題');
            })
            ->title('新聞管理');
    }
}

增加路由和導(dǎo)航

在?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?中注冊(cè)菜單信息

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

開發(fā)完成

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

開發(fā)前必讀

開發(fā)前的配置

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

公共樣式

ModStart?使用了一些基礎(chǔ)樣式對(duì)頁面進(jìn)行布局，既簡(jiǎn)單又強(qiáng)大，開始開發(fā)前需要對(duì)此有所了解。

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

LICENSE

Apache 2.0