linkorb/etcd-php

Etcd client library for PHP

, _(*1)

Etcd client library for PHP

etcd is a distributed configuration system, part of the coreos project., _(*2)

This repository provides a client library for etcd for PHP applications., _(*3)

Installing and running etcd

git clone https://github.com/coreos/etcd.git
cd etcd
./build
./bin/etcd
````

## Brought to you by the LinkORB Engineering team

Check out our other projects at [linkorb.com/engineering](http://www.linkorb.com/engineering).

Btw, we're hiring!

## Installation
```shell
composer require linkorb/etcd-php

Usage

The client

Instantiate the client

$client = new Client($server);

Instantiate the client with custom Guzzle Client

$client = Client::constructWithGuzzleClient($guzzleClient, $server);

Use the client instance

$client->set('/foo', 'fooValue');
// Set the ttl
$client->set('/foo', 'fooValue', 10);
// get key value
echo $client->get('/foo');

// Update value with key
$client->update('/foo', 'newFooValue');

// Delete key
$client->rm('/foo');

// Create a directory
$client->mkdir('/fooDir');
// Remove dir
$client->rmdir('/fooDir');    

The command line tool

Setting Key Values

Set a value on the /foo/bar key:, _(*4)

$ bin/etcd-php etcd:set /foo/bar "Hello world"

Set a value on the /foo/bar key with a value that expires in 60 seconds:, _(*5)

$ bin/etcd-php etcd:set /foo/bar "Hello world" --ttl=60

Create a new key /foo/bar, only if the key did not previously exist:, _(*6)

$ bin/etcd-php etcd:mk /foo/new_bar "Hello world"

Create a new dir /fooDir, only if the key did not previously exist:, _(*7)

$ bin/etcd-php etcd:mkdir /fooDir

Update an existing key /foo/bar, only if the key already existed:, _(*8)

$ bin/etcd-php etcd:update /foo/bar "Hola mundo"

Create or update a directory called /mydir:, _(*9)

$ bin/etcd-php etcd:setDir /mydir

Retrieving a key value

Get the current value for a single key in the local etcd node:, _(*10)

$ bin/etcd-php etcd:get /foo/bar

Listing a directory

Explore the keyspace using the ls command, _(*11)

$ bin/etcd-php etcd:ls
/akey
/adir
$ bin/etcd-php etcd:ls /adir
/adir/key1
/adir/key2

Add -recursive to recursively list subdirectories encountered., _(*12)

$ bin/etcd-php etcd:ls --recursive
/foo
/foo/bar
/foo/new_bar
/fooDir

Deleting a key

Delete a key:, _(*13)

$ bin/etcd-php etcd:rm /foo/bar

Delete an empty directory or a key-value pair, _(*14)

$ bin/etcd-php etcd:rmdir /path/to/dir 

Recursively delete a key and all child keys:, _(*15)

$ bin/etcd-php etcd:rmdir /path/to/dir --recursive

Export node

$ bin/etcd-php etcd:export --server=http://127.0.0.1:2379 --format=json --output=config.json /path/to/dir

Watching for changes

Watch for only the next change on a key:, _(*16)

$ bin/etcd-php etcd:watch /foo/bar