PHPackages                             matryoshka-app/sdk-php-core - 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. [Utility & Helpers](/categories/utility)
4. /
5. matryoshka-app/sdk-php-core

ActiveLibrary[Utility & Helpers](/categories/utility)

matryoshka-app/sdk-php-core
===========================

SDK core on php. Can be used to embed in your favorite framework.

0.05(6y ago)014MITPHPPHP ^7.1

Since Jun 21Pushed 5y ago1 watchersCompare

[ Source](https://github.com/matryoshka-app/sdk-php-core)[ Packagist](https://packagist.org/packages/matryoshka-app/sdk-php-core)[ Docs](https://matryoshka.app/)[ RSS](/packages/matryoshka-app-sdk-php-core/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (7)Dependencies (1)Versions (9)Used By (0)

sdk-php-core
============

[](#sdk-php-core)

SDK core on php for create backend side for your [matreshka app](https://matryoshka.app/docs/about/en). Can be used to embed in your favorite framework.

### Start

[](#start)

`composer require matryoshka-app/sdk-php-core`

### Run

[](#run)

You should call Matryoshka\\Matryoshka->start() for start app. example:

```
$matryoshka = new Matryoshka();
$response = $matryoshka->start();
echo $response;
```

### Handlers

[](#handlers)

Handlers extended Matryoshka\\Handlers\\Handler abstract class. You should set uri and handler for you handler. You can use uri system for easy understanding how to use the payload.

Example:

```
class MockHandler extends Handler {
    static function getURI() {
        return 'test/1';
    }

    function handler() {
        $menuItem = new MenuItem();
        $menuItem->title = new Text('test');

        $response = $this->getResponse();
        $response->menu->add($menuItem);
        $response->addWidget(new Text('testim'));
    }
}
```

On example below we created new handler and declared required methods getURI() and handler(). getURI() - should return uri string. handler() - your logic and build response for reply.

Now you should add new handlers for you requests. Handlers need be registered on sdk.

```
$matryoshka->getHandlerManager()->addHandler(SomeHandler::class);
```

URI - contained payload parameter according http uri interface.

- You can use url and query string `/users/profile?id=2&full_profile=true` after '?'
- You can pass for you handler as http request. You can get it on you handler `$this->getRequest()->uri` and array query string `$this->getRequest()->query`.
- Or you can use full payload content on `$this->getRequest()->payload`.

### Links

[](#links)

[Matryoshka API Docs](http://matryoshka.app/docs/)

[Example framework on php using this sdk](https://github.com/matryoshka-app/framework-php)

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity49

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

Recently: every ~24 days

Total

8

Last Release

2411d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/a4fd302a77d22fdbc4bf0ab08cbd69d7a3925e467ddebc083487d9915ed74d64?d=identicon)[Catsys](/maintainers/Catsys)

---

Top Contributors

[![octopurpie](https://avatars.githubusercontent.com/u/6561435?v=4)](https://github.com/octopurpie "octopurpie (10 commits)")

---

Tags

phpsdkmatryoshka

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/matryoshka-app-sdk-php-core/health.svg)

```
[![Health](https://phpackages.com/badges/matryoshka-app-sdk-php-core/health.svg)](https://phpackages.com/packages/matryoshka-app-sdk-php-core)
```

PHPackages © 2026

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