Skip to main content

AnyDataset-NoSql

Build Status Opensource ByJG GitHub source GitHub license GitHub release

Anydataset NoSQL standardize the access to non-relational databases/repositories and treat them as Key/Value. The implementation can work with:

  • MongoDB
  • Cloudflare KV
  • S3
  • DynamoDB

Anydataset is an agnostic data source abstraction layer in PHP. See more about Anydataset here.

Features

  • Access as Key/Value repositories different datasource
  • Allow put and get data
  • Simplified way to connect to the datasources

Connection Based on URI

The connection string for databases is based on URL.

See below the current implemented drivers:

DatasourceConnection String
MongoDBmongodb://username:password@hostname:port/database
Cloudflare KVkv://username:password@accountid/namespaceid
S3s3://accesskey:secretkey@region/bucket?params
AWS DynamoDBdynamodb://accesskey:secretkey@hostname/tablename?params

Examples

Check implementation examples on https://opensource.byjg.com/php/anydataset-nosql

Install

Just type:

composer require "byjg/anydataset-nosql"

Running Unit tests

docker-compose up -d
export MONGODB_CONNECTION="mongodb://127.0.0.1/test"
export S3_CONNECTION="s3://aaa:12345678@us-east-1/mybucket?create=true&endpoint=http://127.0.0.1:4566"
export DYNAMODB_CONNECTION="dynamodb://accesskey:secretkey@us-east-1/tablename?endpoint=http://127.0.0.1:8000"
vendor/bin/phpunit

Setup MongoDB for the unit test

Set the environment variable:

  • MONGODB_CONNECTION = "mongodb://127.0.0.1/test"

Setup AWS DynamoDb for the unit test

Set the environment variable:

  • DYNAMODB_CONNECTION = "dynamodb://accesskey:secretkey@region/tablename"

Setup AWS S3 for the unit test

Set the environment variable:

  • S3_CONNECTION = "s3://accesskey:secretkey@region/bucketname"

Cloudflare KV

Set the environment variable:

  • CLOUDFLAREKV_CONNECTION = "kv://email:authkey@accountid/namespaceid"

Dependencies


Open source ByJG