chemem/fauxton-client

A simple CouchDB interaction library.

dev-master / 1.0.x-dev 2019-01-03 19:01 UTC

This package is auto-updated.

Last update: 2024-11-07 17:57:59 UTC


README

A simple CouchDB interaction library.

Requirements

  • PHP 7.0+

Installation

fauxton-client is available on Packagist. To install it, type the following on your preferred command-line interface:

composer require chemem/fauxton-client dev-master

Fauxton

Fauxton, formerly Futon, is the name of the Couch Database web client. Like its predecessor, Fauxton is a robust web interface designed to ease interactions with CouchDB.

The client

Fauxton-client is a PHP library written for the sole purpose of performing CouchDB operations such as creating databases, creating indexes and writing Mango queries.

NoSQL vs SQL

Structured Query Language (SQL) is a popular approach to handling back-end information and follows Atomicity Consistency Isolation and Durability (ACID) conventions. Simply put, SQL databases allow those who use them to store unique data in relational, table structures.

NoSQL, on the other hand, presents a different paradigm to handling data interactions: NoSQL standards are a manifestation of Basically Available Soft-state Eventually consistent (BASE) practices. Couch Database is a NoSQL database that follows a document-oriented, key-value pair format that is also convenient for manipulating data.

Documentation

I advise that you read the official CouchDB documentation so as to better understand the fauxton-client. Also, reading the fauxton-client wiki is recommended and therefore, prudent.

Running the unit tests

In order to run the unit tests, run the following command:

vendor/bin/phpunit -c phpunit.xml.dist

Dealing with problems

Endeavor to create an issue on GitHub when the need arises or send an email to lochbm@gmail.com

Note

In light of recent modification activity, the fauxton-client is temporarily unusable.