Skip to content
An interface to report arbitrary messages to registered handlers
PHP Makefile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src
tests
.gitattributes
.gitignore
.scrutinizer.yml
.travis.yml
LICENSE
Makefile
README.md
composer.json
phpcs.xml
phpunit.xml.dist

README.md

Message Reporter

Build Status Code Coverage Scrutinizer Code Quality Latest Stable Version Packagist download count

An interface to report and relay arbitrary messages to registered handlers. This was part of the Semantic MediaWiki code base and is now being deployed as independent library.

Requirements

PHP 5.6.99 or later

Installation

The recommended installation method for this library is to add it as dependency to your composer.json.

{
	"require": {
		"onoi/message-reporter": "~1.3"
	}
}

Usage

The message reporter specifies MessageReporter and MessageReporterAware as an interface for all interactions with a set of supporting classes:

  • MessageReporterFactory
  • ObservableMessageReporter
  • NullMessageReporter
  • SpyMessageReporter
  • CallbackMessageReporter
use Onoi\MessageReporter\MessageReporterFactory;
use Onoi\MessageReporter\MessageReporterAware;
use Onoi\MessageReporter\MessageReporterAwareTrait;
use Onoi\MessageReporter\MessageReporter;

class Bar implements MessageReporterAware {

	use MessageReporterAwareTrait;

	public function __construct() {
		$this->messageReporter = MessageReporterFactory::getInstance()->newNullMessageReporter();
	}

	public function doSomething() {
		$this->messageReporter->reportMessage( 'Doing ...' );
	}
}
use Onoi\MessageReporter\MessageReporterFactory;
use Onoi\MessageReporter\MessageReporter;

class Foo implements MessageReporter {

	public function reportMessage( $message ) {
		// output
	}
}

$foo = new Foo();

$messageReporterFactory = new MessageReporterFactory();

$observableMessageReporter = $messageReporterFactory->newObservableMessageReporter();
$observableMessageReporter->registerReporterCallback( array( $foo, 'reportMessage' ) );

or

// If the class implements the MessageReporter
$observableMessageReporter->registerMessageReporter( $foo );

$bar = new Bar();
$bar->setMessageReporter( $observableMessageReporter );

Contribution and support

If you want to contribute work to the project please subscribe to the developers mailing list and have a look at the contribution guidelinee. A list of people who have made contributions in the past can be found here.

Development

Start by installing the project dependencies by executing

composer update

You can run the tests by executing

make test

You can run the style checks by executing

make cs

To run all CI checks, execute

make ci

You can also invoke PHPUnit directly to pass it arguments, as follows

vendor/bin/phpunit --filter SomeClassNameOrFilter

Release notes

  • 1.4.1 (2019-04-10)

    • Added .gitattributes
  • 1.4.0 (2019-04-08)

    • Added CallbackMessageReporter
    • Changed minimum PHP version to 5.6.99
  • 1.3.0 (2017-11-05)

    • Added MessageReporterAwareTrait
  • 1.2.0 (2016-08-02)

    • Added MessageReporterAware and SpyMessageReporter
  • 1.1.0 (2016-04-13)

    • ObservableMessageReporter::registerReporterCallback to register only callable handlers
  • 1.0.0 (2015-01-24)

    • Initial release
    • MessageReporterFactory
    • ObservableMessageReporter
    • NullMessageReporter
    • MessageReporter

License

GNU General Public License 2.0 or later.

You can’t perform that action at this time.