PHPackages                             devitools/serendipity - 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. devitools/serendipity

ActiveLibrary

devitools/serendipity
=====================

The Hyperf missing component

2.1.2(2mo ago)32.3kMITPHPPHP ^8.3CI failing

Since Feb 26Pushed 2mo ago3 watchersCompare

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

READMEChangelog (10)Dependencies (72)Versions (116)Used By (0)

[![SonarQube Cloud](https://camo.githubusercontent.com/00ea5772d0a9357bcf4ea1376735c4a2172fd245b844bb119f92c93ad437eda4/68747470733a2f2f736f6e6172636c6f75642e696f2f696d616765732f70726f6a6563745f6261646765732f736f6e6172636c6f75642d686967686c696768742e737667)](https://sonarcloud.io/summary/new_code?id=devitools_serendipity)

[![Reliability Rating](https://camo.githubusercontent.com/09763967f1d181af7bcd0c2b530d28acbf558039edb711f34b265a24d18c412b/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d64657669746f6f6c735f736572656e646970697479266d65747269633d72656c696162696c6974795f726174696e67)](https://sonarcloud.io/summary/new_code?id=devitools_serendipity)[![Security Rating](https://camo.githubusercontent.com/e934e633a8448863d79c995682db6556889f3edfb9d2266628cf6a5b1473be9d/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d64657669746f6f6c735f736572656e646970697479266d65747269633d73656375726974795f726174696e67)](https://sonarcloud.io/summary/new_code?id=devitools_serendipity)[![Quality Gate Status](https://camo.githubusercontent.com/5201f24a9ba60aff1a437d62be4bececc4126f63520761e7c812df74b58ce842/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d64657669746f6f6c735f736572656e646970697479266d65747269633d616c6572745f737461747573)](https://sonarcloud.io/summary/new_code?id=devitools_serendipity)[![Maintainability Rating](https://camo.githubusercontent.com/0e0649e3eca831aac835b0f7ccd68faeb426aeeb7d15a79ce6abdccdf7320cf4/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d64657669746f6f6c735f736572656e646970697479266d65747269633d7371616c655f726174696e67)](https://sonarcloud.io/summary/new_code?id=devitools_serendipity)

[![Vulnerabilities](https://camo.githubusercontent.com/2ee669bc81e8756d36f57153eb405a82447584150281cf4daf76383d689713d2/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d64657669746f6f6c735f736572656e646970697479266d65747269633d76756c6e65726162696c6974696573)](https://sonarcloud.io/summary/new_code?id=devitools_serendipity)[![Bugs](https://camo.githubusercontent.com/825095bad65ca789914a53975f902ff6e7dafc531eec239624cc08246476464b/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d64657669746f6f6c735f736572656e646970697479266d65747269633d62756773)](https://sonarcloud.io/summary/new_code?id=devitools_serendipity)[![Technical Debt](https://camo.githubusercontent.com/3c8a74bb05071985709618077ac40ecb9e9716e2ec80613386fdc90b7ae4370d/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d64657669746f6f6c735f736572656e646970697479266d65747269633d7371616c655f696e646578)](https://sonarcloud.io/summary/new_code?id=devitools_serendipity)[![Code Smells](https://camo.githubusercontent.com/6307451317b02a44e25342d0a1544d566c83838efe66b78de08b3e6e93a777a5/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d64657669746f6f6c735f736572656e646970697479266d65747269633d636f64655f736d656c6c73)](https://sonarcloud.io/summary/new_code?id=devitools_serendipity)

[![Coverage](https://camo.githubusercontent.com/7407a30d29fe17b345e4d227d90ea1d6c466ecfb0562971e653ca548e2331998/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d64657669746f6f6c735f736572656e646970697479266d65747269633d636f766572616765)](https://sonarcloud.io/summary/new_code?id=devitools_serendipity)[![Duplicated Lines (%)](https://camo.githubusercontent.com/bf7afeb387643399d206ef5cca712bf54cc1855f3641ab7c7712b9256e1213df/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d64657669746f6f6c735f736572656e646970697479266d65747269633d6475706c6963617465645f6c696e65735f64656e73697479)](https://sonarcloud.io/summary/new_code?id=devitools_serendipity)[![Lines of Code](https://camo.githubusercontent.com/cce35019224d53f5837a197a70b7a35f545ce7d81cc7caa138f939d3e02592fb/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d64657669746f6f6c735f736572656e646970697479266d65747269633d6e636c6f63)](https://sonarcloud.io/summary/new_code?id=devitools_serendipity)

---

Serendipity
===========

[](#serendipity)

**O componente que faltava no Hyperf**

Serendipity é uma biblioteca PHP que estende o framework Hyperf com funcionalidades avançadas de Domain-Driven Design ( DDD), validação inteligente, serialização automática e infraestrutura robusta para aplicações de alta performance.

🍿 Visão Geral
-------------

[](#-visão-geral)

Serendipity preenche as lacunas do ecossistema Hyperf, oferecendo uma camada de abstração poderosa que combina os melhores padrões de desenvolvimento com a performance assíncrona do Hyperf. Utilizando o [Constructo](https://github.com/devitools/constructo) como base, oferece metaprogramação avançada para resolver dependências e formatar dados de forma flexível.

### Principais Características

[](#principais-características)

- **🏗️ Arquitetura DDD**: Estrutura completa seguindo Domain-Driven Design
- **⚡ Assíncrono por Padrão**: Totalmente compatível com corrotinas do Hyperf
- **🔍 Validação Inteligente**: Sistema de validação baseado em atributos e regras
- **📊 Serialização Automática**: Conversão inteligente de entidades para diferentes formatos
- **🎯 Type Safety**: Tipagem forte com suporte a generics
- **🧪 Testabilidade**: Ferramentas completas para testes unitários e de integração
- **📈 Observabilidade**: Logging estruturado e monitoramento integrado

🚀 Instalação
------------

[](#-instalação)

### Pré-requisitos

[](#pré-requisitos)

- PHP 8.3+
- Extensões: ds, json, mongodb, pdo, swoole
- Hyperf 3.1+
- Docker 25+ (para desenvolvimento)
- Docker Compose 2.23+

### Instalação via Composer

[](#instalação-via-composer)

```
composer require devitools/serendipity
```

### Configuração Básica

[](#configuração-básica)

**Registre o ConfigProvider** no seu `config/config.php`:

```