urbanindo / yii2-dynamodb
DynamoDB extensions for Yii2
Installs: 66 211
Dependents: 0
Suggesters: 0
Security: 0
Stars: 14
Watchers: 7
Forks: 15
Open Issues: 4
Requires
- php: >=7.2
- aws/aws-sdk-php: ~3.28
- yiisoft/yii2: ~2.0.15
Requires (Dev)
- flow/jsonpath: dev-master
- fzaninotto/faker: dev-master
- phing/phing: 2.16.1
- phpunit/php-code-coverage: ^5.3
- phpunit/phpunit: 6.5.*
- squizlabs/php_codesniffer: 2.*
- yiisoft/yii2-coding-standards: *
This package is auto-updated.
Last update: 2024-10-22 17:25:00 UTC
README
This is a DynamoDB extension for Yii2
Requirement
This extension requires
- PHP minimum 7.0 and before 7.2 (Upgrade is still underwork)
- Yii2 minimum 2.0.13 and lesser than 2.1
- AWS PHP SDK 3.28
Installation
The preferred way to install this extension is through composer.
Either run
php composer.phar require --prefer-dist urbanindo/yii2-dynamodb "*"
or add
"urbanindo/yii2-dynamodb": "*"
to the require section of your composer.json
file.
Setting Up
After the installation, sets the dynamodb
component in the config.
return [ // ... 'components' => [ // ... 'dynamodb' => [ 'class' => 'UrbanIndo\Yii2\DynamoDb\Connection', 'config' => [ //This is the config used for Aws\DynamoDb\DynamoDbClient::factory() //See http://docs.aws.amazon.com/aws-sdk-php/v2/guide/service-dynamodb.html#factory-method 'credentials' => [ 'key' => 'YOUR_AWS_ACCESS_KEY_ID', 'secret' => 'YOUR_AWS_SECRET_ACCESS_KEY', ], 'region' => 'ap-southeast-1', ] ] ], ];
Limitation
Because DynamoDB have different behavior from MySQL, there are several limitations or behavior change applied. There are several method to get data from DynamoDB: GetItem, BatchGetItem, Scan, and Query.
- We have tried to implement automatic method to acquire model from Query. You should assign method explicitly if you want to force the method to use.
- Not yet support attribute name aliasing (In MySQL known as field aliasing).
- When using Query method, where condition just support filter by key attributes. In next roll out we will add filtering with non key attributes.
- To make pagination, we forcedly using Query method when WHERE condition is set. Because if you use filtering with non key attribute, it is possible the model result(s) will less than desired limit value.
indexBy
andorderBy
cannot use with attribute string value or callable parameter. This will use as string value and assign toIndexName
parameter in DynamoDB. To use sorting, this will forcedly use QUERY method andorderBy
parameter should be either['myIndex' => 'ASC']
or['myIndex', 'DESC']
and key condition expression should be defined.- Not support NULL and any kind of set attribute type.
- Not support attribute aliasing belong to Reserve Keywords, which means all attributes do not using any Reserve Keywords.
- When use LinkPager, do not forget use ActiveDataProvider from this package. When the pagination pass into any kind of Widget View, several components maybe unsupported like SerialColumn, unnecessary total items in summary, and sorting.