PHPackages                             shopex/luban-desktop - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. shopex/luban-desktop

ActiveProject[Framework](/categories/framework)

shopex/luban-desktop
====================

The Laravel Framework of shopex luban desktop project.

v5.4.30.5(8y ago)7954MITPHPPHP >=5.6.4

Since Feb 8Pushed 8y ago7 watchersCompare

[ Source](https://github.com/shopex/luban-desktop)[ Packagist](https://packagist.org/packages/shopex/luban-desktop)[ RSS](/packages/shopex-luban-desktop/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependencies (9)Versions (53)Used By (0)

Shopex luban-desktop使用说明
========================

[](#shopex-luban-desktop使用说明)

luban-desktop是商派在Laravel 5.4的基础上开发的一款现代化的框架，其重构了商派原有ECOS框架的实用功能，可以极大的提高项目开发的效率。

本框架除Laravel原有功能，还包含下面的包:

1. `shopex/luban` -- 负责etcd封装, 后端sevice调用
2. `shopex/luban-admin` --后台desktop样式,包含原有ECOS框架的Finder、typeobject等功能
3. `shopex/luban-crud-generator` 一个可以生curd脚手架
4. `shopex/auth` SSO统一登录, SLO统一登出

一、起步
----

[](#一起步)

使用Composer创建项目

```
composer create-project shopex/luban-desktop myproj dev-master

```

安装过程中会提示`Do you want to remove the existing VCS (.git, .svn..) history? [Y,n]?`，是否需要删除版本信息，选择`Y`，删除，选择`n`不删除。

`composer create-project`过程成包含以下步骤：

```
git clone https://github.com/shopex/luban-desktop.git myproj
cd myproj
composer install
cp .env.example .env
php artisan optimize
php artisan key:generate

```

二、初始化项目
-------

[](#二初始化项目)

1、将laravel扩展包资源发布到资源目录

```
php artisan vendor:publish

```

运行之后，可以看到如下输出：

```
Copied Directory [/vendor/laravel/framework/src/Illuminate/Notifications/resources/views] To [/resources/views/vendor/notifications]
Copied Directory [/vendor/laravel/framework/src/Illuminate/Pagination/resources/views] To [/resources/views/vendor/pagination]
Copied Directory [/vendor/shopex/luban-admin/publish/Middleware] To [/app/Http/Middleware]
Copied Directory [/vendor/shopex/luban-admin/publish/migrations] To [/database/migrations]
Copied Directory [/vendor/shopex/luban-admin/publish/Model] To [/app]
Copied Directory [/vendor/shopex/luban-admin/publish/Controllers] To [/app/Http/Controllers]
Copied Directory [/vendor/shopex/luban-admin/publish/resources/assets] To [/resources/assets/vendor/admin]
Copied Directory [/vendor/shopex/luban-admin/publish/resources/crud-generator] To [/resources/crud-generator]
Copied Directory [/vendor/shopex/luban-admin/publish/resources/views] To [/resources/views/vendor/admin]
Copied Directory [/vendor/shopex/luban-auth/publish/migrations] To [/database/migrations]
Copied Directory [/vendor/shopex/luban-auth/publish/Model] To [/app]
Copied Directory [/vendor/shopex/luban-auth/publish/Controllers] To [/app/Http/Controllers]
Copied Directory [/vendor/laravel/framework/src/Illuminate/Mail/resources/views] To [/resources/views/vendor/mail]

```

2、安装依赖扩展包：

```
npm install  --registry=https://registry.npm.taobao.org

```

3、编译静态资源

```
// 运行所有 Mix 任务...
npm run dev

// 运行所有 Mix 任务和压缩资源输出
npm run production

```

如果是前端开发可以运行`npm run watch-poll`来监控资源文件修改，自动编译资源

三、配置项目
------

[](#三配置项目)

### 1、配置数据库

[](#1配置数据库)

在`.env`里面配置数据库信息

```
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=homestead
DB_USERNAME=homestead
DB_PASSWORD=secret

```

2、创建数据库

```
php artisan migrate

```

3、配置ETCD 如果是微服务架构，则需要配置ETCD的地址，目前本项目在ETCD里面保存了SSO的相关信息：

```
ETCD_ADDR=http://192.168.10.96:2379
ETCD_CONFIG_PATH=/luban/config/devops

```

四、运行
----

[](#四运行)

luban-desktop支持四种方式运行项目代码：

### 1、artisan

[](#1artisan)

php内置Serve

```
php artisan serve

```

### 2、Nginx+php-fpm

[](#2nginxphp-fpm)

此方式需要自行安装lnump

### 3、Swoole

[](#3swoole)

此方式安装php的swoole扩展。

```
//发布配置文件到项目目录
php artisan vendor:publish --provider="Laravoole\LaravooleServiceProvider"

```

运行

```
php artisan laravoole [start | stop | reload | reload_task | restart | quit]

```

### 4、Docker

[](#4docker)

在本项目根目录下有名为`Dockerfile`的文件，此文件是构建Docker镜像的描述文件，此方式一般用来部署正式环境使用。 a)、构建镜像：

```
docker build --no-cache -t shopex/luban:desktop .

```

b)、运行容器：

```
docker run -it -d -p 127.0.0.1:9050:9050 --name mydesktop  -e ETCD_ADDR=192.168.10.96:2379 shopex/luban:desktop

```

运行成功之后，可以通过`127.0.0.1:9050`来访问。 c)、登录容器：

```
docker exec -it mydesktop bash

```

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community25

Small or concentrated contributor base

Maturity71

Established project with proven stability

 Bus Factor1

Top contributor holds 85.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~33 days

Total

51

Last Release

3167d ago

Major Versions

v4.2.11 → v5.0.02015-02-04

PHP version history (2 changes)v5.1.0PHP >=5.5.9

v5.3.0PHP >=5.6.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/0a88cbbb3f74b9d7b3f481f63968064a5ed6c7c263feb984a80268e9287f163c?d=identicon)[shopex](/maintainers/shopex)

---

Top Contributors

[![taylorotwell](https://avatars.githubusercontent.com/u/463230?v=4)](https://github.com/taylorotwell "taylorotwell (3998 commits)")[![daylerees](https://avatars.githubusercontent.com/u/207870?v=4)](https://github.com/daylerees "daylerees (105 commits)")[![franzliedke](https://avatars.githubusercontent.com/u/249125?v=4)](https://github.com/franzliedke "franzliedke (92 commits)")[![GrahamCampbell](https://avatars.githubusercontent.com/u/2829600?v=4)](https://github.com/GrahamCampbell "GrahamCampbell (61 commits)")[![jasonlewis](https://avatars.githubusercontent.com/u/829059?v=4)](https://github.com/jasonlewis "jasonlewis (48 commits)")[![sparksp](https://avatars.githubusercontent.com/u/243893?v=4)](https://github.com/sparksp "sparksp (37 commits)")[![cviebrock](https://avatars.githubusercontent.com/u/166810?v=4)](https://github.com/cviebrock "cviebrock (33 commits)")[![flaboy](https://avatars.githubusercontent.com/u/486890?v=4)](https://github.com/flaboy "flaboy (31 commits)")[![tobsn](https://avatars.githubusercontent.com/u/109529?v=4)](https://github.com/tobsn "tobsn (26 commits)")[![crynobone](https://avatars.githubusercontent.com/u/172966?v=4)](https://github.com/crynobone "crynobone (25 commits)")[![JeffreyWay](https://avatars.githubusercontent.com/u/183223?v=4)](https://github.com/JeffreyWay "JeffreyWay (19 commits)")[![JosephSilber](https://avatars.githubusercontent.com/u/1403741?v=4)](https://github.com/JosephSilber "JosephSilber (16 commits)")[![bencorlett](https://avatars.githubusercontent.com/u/181919?v=4)](https://github.com/bencorlett "bencorlett (13 commits)")[![tillkruss](https://avatars.githubusercontent.com/u/665029?v=4)](https://github.com/tillkruss "tillkruss (12 commits)")[![themsaid](https://avatars.githubusercontent.com/u/4332182?v=4)](https://github.com/themsaid "themsaid (12 commits)")[![ericlbarnes](https://avatars.githubusercontent.com/u/116662?v=4)](https://github.com/ericlbarnes "ericlbarnes (11 commits)")[![neoascetic](https://avatars.githubusercontent.com/u/725836?v=4)](https://github.com/neoascetic "neoascetic (11 commits)")[![jesseobrien](https://avatars.githubusercontent.com/u/865481?v=4)](https://github.com/jesseobrien "jesseobrien (10 commits)")[![barryvdh](https://avatars.githubusercontent.com/u/973269?v=4)](https://github.com/barryvdh "barryvdh (9 commits)")[![codler](https://avatars.githubusercontent.com/u/102052?v=4)](https://github.com/codler "codler (9 commits)")

---

Tags

frameworklaravelshopex

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/shopex-luban-desktop/health.svg)

```
[![Health](https://phpackages.com/badges/shopex-luban-desktop/health.svg)](https://phpackages.com/packages/shopex-luban-desktop)
```

###  Alternatives

[codewithdennis/larament

Larament is a time-saving starter kit to quickly launch Laravel 13.x projects. It includes FilamentPHP 5.x pre-installed and configured, along with additional tools and features to streamline your development workflow.

3691.5k](/packages/codewithdennis-larament)[ercogx/laravel-filament-starter-kit

This is a Filament v3 Starter Kit for Laravel 12, designed to accelerate the development of Filament-powered applications.

401.5k](/packages/ercogx-laravel-filament-starter-kit)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)