sanmai/hoa-protocol

The Hoa\Protocol library.

1.25.1 2025-07-26 04:04 UTC

Requires

• php: ^8.2
• hoa/consistency: *
• hoa/exception: *

Requires (Dev)

• bamarni/composer-bin-plugin: ^1.8
• friendsofphp/php-cs-fixer: ^3.84
• hoa/consistency: ^2.17
• hoa/exception: ^2.17
• infection/infection: ^0.30.3
• phpunit/phpunit: ^11

Replaces

• hoa/protocol: *

BSD-3-Clause

• Ivan Enderlin
• Hoa community

• stream
• library
• wrapper
• protocol
• resource

README

Hoa\Protocol

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

This particular fork aims to solve some deficiencies of the original library, while otherwise being a feature match to the original package. Specifically, this fork comes without the global resolve() function, which is known to cause a conflict with some versions of Laravel.

This library requires PHP 8.2+ and is routinely tested. Please report any issues.

Installation

With Composer, to include this library into your dependencies, you need to...

composer require sanmai/hoa-protocol

Testing

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

composer install

Then, to run all the test suites:

vendor/bin/phpunit

Or use the composer script:

composer test

Code Style

This project uses PHP CS Fixer to maintain consistent code style:

# Check code style
composer cs:check

# Fix code style automatically
composer cs:fix

Static Analysis

This project uses PHPStan with custom rules for static analysis, running in an isolated environment to avoid Hoa dependency conflicts:

composer phpstan

Note: PHPStan runs in an isolated environment using bamarni/composer-bin-plugin to avoid conflicts between the project's required Hoa v2.x libraries and PHPStan's bundled Hoa v1.x dependencies.

License

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