PHPackages                             molecular/molecularframework - 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. molecular/molecularframework

ActiveLibrary

molecular/molecularframework
============================

0.2.1.1(8y ago)5381PHP

Since May 28Pushed 7y ago2 watchersCompare

[ Source](https://github.com/toninho09/MolecularFramework)[ Packagist](https://packagist.org/packages/molecular/molecularframework)[ RSS](/packages/molecular-molecularframework/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (4)Dependencies (1)Versions (8)Used By (0)

Molecular
=========

[](#molecular)

### Sobre

[](#sobre)

Molecular foi criado como sendo um framework extremamente leve e minimalista, contendo apenas o exencial para o inicio de um projeto, sem dependencias de pacotes externos o framework foi totamente escrito com foco em performance com o menor overhead possivel para o servidor de aplicaçao, tornando o framework uma otima escolha na criaçao de APIs e micro serviços.

### Criando um novo projeto

[](#criando-um-novo-projeto)

Para criar um novo projeto basta utilizar o composer. atraves do comando :

```
composer create-project --prefer-dist molecular/molecularframework MyAwesomeAPI

```

Rotas
-----

[](#rotas)

O Molecular já possui um modulo de rotas capaz de registrar rotas por Methods seguindo o padrão REST ou com um método customizado, ligando a rota a execução de uma função anonima, ou método de um controller

##### Criando uma rota para uma função anonima

[](#criando-uma-rota-para-uma-função-anonima)

```
route()->get("/",function(){
   return 'is alive =)';
});
```

##### Criando uma rota para um método de um controller

[](#criando-uma-rota-para-um-método-de-um-controller)

```
route()->get('/index','\App\Controller\HomeController@index');
```

##### Methods do request

[](#methods-do-request)

É possivel criar rotas com qualquer método do padrão REST ou com algum Methods Customizado

```
route()->get('/get','\App\Controller\HomeController@get');
route()->post('/post','\App\Controller\HomeController@post');
route()->put('/put','\App\Controller\HomeController@put');
route()->delete('/delete','\App\Controller\HomeController@delete');
route()->option('/option','\App\Controller\HomeController@option');
route()->path('/path','\App\Controller\HomeController@path');
route()->head('/head','\App\Controller\HomeController@head');
route()->any('/any','\App\Controller\HomeController@any');
```

Também é possivel criar algum método customizado, tanto para um Method especifico quanto para um array de Methods

```
route()->custom('CUSTOM','/custom','\App\Controller\HomeController@custom');
route()->custom(['FOO','BAR'],'/customArray','\App\Controller\HomeController@customArray');
```

### Grupo de rotas

[](#grupo-de-rotas)

Um grupo de rotas permite que os middlewares e prefix das rotas sejam compartilhadas com todas as rotas que pertencem ao mesmo grupo

Exemplo de grupo de rotas

```
route()->group('api', function ($group) {

    /** @var \Molecular\Routes\RouteDispacher $group */

    $group->get('get', function () {
        return 'responde';
    });

    $group->get('/get','\App\Controller\HomeController@get');
});
```

Middlewares
-----------

[](#middlewares)

Os middlewares do Molecular funcionam como o padrão decorator, onde o resultado do middleware anterior é passado para o próximo através do comando `next`, após o ultimo middleware responder, as chamadas são retornadas por todos os middlewares do ultimo para o primeiro, para qualquer tratamento após a execução.
Um middleware deve obrigatóriamente implementar a interface `\Molecular\Routes\Middleware\Middleware`.
Exemplo de um middleware que adiciona `foo` antes do payload e `bar` após o payload

```
use Molecular\Http\Request;
use Molecular\Http\Response;
use Molecular\Routes\Middleware\Middleware;

class FooMiddleware extends Middleware
{

    public function handle(Request $request, Response $response)
    {
        $response->setResponseContent('foo');
        $this->next($request,$response);
        $response->setResponseContent('bar');
    }
}
```

#### Adicionando um Middleware a uma rota ou grupo de rotas

[](#adicionando-um-middleware-a-uma-rota-ou-grupo-de-rotas)

Um middleware pode ser adicionado a uma rota qualquer ou a um grupo de rotas. Adicionando um middleware a uma rota

```
route()->get('/get','\App\Controller\HomeController@get',['middleware'=>[FooMiddleware::class]]);
```

Da mesma forma que é possivel adicionar um middleware a uma rota, também é possivel adicionar um middleware a um grupo de rota, dessa forma, todas as rotas que estiverem dentro do grupo sofrerão o efeito do middleware

```
route()->group('api', function ($group) {

    /** @var \Molecular\Routes\RouteDispacher $group */

    $group->get('get', function () {
        return 'responde';
    });

    $group->get('/get','\App\Controller\HomeController@get');
},['middleware'=>[FooMiddleware::class]]);
```

Controllers
-----------

[](#controllers)

Os controllers não necessitam nenhuma classe especial para funcionarem, servem apenas como um ponto de execução para a rota, por enquanto não existe nenhum tipo de injeção de dependencia na contrução de um novo controller, dessa forma é recomendado que seja criado as dependencias no construtor ao invés de serem injetadas. Um controller deve retornar uma `string`, ou um objeto que tenha o método `__toString` implementado, caso o retorno seja uma view, essa já possui o método `__toString` implementado.

```
use App\Model\HomeModel;

class HomeController
{
    public function index(){
        $model = new HomeModel();
        $model->work = "it's Work";
        return  view('home.php',['model'=>$model]);
    }

}
```

Resolve
-------

[](#resolve)

O Molecular possui uma biblioteca interna que consegue resolver a criação de uma classe Através do método `resolve` é possivel passar o caminho de uma classe, o método retorna a classe instanciada a menos que algum item não tenha um valor padrão na criação do objeto

```
class Bar
{
    public $bar;
    public function __construct($bar = 10){
        $this->bar = $bar;
    }
}

class Foo
{
    public $bar;
    public function __construct(Bar $bar){
        $this->bar = $bar;
    }
}

$foo = resolve(Foo::class);
echo $foo->bar->bar; // 10
```

Caso a classe que esteja sendo criada não tenha tipagem no atributo do construtor, ou não tenha valor padrão, a criação irá lançar uma exception

```
class invalidclass
{
    public function __construct($bar){
        $this->bar = $bar;
    }
}
$foo = resolve(invalidclass::class); //Exception
```

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity58

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 ~96 days

Recently: every ~119 days

Total

6

Last Release

3158d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9f43758479e2ccb4212691a2239574ee3d428cc800763de0f7fe6eb2f78b1721?d=identicon)[toninho09](/maintainers/toninho09)

---

Top Contributors

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

---

Tags

fastframeworklaravelmicroframeworkmicroservicephp

### Embed Badge

![Health badge](/badges/molecular-molecularframework/health.svg)

```
[![Health](https://phpackages.com/badges/molecular-molecularframework/health.svg)](https://phpackages.com/packages/molecular-molecularframework)
```

PHPackages © 2026

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