PHPackages minerva-sistemas/silk-orm - 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. minerva-sistemas/silk-orm ActiveLibrary[Database & ORM](/categories/database) minerva-sistemas/silk-orm ========================= Object Relational Mapper for zend-db v1.3.5(8y ago)04.8kMITPHP Since Aug 12Pushed 8y agoCompare [ Source](https://github.com/minerva-sistemas/silk-orm)[ Packagist](https://packagist.org/packages/minerva-sistemas/silk-orm)[ RSS](/packages/minerva-sistemas-silk-orm/feed)WikiDiscussions master Synced 4w ago READMEChangelog (10)Dependencies (4)Versions (18)Used By (0) [![](https://camo.githubusercontent.com/7776c6ae3778956a4b09c05be51ae0cc84b81b177bb9071211af1efcaccd0370/687474703a2f2f692e696d6775722e636f6d2f6b3436344177392e706e67)](https://camo.githubusercontent.com/7776c6ae3778956a4b09c05be51ae0cc84b81b177bb9071211af1efcaccd0370/687474703a2f2f692e696d6775722e636f6d2f6b3436344177392e706e67) ========================================================================================================================================================================================================================================================================================================================================= [](#) [![License](https://camo.githubusercontent.com/95c9d52c0043d590d5f07bb64039b8c76eaf3d0f0ec9a1b57fef685965ff812c/68747470733a2f2f706f7365722e707567782e6f72672f68616d626f6c64742f73696c6b2d6f726d2f6c6963656e7365)](https://packagist.org/packages/hamboldt/silk-orm) [![Scrutinizer Code Quality](https://camo.githubusercontent.com/16007117386ea74cdd7a6d50458e75fec190e7f68495670413343600859403cc/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6d696e657276612d73697374656d61732f73696c6b2d6f726d2f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/minerva-sistemas/silk-orm/?branch=master) [![Total Downloads](https://camo.githubusercontent.com/107fb8d4c98e2ed1918ce8bbae2a4af03cda4a068e7c757cfc528c73c38dddad/68747470733a2f2f706f7365722e707567782e6f72672f6d696e657276612d73697374656d61732f73696c6b2d6f726d2f646f776e6c6f616473)](https://packagist.org/packages/hamboldt/silk-orm) [![Latest Stable Version](https://camo.githubusercontent.com/6de22f2fc3e1aa33a7962c4ab833f05a0a21acf6c5fd85bc1eb27a2fc13c7264/68747470733a2f2f706f7365722e707567782e6f72672f6d696e657276612d73697374656d61732f73696c6b2d6f726d2f762f737461626c65)](https://packagist.org/packages/hamboldt/silk-orm) O ORM Silk (seda em inglês) é um sistema de mapeamento de objetos integrado com a estrutura do Zend Framework 2 que foi pensado para ser prático, leve, e de fácil configuração. Ele permite transformar tabela em objetos e posteriormente acessar os dados utilizando o padrão de busca SQL do Zend. Em outras palavras, o papel dele é mapear seus objetos apenas em nível de arrays. Todo o resto fica com o Zend - transação de arrays com o banco de dados. `composer require minerva-sistemas/silk-orm` ### Como funciona [](#como-funciona) - [Configure um banco de dados](https://gist.github.com/hamboldt/b873f19576623f06607a) - [Configure um objeto](https://gist.github.com/hamboldt/ad2ed7cf50c028b57373) - [Configure um objeto relacionado](https://gist.github.com/hamboldt/463eab6bbb92559ee2cb) ### Configurações [](#configurações) ##### Classes [](#classes) - `@configure {"schema":"Cadastro"}` - Especifica qual o schema da tabela, se em branco é adotado o schema padrão. - `@configure {"table":"table_name"}` - Especifica qual é a tabela do objeto no banco de dados. - `@configure {"primary_key":"idtable"}` - Especifica qual é a chave primária da tabela. ##### Propriedades [](#propriedades) - `@configure {"ignore":true}` - Ignora a propriedade do objeto na construção das queries. - `@configure {"ignoreIfNull":true}` - Ignora a propriedade do objeto, apenas se nula. - `@configure {"alias":"somecolumn"}` - Especifica o nome da coluna da propriedade na tabela. - `@configure {"type":"\\Garage\\Car"}` - Instanciamento automático de objetos mapeáveis. ### Como usar [](#como-usar) #### Instanciamento [](#instanciamento) O exemplo abaixo deve ser seguido quando formos instanciar apenas um objeto. Pode-se usar perfeitamente as clausulas where do Zend tal como usa-se em seus TableGateways, afinal, o Silk usa o TableGateway do ZF2 para construir seus resultados. ``` $user = new User(1); // pelo valor da chave primária $user = new User(["name"=>"lucas"]); // por um where com array $user = new User(function(Select $select){ /* ... */ }); // Pelo select do zf2 ``` #### Multipla seleção [](#multipla-seleção) O exemplo abaixo deve ser seguido quando formos instanciar múltiplos objetos. Para armazenar coleções de objetos, usamos a biblioteca [easyframework/collections](https://github.com/italolelis/collections). ``` $collection = User::select(["name"=>"lucas"]); $collection = User::select(function(Select $select){ /* ... */ }); $collection->map(function(User $user){ echo $user->getCompany()->getName() . "\n"; }); ``` #### Inserindo novo registro [](#inserindo-novo-registro) Quando o objeto é instanciado e não se passa nenhum valor no construtor como parâmetro ele é criado vazio, isto é, não vai ter nenhum valor, nem uma id definida para o mesmo. Quando o objeto tem um id nulo (`$company->getId() == null`) ao chamar o método *save()* um novo registro será inserido no banco. Se ele ja tiver um id definido, o registro será atualizado. ``` $company = new Company(); $company->setName("Minerva Engenharia de Sistemas"); $company->save(); echo $company->getId(); // 1 ``` [![](https://camo.githubusercontent.com/493104bfd23d5dbf9cb18b6ff06834f126e336b7c580fa06973d76686510392f/687474703a2f2f692e696d6775722e636f6d2f4a5231554f49762e706e673f31)](https://camo.githubusercontent.com/493104bfd23d5dbf9cb18b6ff06834f126e336b7c580fa06973d76686510392f/687474703a2f2f692e696d6775722e636f6d2f4a5231554f49762e706e673f31) #### Atualizando um registro [](#atualizando-um-registro) Quando o objeto já possui uma id definida, e chamamos o método `save()`o registro cuja chave primária for a id do objeto será atualizado no banco de dados, conforme o exemplo abaixo. ##### Instanciamento por chave primária [](#instanciamento-por-chave-primária) ``` $company = new Company(1); $company->setName("Minerva"); $company->save(); ``` ##### Instanciamento por array explicita [](#instanciamento-por-array-explicita) ``` $company = new Company(['idcompany' => 1]); $company->setName("Minerva"); $company->save(); ``` ##### Instanciamento por where do ZF2 [](#instanciamento-por-where-do-zf2) ``` $company = new Company(function(Select $select){ $select->where->equalTo('idcompany', '1'); $select->limit(1); }); $company->setName("Minerva"); $company->save(); ``` ##### Atualizando múltiplos registros [](#atualizando-múltiplos-registros) Atualiza todos os registros onde a coluna nome tiver o valor 'Softwerk'. ``` Company::select(['name' => 'Minerva'])->map(function(Company $company){ $company->setName('Minerva Engenharia de Sistemas'); $company->save(); }); ``` #### Removendo um registro [](#removendo-um-registro) Um objeto só será removido quando o sua id estiver definida, assim como nas operações de atualização. Para remover um registro do banco de dados basta chamar o método `delete()` do objeto, assim como no exemplo abaixo. ``` $company = new Company(1); $company->delete(); ``` ##### Removendo vários registros [](#removendo-vários-registros) Exemplo abaixo irá remover todos os objetos onde o valor da coluna `name` for igual a `Softwerk`. ``` Company::select(['name' => 'Minerva'])->map(function(Company $company){ $company->delete(); }); ``` ### Health Score 33 — LowBetter than 72% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity17 Limited adoption so far Community8 Small or concentrated contributor base Maturity72 Established project with proven stability Bus Factor1 Top contributor holds 97.6% 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 ~58 days Recently: every ~25 days Total 17 Last Release 3049d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/b2bcc2e83e3aa7c9b2b1f5e9b0fd9444580a5e97a12ffae9c88903040360be76?d=identicon)[hamboldt](/maintainers/hamboldt) --- Top Contributors [![lucasdearaujo](https://avatars.githubusercontent.com/u/2407611?v=4)](https://github.com/lucasdearaujo "lucasdearaujo (82 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (2 commits)") ### Embed Badge ![Health badge](/badges/minerva-sistemas-silk-orm/health.svg) ``` [![Health](https://phpackages.com/badges/minerva-sistemas-silk-orm/health.svg)](https://phpackages.com/packages/minerva-sistemas-silk-orm) ``` ### Alternatives [hounddog/doctrine-data-fixture-module Zend Framework 2 Module that provides Doctrine Data-Fixture functionality 37335.9k9](/packages/hounddog-doctrine-data-fixture-module)[mamuz/mamuz-blog Provides blog feature for ZF2 with Doctrine 101.1k1](/packages/mamuz-mamuz-blog) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)