Page MenuHomeWickedGov Phorge
Files F5975317

README.md
No OneTemporary
Actions

Size
2 KB
Referenced Files
None
Subscribers
None

README.md
View Options

[![Latest Stable Version]](https://packagist.org/packages/wikimedia/services) [![License]](https://packagist.org/packages/wikimedia/services)
Services
=====================
A [PSR-11][]-compliant services framework.
Services are created by instantiators (callables),
which are usually defined in separate wiring files.
Usage
-----
```php
$services = new ServiceContainer();
$services->defineService(
'MyService',
static function ( ServiceContainer $services ): MyService {
return new MyService();
}
);
$services->loadWiringFiles( [
'path/to/ServiceWiring.php',
] );
```
Where `ServiceWiring.php` looks like this:
```php
return [
'MyOtherService' => static function ( ServiceContainer $services ): MyOtherService {
return new MyOtherService( $services->get( 'MyService' ) );
},
// ...
];
```
Each instantiator receives the service container as the first argument,
from which it may retrieve further services as needed.
Additional arguments for each instantiator may be specified
when constructing the `ServiceContainer`.
Custom subclasses of `ServiceContainer`
may offer easier access to certain services:
```php
class MyServiceContainer extends ServiceContainer {
public function getMyService(): MyService {
return $this->get( 'MyService' );
}
public function getMyOtherService(): MyOtherService {
return $this->get( 'MyOtherService' );
}
}
// ServiceWiring.php
return [
'MyOtherService' => static function ( MyServiceContainer $services ): MyOtherService {
return new MyOtherService( $services->getMyService() );
},
];
```
Running tests
-------------
composer install --prefer-dist
composer test
History
-------
This library was first introduced in [MediaWiki 1.27][] ([I3c25c0ac17][]). It
was split out of the MediaWiki codebase and published as an independent library
during the [MediaWiki 1.33][] and [MediaWiki 1.34][] development cycles.
---
[PSR-11]: https://www.php-fig.org/psr/psr-11/
[MediaWiki 1.27]: https://www.mediawiki.org/wiki/MediaWiki_1.27
[I3c25c0ac17]: https://gerrit.wikimedia.org/r/264403
[MediaWiki 1.33]: https://www.mediawiki.org/wiki/MediaWiki_1.33
[MediaWiki 1.34]: https://www.mediawiki.org/wiki/MediaWiki_1.34
[Latest Stable Version]: https://poser.pugx.org/wikimedia/services/v/stable.svg
[License]: https://poser.pugx.org/wikimedia/services/license.svg

File Metadata

Mime Type
text/plain
Expires
Sat, Oct 3, 18:08 (17 h, 26 m)
Storage Engine
local-disk
Storage Format
Raw Data
Storage Handle
5e/39/9aa74cad8771cfbdc16610f940b1
Default Alt Text
README.md (2 KB)

Event Timeline