PHPackages                             antonchaikin/f3-mongo - 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. antonchaikin/f3-mongo

ActiveLibrary[Framework](/categories/framework)

antonchaikin/f3-mongo
=====================

Fat-Free Framework plugin for MongoDB with event hooks, soft deletes, and auto-timestamps.

1.0.3(11mo ago)023MITPHPPHP ^7.4 || ^8.0

Since May 28Pushed 11mo agoCompare

[ Source](https://github.com/AntonSeagull/f3-mongo)[ Packagist](https://packagist.org/packages/antonchaikin/f3-mongo)[ RSS](/packages/antonchaikin-f3-mongo/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (2)Versions (5)Used By (0)

Подключение в F3
----------------

[](#подключение-в-f3)

Метод `$f3->mdb('collection')` возвращает обёртку `CollectionEvents` с дополнительной логикой:

- автоматическое исключение soft-deleted (`deleted_at`)
- события insert/update
- auto timestamps (`created_at`, `updated_at`)

Метод `$f3->_mdb('collection')` — это прямой доступ к `\MongoDB\Collection` без каких-либо обработчиков или фильтрации. Используйте его для низкоуровневых операций или административных целей.

f3-mongo
========

[](#f3-mongo)

Расширение для Fat-Free Framework (F3), добавляющее удобный интерфейс работы с MongoDB.

Возможности
-----------

[](#возможности)

- Упрощённый доступ к коллекциям через `$f3->mdb('collection')`
- Автоматическая фильтрация удалённых записей (`deleted_at`)
- Поддержка агрегаций, обновлений, вставок, удаления и слушателей изменений
- Обёртка `CollectionEvents` с логикой `updated_at`, `created_at`, `bulkWrite`, `insertAsync` и пр.
- Простой API: `find()`, `findOne()`, `insertOne()`, `updateMany()` и др.

Установка
---------

[](#установка)

```
composer require apptor/f3-mongo
```

Использование
-------------

[](#использование)

```
use Lumus\mDB;

/** @var \Base&\F3Mongo\MongoAwareF3 $f3 */

\F3Mongo\MongoPlugin::register([
    'host' => 'localhost',
    'port' => 27017,
    'username' => '',
    'password' => '',
    'database' => 'your_db',
]);

$users = $f3->mdb('users')->find(['active' => true]);
```

Подключение в F3
----------------

[](#подключение-в-f3-1)

После регистрации плагина:

```
\F3Mongo\MongoPlugin::register([
    'host' => 'localhost',
    'port' => 27017,
    'database' => 'your_db',
]);
```

Вы получите доступ к Mongo через `$f3->mdb`:

- `$f3->mdb->collection('users')` — возвращает обёртку `CollectionEvents` с логикой:

    - автоматическое исключение soft-deleted (`deleted_at`)
    - события `insert` / `update` (если есть слушатели)
    - auto timestamps (`created_at`, `updated_at`)
    - методы: `find()`, `findOne()`, `updateOne()`, `insertOne()`, `aggregate()` и др.
- `$f3->mdb->_collection('users')` — возвращает оригинальный объект `\MongoDB\Collection` без каких-либо обработчиков.

Подсказки в IDE
---------------

[](#подсказки-в-ide)

Добавьте аннотацию:

```
/** @var \Base&\F3Mongo\MongoAwareF3 $f3 */
```

Поддержка
---------

[](#поддержка)

Если вы нашли баг или хотите предложить улучшение — создайте issue или pull request.

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance52

Moderate activity, may be stable

Popularity6

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~5 days

Total

4

Last Release

333d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3d12d07cb0b4a9c882178756622fa9c57f281836ff84f530d0129f3d6377811d?d=identicon)[AppTor](/maintainers/AppTor)

---

Top Contributors

[![AntonSeagull](https://avatars.githubusercontent.com/u/20472179?v=4)](https://github.com/AntonSeagull "AntonSeagull (4 commits)")

### Embed Badge

![Health badge](/badges/antonchaikin-f3-mongo/health.svg)

```
[![Health](https://phpackages.com/badges/antonchaikin-f3-mongo/health.svg)](https://phpackages.com/packages/antonchaikin-f3-mongo)
```

###  Alternatives

[webiny/framework

Webiny Framework

1031.4k3](/packages/webiny-framework)

PHPackages © 2026

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