@adminjs/mikroorm

中文文档
4.1.0发布于 2025/09/24MITTypeScriptESM + CJS零依赖近 30 天下载 3770

管理员MikroORM 适配器

中文使用文档
文档目录10 节
  1. 管理员- mikroorm
  2. 安装
  3. 使用量
  4. 示例
  5. 协会
  6. 捐款
  7. 运行示例应用程序
  8. 调取请求
  9. 许可证
  10. 关于 rst. 软件

管理员- mikroorm

这是官员 行政部门 集成的适配器 米克罗姆 进入行政司.

安装

线条

$ yarn add @adminjs/mikroorm

无

$ npm i @adminjs/mikroorm

使用量

插件可以使用标准注册 AdminJS.registerAdapter 方法.

import { Database, Resource } from '@adminjs/mikroorm';
import AdminJS from 'adminjs';
import { validate } from 'class-validator';

const setupAdminJs = async () => {
  const orm = await MikroORM.init({
    entities: [User],
    dbName: process.env.DATABASE_NAME,
    type: 'postgresql',
    clientUrl: process.env.DATABASE_URL,
  });

  // If your entities use `class-validator` to validate data, you can inject it's validate method into the resource.
  Resource.validate = validate;
  AdminJS.registerAdapter({ Database, Resource });

  // You can instantiate AdminJS either by specifying all resources separately:
  const adminJs = new AdminJS({
    resources: [{ resource: { model: User, orm }, options: {} }],
  });

  // Or by passing your ORM instance into `databases` property.
  const adminJs = new AdminJS({
    databases: [orm],
  });
  // You should choose to use either `resources` or `databases`
};

示例

示例项目可见于 example-app 目录.

协会

目前仅 ManyToOne 财务报告和审定财务报表 OneToOne 由于当前AdminJS的核心局限性,关系得到了支持 用于适配器集成. OneToMany 财务报告和审定财务报表 ManyToMany 关系仍然可以通过自定义组件和钩子的结合来实现.

捐款

运行示例应用程序

如果您想要在本地设置此程序, 这就是建议的过程 :

  1. 叉出还原
  2. 安装依赖关系
yarn install
  1. 将此软件包注册为 链接软件包
yarn link
  1. 设置示例应用程序

安装所有依赖和使用先前链接的版本 @adminjs/mikroorm。 。 。 .

cd example-app
yarn install
yarn link "@adminjs/mikroorm"

可以选择,您可能想要链接您的本地版本 adminjs 软件包

  1. 确定您已设置了所有嵌入器( 见 ./example-app/example.env 创建 .env 基于此文件)

  2. 以监视模式构建软件包

(在根文件夹中)

yarn dev
  1. 在 dev 模式下运行应用程序
cd example-app
yarn dev

调取请求

在你做公关之前 确定所有的测试都通过 并且代码不会引起错误. 你可以通过运行来做到这一点:

yarn lint
yarn test

确定你有一个 .env 在工程的根目录中用于测试运行器的文件 :

DATABASE_URL=postgres://postgres:@localhost:5433/mikroorm_test
DATABASE_NAME=mikroorm_test

许可证

AdminJS拥有2023rst.software的版权. 它是一种自由软件,可按下列规定重新分配: 自由主义 文档.

关于 rst. 软件

我们是一个开放、友好的团队.

  • 我们随时可以 雇用。 。 。 .
  • 如果你想为我们工作.. 职业页面。 。 。 .

版本与发布记录

@adminjs/mikroorm 共发布 8 个版本,首次发布于 2021/10/22;过去 12 个月发布了 0 个版本。

版本发布日期距今
4.1.0latest2025/09/241.1 年前
4.0.02024/03/052 年前
3.0.02023/04/183 年前
3.0.0-beta.1beta2023/03/203 年前
2.0.02022/07/134 年前
1.1.22022/06/234 年前

关于 @adminjs/mikroorm 的常见问题

@adminjs/mikroorm 是什么?

管理员MikroORM 适配器

如何安装 @adminjs/mikroorm?

在项目目录运行 npm install @adminjs/mikroorm,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@mikro-orm/core(^6.1.7)、adminjs(^7.7.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@adminjs/mikroorm 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@adminjs/mikroorm 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@adminjs/mikroorm 可以商用吗?

@adminjs/mikroorm 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@adminjs/mikroorm 的下载量有多少?

根据 npm 官方下载统计,@adminjs/mikroorm 在 2026/10/05 – 2026/11/03 这 30 天内被下载 3,770 次,日均约 126 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@adminjs/mikroorm 还在维护吗?

最新版本 4.1.0 发布于 2025/09/24(1.1 年前);至今共发布 8 个版本,其中过去 12 个月发布了 0 个;首次发布于 2021/10/22。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。