PHPackages                             makiavelo/flex - 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. makiavelo/flex

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

makiavelo/flex
==============

0.0.1.x-dev(4y ago)05PHP

Since Sep 28Pushed 4y ago1 watchersCompare

[ Source](https://github.com/Makiavelo/flex)[ Packagist](https://packagist.org/packages/makiavelo/flex)[ RSS](/packages/makiavelo-flex/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependencies (2)Versions (2)Used By (0)

Flex
====

[](#flex)

Flexible and minimalistic ORM tool for fast prototyping and development of PHP/MySQL applications. The main approach is to have flexible models without worrying about database schemas (like NoSQL), after that initial phase, the database can be freezed and handled manually (usual MySQL).

What we offer:

- Micro ORM
- Relationships (Belongs, Has, HasAndBelongs)
- Lazy loading
- Traits (Reusable behaviors)
- Query hydrator
- Handling nested relationships
- Transactions
- Batch operations

Full documentation
------------------

[](#full-documentation)

Full documentation, examples and tutorials here:

Requirements
------------

[](#requirements)

PHP, MySQL and a table to work on. No table creation required nor model generation required.

Install with composer
---------------------

[](#install-with-composer)

```
composer require makiavelo/flex

```

Or update dependencies in composer.json

```
"require": {
    "makiavelo/flex": "dev-master"
}
```

Install with single file
------------------------

[](#install-with-single-file)

The repository contains a phar file which can be included directly to avoid using composer. The phar can be found here: `/phar/flex.phar`

```
include('flex.phar');

use Makiavelo\Flex\Flex;
use Makiavelo\Flex\FlexRepository;
```

Quick tour
----------

[](#quick-tour)

### Need a quick script? we got you

[](#need-a-quick-script-we-got-you)

Here's a quick example of an implementation. No dependencies, no config, just start. You only need an empty database and access to it.

let's say we have a json to dump into a db:

```
$repo = FlexRepository::get();
$repo->connect([
    'host' => 'localhost',
    'db' => 'flex_test',
    'user' => 'myuser',
    'pass' => 'mypass'
]);

$json = '[{"name":"John", "last_name": "Doe"},...]'; // Dots to represent lots of other users

$data = json_decode($json, true);

foreach ($data as $userData) {
    $model = new Flex();
    $model->meta()->add('table', 'user');
    $model->name = $userData['name'];
    $model->last_name = $userData['last_name'];
    $repo->save($model);
}

$repo->saveCollection($models);

// Or shorter
foreach ($data as $userData) {
    $repo->create('user');
    $model->hydrate($userData);
    $repo->save($model);
}

// More efficient?
// Multiple inserts in a single query
$models = [];
foreach ($data as $userData) {
    $repo->create('user');
    $model->hydrate($userData);
    $models[] = $model;
}
$repo->saveCollection($models);
```

In this case, only the database is required, the 'user' table will be created automatically and store all the data imported from the JSON.

### Need a strong model? we got you

[](#need-a-strong-model-we-got-you)

So you liked it and want a full blown model, we got your back, any class can extend 'Flex' and use all of the available features. Let's say we have a blog, and want to handle posts in different languages and tag them.

The code:

```
$blogPost = new BlogPost();

$blogPost->setTitle('Blog post title');
$blogPost->setDescription('A long body');
$blogPost->setShortDescription('Short description');

$blogPost->translations()->add(
    $blogPost->translation('es', [
        'title' => 'Titulo de post',
        'description' => 'Un cuerpo largo en espanol',
        'short_description' => 'Descripcion corta'
    ])
);

$blogPost->setTags([
    Tag::build(['name' => 'News'],
    Tag::build(['name' => 'Programming'],
    Tag::build(['name' => 'Jobs']
]);

FlexRepository::get()->save($blogPost);
```

In this example we are using:

- Custom defined model
- Traits (Translatable)
- Relations ('Has' tags relation)

This model:

```
use Makiavelo\Flex\Traits\Translatable;

class BlogPost extends Flex
{
    use Translatable;

    public $id;
    public $title;
    public $description;
    public $short_description;

    public function __construct()
    {
        parent::__construct();

        // Define the table for this model
        $this->meta()->add('table', 'post');

        // Define the 'Tags' relation
        $this->relations()->add([
            'name' => 'Tags',       // The name of the relation
            'table' => 'tag',       // The table of the relation
            'class' => 'Tag',       // The class of the related model
            'key' => 'blog_post_id', // The foreign key in the related table
            'type' => 'Has',        // The type of the relation
        ]);

        // Adding the trait/behavior
        $this->_translatableInit();
    }
}
```

### Need to search stuff? we got you

[](#need-to-search-stuff-we-got-you)

Using flex you can use the database any way you want. You will have access directly to PDO if needed. Let's write a complex query with relations (based on previous example), and see how we handle them:

Example:

```
$repo = FlexRepository::get();

// Fetch a blog post with relations joined
$query = "SELECT * FROM blog_post
            JOIN blog_post_translation ON blog_post_translation.blog_post_id = blog_post.id
            JOIN tag ON tag.blog_post_id = blog_post.id
          WHERE blog_post.id = :id";

// Add query parameters
$params = [':id' => $id];

// Add options for hydrating the results
$options = ['table' => 'blog_post', 'class' => 'BlogPost'];

$blogPosts = $repo->query($query, $params, $options);
$blogPost = $blogPosts[0];

echo $blogPost->getTitle();
echo $blogPost->getDescription();
echo $blogPost->getShortDescription();

$blogPost->getTranslations(); // Get all the translations
$blogPost->translations()->with('locale' = 'es')->fetch(); // Get spanish translations
$blogPost->tags()->not()->with('name' => 'News')->exist(); // Are there tags other than 'News' ?
$blogPost->tags()->with(['name' => 'Programming'])->remove(); // Remove programming tags
$blogPost->tags()->clear(); // Remove all tags
$blogPost->translations()->not()->with('locale' => 'es')->remove(); // Remove non-spanish translations

$repo->save($blogPost);
```

As you can see, the query is whatever you need it to be. No complex builders or headaches. Flex will automatically hydrate all the records, you only need to provide the main Class and table, all the relations will be extracted recursively from there. You can turn off hydration (options array) or use PDO directly if only an array is needed. **Models support lazy loading**, so if the relation tables weren't joined in the original query, Flex will try to fetch them when you try to use them.

Classes documentation
---------------------

[](#classes-documentation)

The documentation of the classes can be found in the 'phpdocs' folder. Can be viewed online on github pages here:

###  Health Score

18

—

LowBetter than 8% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity37

Early-stage or recently created project

 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

Unknown

Total

1

Last Release

1739d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1018279?v=4)[Makiavelo](/maintainers/Makiavelo)[@Makiavelo](https://github.com/Makiavelo)

---

Top Contributors

[![Makiavelo](https://avatars.githubusercontent.com/u/1018279?v=4)](https://github.com/Makiavelo "Makiavelo (51 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/makiavelo-flex/health.svg)

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

###  Alternatives

[teamones/etcd-discovery

Teamones框架Etcd服务注册和发现组件

107.7k1](/packages/teamones-etcd-discovery)

PHPackages © 2026

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