PHPackages conectra/expressive - 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. conectra/expressive ActiveLibrary[Database & ORM](/categories/database) conectra/expressive =================== Object-Relational-Mapper para PHP v100.0.0(8y ago)0615MITPHP Since Jul 6Pushed 3y ago2 watchersCompare [ Source](https://github.com/conectra/phpexpressive)[ Packagist](https://packagist.org/packages/conectra/expressive)[ Docs](https://github.com/conectra/phpexpressive)[ RSS](/packages/conectra-expressive/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (3)Dependencies (3)Versions (22)Used By (0) Expressive ========== [](#expressive) [![Codacy Badge](https://camo.githubusercontent.com/6b9f3af3f78c3a2f62eae7e8c4cb5415661596b2222e261b1273cce61303be5b/68747470733a2f2f6170692e636f646163792e636f6d2f70726f6a6563742f62616467652f47726164652f3165366635383730333565363432336638383239636665313562636462343733)](https://www.codacy.com/app/rafaelbeecker/phpexpressive?utm_source=github.com&utm_medium=referral&utm_content=rafaelbeecker/phpexpressive&utm_campaign=Badge_Grade)[![Codacy Badge](https://camo.githubusercontent.com/713898beac835908fa2b79f2e761b9ef6920262b8287bbb832e1c4e801a7fa62/68747470733a2f2f6170692e636f646163792e636f6d2f70726f6a6563742f62616467652f436f7665726167652f3165366635383730333565363432336638383239636665313562636462343733)](https://www.codacy.com/app/rafaelbeecker/phpexpressive?utm_source=github.com&utm_medium=referral&utm_content=rafaelbeecker/phpexpressive&utm_campaign=Badge_Coverage)[![Latest Stable Version](https://camo.githubusercontent.com/11bebd4c98bfee48b324c357291b9cbe7be7794f7dc097b0cd829bc8d097fcc2/68747470733a2f2f706f7365722e707567782e6f72672f736f6c69732f657870726573736976652f762f737461626c65)](https://packagist.org/packages/solis/expressive)[![License](https://camo.githubusercontent.com/234f4a56514f36362f480a43072d33661a9a0254beba1d197d37e8f0afdcd331/68747470733a2f2f706f7365722e707567782e6f72672f736f6c69732f657870726573736976652f6c6963656e7365)](https://packagist.org/packages/solis/expressive)[![Build Status](https://camo.githubusercontent.com/5c864b4c3b758c755f12c9b6ea715b44da8dbbe7cebcfb5c9eb8ffa93511c774/68747470733a2f2f7472617669732d63692e6f72672f72616661656c626565636b65722f706870657870726573736976652e7376673f6272616e63683d76312e78)](https://travis-ci.org/rafaelbeecker/phpexpressive) Expressive é uma biblioteca para mapeamento objeto relacional construída sobre o [illuminate/database](https://github.com/illuminate/database), com definições de objetos baseada em arquivos de schema. Install ------- [](#install) Esse pacote foi estruturado para ser instalado por meio do composer. ``` composer require solis/expressive ``` Usage ----- [](#usage) Defina a estrutura de um objeto de acordo com as especificações do [phpschema](https://github.com/rafaelbeecker/phpschema). ``` { "database": { "repository": "pessoa", "keys": "ID" }, "properties": [ { "alias": "proID", "property": "ID", "type": "int", "behavior": { "required": "false", "autoIncrement": "true" } }, { "alias": "proNome", "property": "nome", "type": "string" }, { "alias": "proInscricaoFederal", "property": "inscricaoFederal", "type": "string" }, { "alias": "proTipo", "property": "tipo", "type": "int" }, { "alias": "proSituacao", "property": "situacao", "type": "int", "behavior": { "required":"false" } } ] } ``` Uma Classe que utiliza a funcionalidade ORM fornecida pela biblioteca deve extender a class abstrata Expressive e ter em si declaradas as propriedades especificadas no schema json. ``` use Solis\Expressive\Classes\Illuminate\Expressive; use Solis\Expressive\Magic\Concerns\HasMagic; class Pessoa extends Expressive { use HasMagic; protected $ID; protected $nome; protected $inscricaoFederal; protected $tipo; protected $situacao; /** * Pessoa constructor. */ public function __construct() { parent::__construct(); $this->start(dirname(__FILE__) . '/Pessoa.json'); } } ``` O método start é responsável por construir um objeto Schema a partir do caminho fornecido e atribuir a respectiva classe. Uma classe extendo Expressive deve utilizar a trait HasMagic de modo ater acesso a funcionalidade de atribuição dinâmica por meio do método make. ``` $Pessoa = Pessoa::make([ "proNome" => 'Fulano - ' . uniqid(rand()), "proInscricaoFederal" => '' . rand(11111111111111, 99999999999999) . '', "proTipo" => 1 ]); ``` O método make retorna uma instância de ExpressiveAbstract com acesso as operações de persistência disponibilizadas pela biblioteca. ### Operations [](#operations) Relação de operações de persistência que podem ser utilizadas por uma instância de ExpressiveAbstract #### Count [](#count) Retorna um valor inteiro representando a contagem de registros na persistência. ``` $count = (new Pessoa()) ->count() //$count = Pessoa::make([])->last($arguments = []); ``` #### Create [](#create) Cria um novo registro na persistência de acordo com os valores fornecidos para construção do objeto por meio do make. ``` Pessoa::make([ "proNome" => 'Fulano - ' . uniqid(rand()), "proInscricaoFederal" => '' . rand(11111111111111, 99999999999999) . '', "proTipo" => 1 ])->create(); ``` #### Delete [](#delete) Deleta um registro na persistência de acordo com as informações atribuidas ao active record. ``` Pessoa::make([ 'proID' => 1 ])->search()->delete(); ``` #### Last [](#last) Retorna o último registro na persistencia de acordo com as informações atribuidas ao active record. ``` (new Pessoa())->last() //Pessoa::make([])->last(); ``` ### Replicate [](#replicate) Replica um registro existente na persistência de acordo com as informações atribuidas ao active record. ``` $instance = Pessoa::make([ 'proID' => 1, ])->last(); $instance->replicate(); ``` ### Search [](#search) Retorna um registro existente na persistência de acordo com as informações atribuidas ao active record. ``` $instance = Pessoa::make([ 'proID' => 1 ])->search(); ``` ### Select [](#select) Retorna uma relação de registros existentes na persistência de acordo a relação de argumentos e opções fornecidas. ``` $result = (new Pessoa())->select(); //$result = Pessoa::make([])->select($arguments = [], $options = []); ``` ### Update [](#update) Atualiza um registro existente na persistência de acordo com as informações atribuidas ao active record. ``` $instance = Pessoa::make( [ 'proID' => 1, ] )->search(); $instance->proNome = 'UPDATE TEST [ ' . Date('Y-m-d H:m:s') . ']'; $instance->update(); ``` Change log ---------- [](#change-log) Acompanhe o [CHANGELOG](CHANGELOG.md) para informações sobre atualizações recentes. Testing ------- [](#testing) ``` $ composer test ``` License ------- [](#license) The MIT License (MIT). Verifique [LICENSE](LICENSE.MD) para mais informações. ### Health Score 33 — LowBetter than 75% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity15 Limited adoption so far Community10 Small or concentrated contributor base Maturity72 Established project with proven stability Bus Factor1 Top contributor holds 95.5% 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 ~90 days Recently: every ~433 days Total 21 Last Release 1429d ago Major Versions 0.5.1 → v1.0.02017-08-08 v1.2.4 → v100.0.02017-09-25 ### Community Maintainers ![](https://www.gravatar.com/avatar/9e81f41c2938cae87b956df83b30bfb165b395bda6cd28b77581e4d36c87c1a3?d=identicon)[conectra](/maintainers/conectra) --- Top Contributors [![realfabecker](https://avatars.githubusercontent.com/u/140275759?v=4)](https://github.com/realfabecker "realfabecker (64 commits)")[![gabrielrassweiler](https://avatars.githubusercontent.com/u/78365165?v=4)](https://github.com/gabrielrassweiler "gabrielrassweiler (3 commits)") ### Embed Badge ![Health badge](/badges/conectra-expressive/health.svg) ``` [![Health](https://phpackages.com/badges/conectra-expressive/health.svg)](https://phpackages.com/packages/conectra-expressive) ``` ### Alternatives [mongodb/laravel-mongodb A MongoDB based Eloquent model and Query builder for Laravel 7.1k7.2M71](/packages/mongodb-laravel-mongodb)[dyrynda/laravel-cascade-soft-deletes Cascading deletes for Eloquent models that implement soft deletes 1.2k3.1M5](/packages/dyrynda-laravel-cascade-soft-deletes)[tightenco/parental A simple eloquent trait that allows relationships to be accessed through child models. 1.5k1.8M5](/packages/tightenco-parental)[watson/validating Eloquent model validating trait. 9723.3M47](/packages/watson-validating)[cybercog/laravel-ban Laravel Ban simplify blocking and banning Eloquent models. 1.1k651.8k11](/packages/cybercog-laravel-ban)[dyrynda/laravel-model-uuid This package allows you to easily work with UUIDs in your Laravel models. 4802.8M8](/packages/dyrynda-laravel-model-uuid) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)