Skip to content
The Hoa\Protocol library.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.State Quality: Drop PHP5.4. Jan 11, 2016
.travis.yml chore(ci) Drop PHP 5 and PHP 7.0. Aug 30, 2017 chore(composer) Update documentation. Aug 30, 2017
composer.json chore(composer) Use `dev-master` dependencies. Jan 23, 2018


Build status Code coverage Packagist License

Hoa is a modular, extensible and structured set of PHP libraries.
Moreover, Hoa aims at being a bridge between industrial and research worlds.


Help on IRC Help on Gitter Documentation Board

This library provides the hoa:// protocol, which is a way to abstract resource accesses.

Learn more.


With Composer, to include this library into your dependencies, you need to require hoa/protocol:

$ composer require hoa/protocol '~2.0'

For more installation procedures, please read the Source page.


Before running the test suites, the development dependencies must be installed:

$ composer install

Then, to run all the test suites:

$ vendor/bin/hoa test:run

For more information, please read the contributor guide.

Quick usage

We propose a quick overview of how to list the current tree of the protocol, how to resolve a hoa:// path and finally how to add a new node in this tree.

Explore resources

First of all, to get the instance of the hoa:// protocol, you should use the static getInstance method on the Hoa\Protocol\Protocol class which represents the root of the protocol tree:

echo Hoa\Protocol\Protocol::getInstance();

 * Might output:
 *   Application
 *     Public
 *   Data
 *     Etc
 *       Configuration
 *       Locale
 *     Lost+found
 *     Temporary
 *     Variable
 *       Cache
 *       Database
 *       Log
 *       Private
 *       Run
 *       Test
 *   Library

We see that there is 3 “sub-roots”:

  1. Application, representing resources of the application, like public files (in the Public node), models, resources… everything related to the application,
  2. Data, representing data required by the application, like configuration files, locales, databases, tests etc.
  3. Library, representing all Hoa's libraries.

Thus, hoa://Library/Protocol/ represents the abstract path to this real file. No matter where you are on the disk, this path will always be valid and pointing to this file. This becomes useful in an application where you would like to access to a configuration file like this hoa://Data/Etc/Configuration/Foo.php: Maybe the Data directory does not exist, maybe the Etc or Configuration directories do not exist neither, but each node of the hoa:// tree resolves to a valid directory which contains your Foo.php configuration file. This is an abstract path for a resource.

Resolving a path

We can either resolve a path by using the global resolve function or the Hoa\Protocol\Protocol::resolve method:


 * Might output:
 *     string(37) "/usr/local/lib/Hoa/Protocol/"

Register new nodes in the tree

The hoa:// protocol is a tree. Thus, to add a new “component”/“directory” in this tree, we must create a node and register it as a child of an existing node. Thus, in the following example we will create a Usb node, pointing to the /Volumes directory, and we will add it as a new sub-root, so an immediate child of the root:

$protocol   = Hoa\Protocol\Protocol::getInstance();
$protocol[] = new Hoa\Protocol\Node('Usb', '/Volumes/');

Here we are. Now, resolving hoa://Usb/StickA might point to /Volumes/StickA (if exists):


 * Might output:
 *     string(15) "/Volumes/StickA"


The hack book of Hoa\Protocol contains detailed information about how to use this library and how it works.

To generate the documentation locally, execute the following commands:

$ composer require --dev hoa/devtools
$ vendor/bin/hoa devtools:documentation --open

More documentation can be found on the project's website:

Getting help

There are mainly two ways to get help:


Do you want to contribute? Thanks! A detailed contributor guide explains everything you need to know.


Hoa is under the New BSD License (BSD-3-Clause). Please, see LICENSE for details.

You can’t perform that action at this time.