Weave Code
Dynamo Db Laravel Package
async-aws/dynamo-db
AsyncAws DynamoDb is a lightweight PHP client for Amazon DynamoDB, designed for AsyncAws. Install via Composer and use it to perform DynamoDB operations with a modern API. Full documentation and contribution guidelines available at async-aws.com.
[READ ONLY] DynamoDB client
Frequently asked questions about Dynamo Db
- How do I install async-aws/dynamo-db in a Laravel app?
- Install the package with composer require async-aws/dynamo-db. Then bind the DynamoDb client in a Laravel service provider or resolve it through the container where needed. Configure AWS credentials and the correct AWS region before making requests.
- Is async-aws/dynamo-db compatible with Laravel 10 and Laravel 11?
- It is a PHP package that can integrate with Laravel through the service container and dependency injection, but it is not Laravel-specific. Test it against Laravel 10.x and 11.x LTS releases and confirm your PHP version meets Laravel requirements, such as PHP 8.1 or newer. Pin dependency versions to avoid surprise breaking changes.
- What DynamoDB operations does async-aws/dynamo-db support?
- The package is positioned as a read-only DynamoDB client, so it is intended for read-focused use cases rather than full table management. Verify exact operation coverage for Scan, Query, GetItem, BatchGetItem, filter expressions, projections, and pagination in the AsyncAws documentation. For write operations, pair it with the AWS SDK or another write-capable service.
- Can I use async-aws/dynamo-db for writing data to DynamoDB?
- No, the provided assessment describes this package as a read-only DynamoDB client. If your Laravel application needs PutItem, UpdateItem, DeleteItem, or other writes, use aws/aws-sdk-php or route writes through a separate API or Lambda. Design the system so read operations use this client and writes are handled elsewhere.
- How do I configure AWS credentials and region for DynamoDb in Laravel?
- Use environment variables such as AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, and AWS_DEFAULT_REGION, or centralize them in a Laravel config file such as config/aws.php. Make sure the configured region and DynamoDB endpoint match your table location. For local development, point the client at a LocalStack DynamoDB endpoint.
- How should I bind the DynamoDb client in Laravel's service container?
- Register the client as a singleton in AppServiceProvider or a dedicated DynamoDb service provider. Inject it into repositories, services, or queue jobs instead of creating it repeatedly. You can also create a facade for cleaner syntax such as DynamoDb::scan, but keep credentials in configuration rather than hardcoding them.
- Can async-aws/dynamo-db be used inside Laravel queue jobs?
- Yes, it fits well with Laravel queue workers and event listeners that need background DynamoDB reads without blocking HTTP requests. Implement ShouldQueue on jobs that fetch DynamoDB data for analytics or processing. Use persistent queue workers to reduce cold-start effects and avoid repeated client setup.
- How do I test async-aws/dynamo-db with LocalStack or mocks in Laravel?
- Use LocalStack to run a local DynamoDB instance for integration tests, and configure the client endpoint and test credentials accordingly. For unit tests, mock the client with Mockery or use Laravel testing helpers around your own repository layer. DynamoDB-specific assertions such as assertQueryResult may require custom test helpers.
- What are the production risks of using a read-only DynamoDB client in Laravel?
- The main risk is the read-only limitation, so writes must be handled by another service, the AWS SDK, or an API layer. Handle throttling errors such as ProvisionedThroughputExceeded with retries, custom exceptions, and a fallback such as Redis or your database. Monitor AWS SDK updates, pin Composer versions, and watch for deprecation or compatibility changes.
- What are the alternatives to async-aws/dynamo-db for DynamoDB access in Laravel?
- The official aws/aws-sdk-php is the broad alternative when you need full DynamoDB read and write support. If you only need lightweight read operations, async-aws/dynamo-db can be paired with a separate write-capable service or SDK usage. You may also add Laravel caching or database fallbacks for resilience and cost control.
Weaver
How can I help you explore Laravel packages today?