PHPackages                             arthurtavaresdev/temaki - 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 &amp; ORM](/categories/database)
4. /
5. arthurtavaresdev/temaki

ActiveLibrary[Database &amp; ORM](/categories/database)

arthurtavaresdev/temaki
=======================

v0.1.6(1y ago)011.0k—9.2%MITPHPPHP &gt;=8.3

Since Apr 7Pushed 1y ago1 watchersCompare

[ Source](https://github.com/arthurtavaresdev/temaki)[ Packagist](https://packagist.org/packages/arthurtavaresdev/temaki)[ RSS](/packages/arthurtavaresdev-temaki/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (7)Dependencies (6)Versions (8)Used By (0)

Temaki
======

[](#temaki)

**Temaki** is a PHP library that combines the simplicity of [Sushi](https://github.com/calebporzio/sushi) with the flexibility of [sqlite-s3](https://github.com/mnapoli/sqlite-s3/), enabling Laravel applications to seamlessly and efficiently utilize SQLite databases stored on Amazon S3.

Motivation
----------

[](#motivation)

When developing serverless applications with Laravel, especially using platforms like AWS Lambda and Laravel Vapor, we encounter significant challenges related to data storage and management due to the ephemeral nature of these environments. The volatility of the file system in Lambda instances prevents local data persistence, making traditional database solutions less effective. Moreover, the need for an SQLite driver that operates efficiently and persistently on Amazon S3 is evident to ensure data integrity and availability. **Temaki** was conceived to address this need by integrating the functionalities of [Sushi](https://github.com/calebporzio/sushi) and [sqlite-s3](https://github.com/mnapoli/sqlite-s3/), providing a robust and efficient solution for data storage in serverless environments.

How?
----

[](#how)

The SQLite database (a file) is stored on S3. The PHP class will transparently download the file locally on every request, and upload it back at the end.

Features
--------

[](#features)

- **Integration with Laravel**: Use Temaki as an Eloquent driver to access data stored in SQLite files on S3.
- **Transparent Synchronization**: Temaki automatically manages the download and upload of the database between S3 and the local instance, ensuring data is always up-to-date.
- **Simplified Configuration**: Simply add the `Temaki` trait to your Eloquent model and configure your S3 credentials to get started.

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

[](#requirements)

- PHP 8.3 or higher
- Laravel 11.x or higher
- PHP `pdo_sqlite` extension
- Valid AWS credentials with access to S3 (Also works with minio)

Installation
------------

[](#installation)

You can install Temaki via Composer:

```
composer require arthurtavaresdev/temaki
```

Configuration
-------------

[](#configuration)

Set up S3 credentials: In your application's .env file, add the following variables:

```
AWS_ACCESS_KEY_ID=your-access-key-id
AWS_SECRET_ACCESS_KEY=your-secret-access-key
AWS_DEFAULT_REGION=your-region
AWS_BUCKET=your-bucket-name
```

Configure the Eloquent model:

Add the Temaki trait to your model and define the $sushiFilePath property with the path to the SQLite file on S3:

```
use Temaki\Temaki;

class YourModel extends Model
{
    use Temaki;

    public function getRows()
    {
        return [
            ['id' => 1, 'label' => 'admin'],
            ['id' => 2, 'label' => 'manager'],
            ['id' => 3, 'label' => 'user'],
        ];
    }
}
```

Usage
-----

[](#usage)

After configuration, you can use your Eloquent model as usual, and Temaki will handle the synchronization of data between S3 and the local instance.

Considerations
--------------

[](#considerations)

Temaki is ideal for development and testing environments in serverless architectures. For production environments, it's important to consider the implications of concurrency and latency associated with using databases stored on S3.

Contribution
------------

[](#contribution)

Contributions are welcome! Feel free to open issues and pull requests in the GitHub repository.

License
-------

[](#license)

This project is licensed under the MIT License.

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance47

Moderate activity, may be stable

Popularity27

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity47

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

Total

7

Last Release

391d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/40744942?v=4)[Arthur Tavares](/maintainers/arthurtavaresdev)[@arthurtavaresdev](https://github.com/arthurtavaresdev)

---

Top Contributors

[![arthurtavaresdev](https://avatars.githubusercontent.com/u/40744942?v=4)](https://github.com/arthurtavaresdev "arthurtavaresdev (12 commits)")

---

Tags

s3awssqliteserverless

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/arthurtavaresdev-temaki/health.svg)

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

###  Alternatives

[doctrine/dbal

Powerful PHP database abstraction layer (DBAL) with many features for database schema introspection and management.

9.7k578.4M5.6k](/packages/doctrine-dbal)[scienta/doctrine-json-functions

A set of extensions to Doctrine that add support for json query functions.

58723.9M36](/packages/scienta-doctrine-json-functions)[codesleeve/stapler

Elegant and simple ORM-based file upload package for php.

538366.4k5](/packages/codesleeve-stapler)[mnapoli/sqlite-s3

1042.7k](/packages/mnapoli-sqlite-s3)[renoki-co/l1

Laravel integration for Cloudflare Workers services.

16113.1k](/packages/renoki-co-l1)[nemo64/dbal-rds-data

rds-data driver for doctrine dbal

2713.2k](/packages/nemo64-dbal-rds-data)

PHPackages © 2026

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