69 lines
1.7 KiB
ReStructuredText
69 lines
1.7 KiB
ReStructuredText
Introduction
|
||
============
|
||
|
||
This library provides a way of avoiding usage of constructors when instantiating PHP classes.
|
||
|
||
Installation
|
||
============
|
||
|
||
The suggested installation method is via `composer`_:
|
||
|
||
.. code-block:: console
|
||
|
||
$ composer require doctrine/instantiator
|
||
|
||
Usage
|
||
=====
|
||
|
||
The instantiator is able to create new instances of any class without
|
||
using the constructor or any API of the class itself:
|
||
|
||
.. code-block:: php
|
||
|
||
<?php
|
||
|
||
use Doctrine\Instantiator\Instantiator;
|
||
use App\Entities\User;
|
||
|
||
$instantiator = new Instantiator();
|
||
|
||
$user = $instantiator->instantiate(User::class);
|
||
|
||
Contributing
|
||
============
|
||
|
||
- Follow the `Doctrine Coding Standard`_
|
||
- The project will follow strict `object calisthenics`_
|
||
- Any contribution must provide tests for additional introduced
|
||
conditions
|
||
- Any un-confirmed issue needs a failing test case before being
|
||
accepted
|
||
- Pull requests must be sent from a new hotfix/feature branch, not from
|
||
``master``.
|
||
|
||
Testing
|
||
=======
|
||
|
||
The PHPUnit version to be used is the one installed as a dev- dependency
|
||
via composer:
|
||
|
||
.. code-block:: console
|
||
|
||
$ ./vendor/bin/phpunit
|
||
|
||
Accepted coverage for new contributions is 80%. Any contribution not
|
||
satisfying this requirement won’t be merged.
|
||
|
||
Credits
|
||
=======
|
||
|
||
This library was migrated from `ocramius/instantiator`_, which has been
|
||
donated to the doctrine organization, and which is now deprecated in
|
||
favour of this package.
|
||
|
||
.. _composer: https://getcomposer.org/
|
||
.. _CONTRIBUTING.md: CONTRIBUTING.md
|
||
.. _ocramius/instantiator: https://github.com/Ocramius/Instantiator
|
||
.. _Doctrine Coding Standard: https://github.com/doctrine/coding-standard
|
||
.. _object calisthenics: http://www.slideshare.net/guilhermeblanco/object-calisthenics-applied-to-php
|