README

DynamoPHP is a strongly-typed, attribute-based Object Data Mapper for Amazon DynamoDB. It is built on top of modern PHP, which enables definition of entities using PHP 8+ attributes and interaction with DynamoDB using a clean, expressive API.

Inspired by data mappers like Doctrine and modeled after patterns in libraries such as TypeDORM.

Features

• Entity Management: automatically handles CRUD operations.
• Index Support: work with Global Secondary Indexes (GSI) and Local Secondary Indexes (LSI).
• Query Builder: build complex queries with minimal boilerplate.

Installation

You can install DynamoPHP via Composer:

composer require edumarques/dynamophp

Documentation

For detailed usage, please refer to the sections below.

Quickly get started:

• Basic Usage Guide

Learn how DynamoPHP works as an ODM for mapping your objects to DynamoDB:

• Object Data Mapping

Learn how to define and manage your entities:

• Entity

Learn how to use Global Secondary Indexes (GSI) and Local Secondary Indexes (LSI):

• Indexes

Learn how the EntityManager is used for managing entities and interactions with DynamoDB:

• Entity Manager

Documentation is an ongoing effort. Our docs will continue to evolve as the project grows — contributions and improvements are welcome and encouraged!

Contributing

Contributors are always welcome! For more information on how you can contribute, please read our contribution guideline.

For any questions, feel free to reach out to me directly by email: eduardomarqs1@gmail.com.

Integration

For seamless integration with Symfony applications, a dedicated Symfony Bundle is available: edumarques/dynamophp-symfony.