Hoa is a modular, extensible and
structured set of PHP libraries.
Moreover, Hoa aims at being a bridge between industrial and research worlds.
This library provides the hoa:// protocol, which is a way to abstract resource
accesses.
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 installThen, to run all the test suites:
$ vendor/bin/hoa test:runFor more information, please read the contributor guide.
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.
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”:
Application, representing resources of the application, like public files (in thePublicnode), models, resources… everything related to the application,Data, representing data required by the application, like configuration files, locales, databases, tests etc.Library, representing all Hoa's libraries.
Thus, hoa://Library/Protocol/README.md 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.
We can either resolve a path by using the global resolve function or the
Hoa\Protocol\Protocol::resolve method:
var_dump(
resolve('hoa://Library/Protocol/README.md')
);
/**
* Might output:
* string(37) "/usr/local/lib/Hoa/Protocol/README.md"
*/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):
var_dump(
resolve('hoa://Usb/StickA')
);
/**
* 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 --openMore documentation can be found on the project's website: hoa-project.net.
There are mainly two ways to get help:
- On the
#hoaprojectIRC channel, - On the forum at users.hoa-project.net.
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.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent