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

系統完全開源，基于?Apache 2.0?開源協議，免費且不限制商業使用。

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

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

技術棧

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

特性

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

功能一覽

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

加入我們

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

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

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

安裝

環境要求

• 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 服務器，請將網站的根目錄配置到 <網站目錄>/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

集成環境

• 寶塔一鍵安裝教程：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
• 原生環境安裝教程：https://modstart.com/doc/install/start.html

環境預檢

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

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

升級指南

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

說明：升級前請全量備份網站數據庫和代碼，避免升級操作有誤造成系統不能正常運行。

自動升級

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

在自動升級前請備份好舊的系統數據，避免升級失敗造成的數據丟失等情況。

手動升級

1 舊的系統備份

假如舊系統的部署目錄為?/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 遷移自安裝模塊

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

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 升級數據庫

說明：系統的升級會伴隨著數據庫字段和系統配置的升級，系統的版本發布都會包含歷史系統的所有操作，執行該步驟可以升級系統數據庫字段、操作等

Linux參考命令

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

6 清除緩存并完成升級

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

快速開始

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

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

創建數據表

在Laravel的遷移目錄創建數據庫遷移文件

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()
    {
    }
}

創建控制器

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

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', '內容');
                $builder->display('created_at', '創建時間');
                $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',
    ]
  ];
});

開發完成

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

開發前必讀

開發前的配置

開發環境請打開 debug 模式（即在?.env?文件中設置?APP_DEBUG=true?）

公共樣式

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

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

LICENSE

Apache 2.0