astrXbian/www/multitube/vendor/ipfs/php-client/README.md

264 lines
10 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# PHP Adapter for IPFS
![ipfs](https://user-images.githubusercontent.com/1211152/29604883-ca3a4028-87e0-11e7-9f9a-75de49b06048.png)
Dont know what ipfs is? the future of filesystems :) read [here](https://ipfs.io) for more information!
[![Build Status](https://travis-ci.org/digitalkaoz/php-ipfs-api.svg?branch=master)](https://travis-ci.org/digitalkaoz/php-ipfs-api)
[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/digitalkaoz/php-ipfs-api/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/digitalkaoz/php-ipfs-api/?branch=master)
[![Code Coverage](https://scrutinizer-ci.com/g/digitalkaoz/php-ipfs-api/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/digitalkaoz/php-ipfs-api/?branch=master)
## Installation
as always, use composer!
```
$ composer require ipfs/php-client
```
### choosing the HTTP Adapter
If you plan to use the REST Interface of the ipfs-daemon you should choose a http-implementation. We use [php-http](http://docs.php-http.org/) for abstraction.
See [here](https://packagist.org/providers/php-http/async-client-implementation) for a list of available implementations!
if you only want to speak with a local ipfs-daemon you should use the `IPFS\\Drivers\\Cli` adapter.
### Annotations
as we use Annotations you should register the `AnnotationLoader`
```php
$loader = require __DIR__.'/../vendor/autoload.php';
use Doctrine\Common\Annotations\AnnotationRegistry;
AnnotationRegistry::registerLoader(array($loader, "loadClass"));
```
## Drivers
we ship with different adapters for communicating with the daemon.
### CLI
if you are using an `ipfs` binary that is not available in you `$PATH` variable, provide an `ENV` var for it:
```
$ export IPFS_BINARY=/my/location/to/ipfs
```
> make sure you set `IPFS_PATH` in you `ENV` if you are not using `~/.ipfs` as location.
to use this Driver from the commandline simply provide the option:
```
$ bin/php-ipfs version --driver=IPFS\\Driver\\Cli
```
### HTTP
if you are talking to a remote daemon provide an `ENV` var for it:
```
$ export IPFS_API=http://somehost:5001/api/v0
```
to use this Driver from the commandline simply provide the option (or leave it away since its the default):
```
$ bin/php-ipfs version --driver=IPFS\\Driver\\Http
$ bin/php-ipfs version
```
### Client
this Driver is intended for programmatically usage:
```php
$driver = $container[IPFS\Driver\Cli::class];
//$driver = $container[IPFS\Driver\Http::class];
$client = new IPFS\Client($driver);
$response = $client->execute((new \IPFS\Api\Basics())->version());
var_dump($response);
```
## Apis
All Api-Endpoints are autogenerated from the official [ipfs docs](https://ipfs.io/docs/api/) and are regulary checked for changes.
> To rebuild the Apis yourself, simply run `composer rebuild-api`
The following endpoints exists:
```
Available commands:
add Add a file or directory to ipfs.
cat Show IPFS object data.
commands List all available commands.
dns Resolve DNS links.
get Download IPFS objects.
help Displays help for a command
id Show ipfs node id info.
list Lists commands
ls List directory contents for Unix filesystem objects.
mount Mounts IPFS to the filesystem (read-only).
ping Send echo request packets to IPFS hosts.
rebuild rebuild api classes by parsing the official api doc
resolve Resolve the value of names to IPFS.
shutdown Shut down the ipfs daemon.
update
version Show ipfs version information.
bitswap
bitswap:ledger Show the current ledger for a peer.
bitswap:reprovide Trigger reprovider.
bitswap:stat Show some diagnostic information on the bitswap agent.
bitswap:unwant Remove a given block from your wantlist.
bitswap:wantlist Show blocks currently on the wantlist.
block
block:get Get a raw IPFS block.
block:put Store input as an IPFS block.
block:rm Remove IPFS block(s).
block:stat Print information of a raw IPFS block.
bootstrap
bootstrap:add:default Add default peers to the bootstrap list.
bootstrap:list Show peers in the bootstrap list.
bootstrap:rm:all Remove all peers from the bootstrap list.
config
config:edit Open the config file for editing in $EDITOR.
config:profile:apply Apply profile to config.
config:replace Replace the config with .
config:show Output config file contents.
dag
dag:get Get a dag node from ipfs.
dag:put Add a dag node to ipfs.
dag:resolve Resolve ipld block.
dht
dht:findpeer Query the DHT for all of the multiaddresses associated with a Peer ID.
dht:findprovs Find peers in the DHT that can provide a specific value, given a key.
dht:get Given a key, query the DHT for its best value.
dht:provide Announce to the network that you are providing given values.
dht:put Write a key/value pair to the DHT.
dht:query Find the closest Peer IDs to a given Peer ID by querying the DHT.
diag
diag:cmds:clear Clear inactive requests from the log.
diag:cmds:set-time Set how long to keep inactive requests in the log.
diag:sys Print system diagnostic information.
file
file:ls List directory contents for Unix filesystem objects.
files
files:chcid Change the cid version or hash function of the root node of a given path.
files:cp Copy files into mfs.
files:flush Flush a given paths data to disk.
files:ls List directories in the local mutable namespace.
files:mkdir Make directories.
files:mv Move files.
files:read Read a file in a given mfs.
files:rm Remove a file.
files:stat Display file status.
files:write Write to a mutable file in a given filesystem.
filestore
filestore:dups List blocks that are both in the filestore and standard block storage.
filestore:ls List objects in filestore.
filestore:verify Verify objects in filestore.
key
key:gen Create a new keypair.
key:list List all local keypairs.
key:rename Rename a keypair.
key:rm Remove a keypair.
log
log:level Change the logging level.
log:ls List the logging subsystems.
log:tail Read the event log.
name
name:publish Publish IPNS names.
name:pubsub:cancel Cancel a name subscription.
name:pubsub:state Query the state of IPNS pubsub.
name:pubsub:subs Show current name subscriptions.
name:resolve Resolve IPNS names.
object
object:data Output the raw bytes of an IPFS object.
object:diff Display the diff between two ipfs objects.
object:get Get and serialize the DAG node named by .
object:links Output the links pointed to by the specified object.
object:new Create a new object from an ipfs template.
object:patch:add-link Add a link to a given object.
object:patch:append-data Append data to the data segment of a dag node.
object:patch:rm-link Remove a link from an object.
object:patch:set-data Set the data field of an IPFS object.
object:put Store input as a DAG object, print its key.
object:stat Get stats for the DAG node named by .
p2p
p2p:listener:close Close active p2p listener.
p2p:listener:ls List active p2p listeners.
p2p:listener:open Forward p2p connections to a network multiaddr.
p2p:stream:close Close active p2p stream.
p2p:stream:dial Dial to a p2p listener.
p2p:stream:ls List active p2p streams.
pin
pin:add Pin objects to local storage.
pin:ls List objects pinned to local storage.
pin:rm Remove pinned objects from local storage.
pin:update Update a recursive pin.
pin:verify Verify that recursive pins are complete.
pubsub
pubsub:ls List subscribed topics by name.
pubsub:peers List peers we are currently pubsubbing with.
pubsub:pub Publish a message to a given pubsub topic.
pubsub:sub Subscribe to messages on a given topic.
refs
refs:local List all local references.
repo
repo:fsck Remove repo lockfiles.
repo:gc Perform a garbage collection sweep on the repo.
repo:stat Get stats for the currently used repo.
repo:verify Verify all blocks in repo are not corrupted.
repo:version Show the repo version.
stats
stats:bitswap Show some diagnostic information on the bitswap agent.
stats:bw Print ipfs bandwidth information.
stats:repo Get stats for the currently used repo.
swarm
swarm:addrs:listen List interface listening addresses.
swarm:addrs:local List local addresses.
swarm:connect Open connection to a given address.
swarm:disconnect Close connection to a given address.
swarm:filters:add Add an address filter.
swarm:filters:rm Remove an address filter.
swarm:peers List peers with open connections.
tar
tar:add Import a tar file into ipfs.
tar:cat Export a tar file from IPFS.
```
## Usage
simply use the commandline interface
```
$ bin/php-ipfs
$ bin/php-ipfs add ./composer.lock --wrap-with-directory --driver=IPFS\\Driver\\Cli
$ bin/php-ipfs add ./composer.lock --wrap-with-directory
```
## PHAR
to build a `phar` file simply run
> we assume you have https://box-project.github.io/box2/ installed!
```
$ composer build
```
## Tests
this library is well covered with [phpspec](http://www.phpspec.net/)
```
$ composer test
```