Awesome

php-redis-om 🗄️

A PHP object mapper for Redis.

An Object Mapper for Redis®, designed to providing an intuitive and familiar interface for PHP developers to interact with Redis.

Features 🛠️

Doctrine-like methods and architecture
Symfony bundle integration
Easy integration with existing PHP applications
High performance and scalability with Redis®
Support for Redis JSON module
Automatic schema generation
Search and query capabilities

Requirements ⚙️

PHP 8.2 or higher
Redis 4.0 or higher
Redisearch module (available by default with Redis >8) (installation)
php-redis extension OR Predis library
Redis JSON module (optional)
Composer

Supported types ✅

scalar (string, int, float, bool, double)
timestamp
json
null
DateTimeImmutable
DateTime
array and nested arrays
object and nested objects
stdClass

Installation 📝

Install the library via Composer:

composer require talleu/php-redis-om

Depending on your configuration, use phpredis or Predis

Symfony bundle 🎵

In a Symfony application, you may need to add this line to config/bundles.php

    Talleu\RedisOm\Bundle\TalleuRedisOmBundle::class => [‘all’ => true],

And that's it, your installation is complete ! 🚀

Basic Usage 🎯

Add the RedisOm attribute to your class to map it to a Redis schema:

<?php 

use Talleu\RedisOm\Om\Mapping as RedisOm;

#[RedisOm\Entity]
class User
{
    #[RedisOm\Id]
    #[RedisOm\Property]
    public int $id;

    #[RedisOm\Property(index:true)]
    public string $name;

    #[RedisOm\Property]
    public \DateTimeImmutable $createdAt;
}

After add the RedisOm attribute to your class, you have to run the following command to create the Redis schema for your classes (default path is ./src):

For Symfony users :

bin/console redis-om:migrate

For others PHP applications :

vendor/bin/redisMigration <YOUR DIRECTORY PATH>

Then you can use the ObjectManager to persist your objects from Redis ! 💪

For Symfony users, just inject the RedisObjectManagerInterface in the constructor :

    <?php

    namespace App\Controller;
    
    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
    use Talleu\RedisOm\Om\RedisObjectManagerInterface;
    use App\Entity\Book;

    class MySymfonyController extends AbstractController
    {
        public function __construct(private RedisObjectManagerInterface $redisObjectManager)
        {}
        
        #[Route('/', name: 'app_home')]
        public function index(): Response
        {
            $book = new Book();
            $book->name = 'Martin Eden';
            $this->redisObjectManager->persist($book);
            $this->redisObjectManager->flush();
    
           //..
        }
    }