PHPackages swoole-eloquent/swoole-eloquent - 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. [Database & ORM](/categories/database) 4. / 5. swoole-eloquent/swoole-eloquent ActiveLibrary[Database & ORM](/categories/database) swoole-eloquent/swoole-eloquent =============================== Асинхронная PHP-библиотека, объединяющая Swoole и Eloquent ORM для высокопроизводительных backend-сервисов v1.0.2(6mo ago)01MITPHPPHP ^8.1 Since Nov 5Pushed 6mo agoCompare [ Source](https://github.com/larchphp/swoole-eloquent)[ Packagist](https://packagist.org/packages/swoole-eloquent/swoole-eloquent)[ RSS](/packages/swoole-eloquent-swoole-eloquent/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (1)Dependencies (5)Versions (6)Used By (0) Swoole-Eloquent =============== [](#swoole-eloquent) Асинхронная PHP-библиотека, объединяющая производительность Swoole и удобство Eloquent ORM. 🎯 Цель проекта -------------- [](#-цель-проекта) Создать библиотеку, которая позволяет писать асинхронные backend-сервисы на PHP с использованием привычного синтаксиса Eloquent ORM, без блокировки потоков и с максимальной производительностью. ✨ Основные возможности ---------------------- [](#-основные-возможности) - ⚡ **Асинхронные запросы к БД** через Swoole корутины - 🔄 **Пул соединений** для эффективного использования ресурсов - 📝 **Совместимость с Eloquent** - привычный синтаксис ORM - 🚀 **Высокая производительность** - десятки тысяч запросов параллельно - 🔧 **Универсальная архитектура** - легко добавить поддержку разных БД 📦 Требования ------------ [](#-требования) - PHP 8.1+ - ext-swoole - ext-pgsql (для PostgreSQL) 🚀 Установка ----------- [](#-установка) ``` composer require swoole-eloquent/swoole-eloquent ``` 💡 Быстрый старт --------------- [](#-быстрый-старт) ### 1. Настройка соединения [](#1-настройка-соединения) ``` use SwooleEloquent\Connection\SwoolePostgresConnection; use SwooleEloquent\ORM\AsyncModel; $connection = new SwoolePostgresConnection([ 'host' => '127.0.0.1', 'port' => 5432, 'database' => 'your_database', 'username' => 'postgres', 'password' => 'password', 'pool_size' => 20, // Размер пула соединений ]); // Установка соединения для моделей YourModel::setConnectionResolver($connection); ``` ### 2. Определение модели [](#2-определение-модели) ``` use SwooleEloquent\ORM\AsyncModel; class User extends AsyncModel { protected ?string $table = 'users'; protected array $fillable = ['name', 'email', 'age']; protected array $hidden = ['password']; } ``` ### 3. Использование в корутинах [](#3-использование-в-корутинах) ``` use Swoole\Coroutine; Coroutine\run(function() { // Поиск пользователя $user = User::async()->find(1); echo $user->name; // Выборка с условиями $activeUsers = User::async() ->where('age', '>', 18) ->orderBy('name', 'asc') ->get(); // Создание нового пользователя $user = new User(); $user->name = 'John Doe'; $user->email = 'john@example.com'; $user->asyncSave(); // Обновление $user->age = 30; $user->asyncSave(); // Удаление $user->asyncDelete(); }); ``` ### 4. HTTP Server пример [](#4-http-server-пример) ``` use Swoole\Http\Server; $server = new Server("0.0.0.0", 9501); $server->on('Request', function ($request, $response) { // Каждый запрос выполняется в отдельной корутине $users = User::async()->where('active', true)->get(); $response->header('Content-Type', 'application/json'); $response->end(json_encode($users)); }); $server->start(); ``` 📖 API ----- [](#-api) ### Query Methods [](#query-methods) ``` // Поиск User::async()->find(1); User::async()->findOrFail(1); // Условия User::async()->where('active', true)->get(); User::async()->whereIn('id', [1, 2, 3])->get(); User::async()->first(); User::async()->count(); // Модификация User::async()->update(['status' => 'active']); User::async()->delete(); ``` ### Instance Methods [](#instance-methods) ``` $user = User::async()->find(1); $user->asyncSave(); $user->asyncUpdate(['name' => 'New']); $user->asyncDelete(); $user->asyncRefresh(); ``` ### Relationships [](#relationships) ``` // Загрузка связей $posts = $user->posts()->async()->get(); ``` ### Транзакции [](#транзакции) ``` try { $connection->beginTransaction(); $user = new User(); $user->name = 'Alice'; $user->asyncSave(); $anotherUser = new User(); $anotherUser->name = 'Bob'; $anotherUser->asyncSave(); $connection->commit(); } catch (\Throwable $e) { $connection->rollBack(); throw $e; } ``` 🚀 Производительность -------------------- [](#-производительность) ### Сравнение с обычным Laravel + FPM [](#сравнение-с-обычным-laravel--fpm) МетрикаLaravel + FPMSwoole-EloquentУлучшениеВремя ответа10-15 мс2-3 мс**5x быстрее**КонкурентностьБлокирующаяАсинхронная**10000+ параллельных запросов**Подключения к БДСоздаются на каждый запросПул соединений**Переиспользование**QPS (запросов/сек)~100-200**1000+****10x выше**### Результаты стресс-теста [](#результаты-стресс-теста) ``` 1000 параллельных запросов: ✓ Завершено: 1000/1000 ✓ Время: 245 мс ✓ QPS: 4082 запросов/сек ✓ Среднее время: 0.24 мс/запрос ``` 📚 Примеры --------- [](#-примеры) Все примеры находятся в директории `examples/`: - **basic\_usage.php** - Базовые CRUD операции - **demo\_server.php** - HTTP сервер с REST API - **concurrent\_queries.php** - Параллельные запросы и стресс-тест - **transactions\_example.php** - Работа с транзакциями Запуск примеров: ``` php examples/basic_usage.php php examples/demo_server.php php examples/concurrent_queries.php php examples/transactions_example.php ``` 🏗️ Архитектура -------------- [](#️-архитектура) ``` src/ ├── Connection/ # Пул соединений и драйверы БД ├── ORM/ # Async Model и Query Builder └── Support/ # Утилиты и хелперы ``` 🧪 Тестирование -------------- [](#-тестирование) ``` composer test composer test-coverage ``` 📝 Лицензия ---------- [](#-лицензия) MIT License 🤝 Вклад в проект ---------------- [](#-вклад-в-проект) Contributions приветствуются! ### Health Score 32 — LowBetter than 72% of packages Maintenance68 Regular maintenance activity Popularity1 Limited adoption so far Community6 Small or concentrated contributor base Maturity47 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 ~1 days Total 3 Last Release 187d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/1af48afd394c2e93bdef239df0c4fe69690c242e6acca2d16c33648670d68bb6?d=identicon)[larchiephp](/maintainers/larchiephp) --- Top Contributors [![larchphp](https://avatars.githubusercontent.com/u/80367064?v=4)](https://github.com/larchphp "larchphp (40 commits)") --- Tags asyncormmysqlpostgresqleloquentswoolecoroutine ### Code Quality TestsPHPUnit Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/swoole-eloquent-swoole-eloquent/health.svg) ``` [![Health](https://phpackages.com/badges/swoole-eloquent-swoole-eloquent/health.svg)](https://phpackages.com/packages/swoole-eloquent-swoole-eloquent) ``` ### Alternatives [kirschbaum-development/eloquent-power-joins The Laravel magic applied to joins. 1.6k25.2M34](/packages/kirschbaum-development-eloquent-power-joins)[cycle/orm PHP DataMapper ORM and Data Modelling Engine 1.3k835.4k65](/packages/cycle-orm)[chocofamilyme/laravel-tarantool A Tarantool based Eloquent ORM and Query builder for Laravel 182.3k](/packages/chocofamilyme-laravel-tarantool)[andreagroferreira/laravel-sync-tracker A Laravel package for tracking entity synchronization status between systems 113.0k](/packages/andreagroferreira-laravel-sync-tracker) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)