Madong Admin

Madong Admin is a PHP Webman-based backend development platform for building admin APIs, shipping a layered DAO/Service architecture, a plugin system, and two selectable admin UIs alongside a separately deployed Nuxt frontend site. It targets PHP 8.2 through 8.4 on Webman 2.2, with MySQL 8.0+ and Redis 7.0+ as its data stores, and is released under the Apache 2.0 license.

What is Madong Admin?

Madong Admin is a fast-development backend framework built on the PHP Webman 2.2 framework that serves APIs to decoupled frontend applications. It takes your database schema and produces generated controllers, models, and service-layer code via a built-in code generator, and it runs on PHP 8.2–8.4 with MySQL 8.0+ and Redis 7.0+. The backend lives in a backend/ directory with a CLI install wizard; frontends are downloaded separately into template/admin and template/web. The project is maintained under the madong-code GitHub organization with Gitee and GitCode mirrors under motion-code.

Key Features

• JWT authentication — identity verification is handled by a JWT-based mechanism rather than PHP sessions.
• Fine-grained permission management — a granular RBAC-style control layer governs access across the API.
• Dual admin UI — two interchangeable admin frontends, Single and Aura, either of which drops into template/admin; a separate web-nuxt site serves the public-facing frontend and is shared with the multi-tenant edition.
• Plugin system with SSE progress — third-party extensions (including codegen and demo plugins) install and uninstall with real-time server-sent-event progress feedback.
• Dependency pipeline for plugins — plugins declare require.composer and npm_require.admin|web|common in config/info.php; the pipeline merges declarations into composer.json and the frontend package.json, supports skip/override/fail conflict strategies, reference counting for shared dependencies, and transactional rollback on failure.
• Code generator — automates generation of controllers, models, and service-layer code from a clean DAO/Service layering.
• Database migrations — schema changes are version-managed.
• Communication infrastructure — email, SMS, notification, and multi-storage file upload built in, plus i18n configuration.

How does Madong Admin work?

After composer install in backend/, you fetch frontends with php webman madong-download:frontend (flags --admin, --web, -b for branch, -f to force overwrite), or clone them manually from GitHub. Then open the install wizard at port 8500 and start the server with php start.php start for development or php start.php start -d for a daemonized production run.

Who is it for?

• PHP backend developers building admin APIs who want Webman's performance instead of a traditional PHP-FPM framework.
• Teams needing an admin panel fast — install the wizard, pick Single or Aura, and get JWT auth plus permission control without wiring it from scratch.
• Plugin authors distributing reusable modules with both Composer and npm dependencies handled automatically.
• AI-assisted developers — the companion madong-admin-skills repo provides backend, frontend, and cross-cutting skill packs for AI coding assistants.

Use cases

• SaaS builders: stand up a multi-tenant-capable backend with the shared web-nuxt frontend and generated CRUD endpoints.
• Extension vendors: ship a plugin whose Composer and npm dependencies merge cleanly, with reference counting so uninstalling one plugin does not break another.
• Legacy migration teams: use the migration tooling to version-manage an existing MySQL schema into the Webman stack.

Alternatives

Laravel-based admin kits such as Filament, which likewise pair a PHP backend with an admin UI but run on Laravel rather than Webman. Vben Admin is a Vue admin frontend that Madong's dual UIs are related to in spirit.

FAQ

What PHP version does Madong Admin require?

Madong Admin runs on PHP 8.2 through 8.4, paired with Webman 2.2, MySQL 8.0+, and Redis 7.0+. Composer 2.x and Node.js with pnpm are also needed for backend and frontend dependencies respectively.

Is Madong Admin free?

Yes. It is released under the Apache 2.0 license, per the license badge and the repository's declared license, so you can use and modify it under those terms.

Do I have to download the frontend separately?

Yes. Frontend and backend are deployed separately; the frontend directories must be downloaded or created by you. Use the madong-download:frontend command or clone the repos and place an admin UI in template/admin and the Nuxt site in template/web.

What happens if plugin dependency installation fails due to network issues?

By default dependencies.auto_install is false, so only declarations are merged and commands are printed. Failures do not block installation, and you can re-run php webman madong-plugin:install-deps with a plugin name, or check status first with the --status flag.