Download the PHP package robvanaarle/php-object-seam without Composer
On this page you can find all versions of the php package robvanaarle/php-object-seam. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download robvanaarle/php-object-seam
More information about robvanaarle/php-object-seam
Files in robvanaarle/php-object-seam
Package php-object-seam
Short Description An easy way to create object seams to break dependencies with minimal code changes in order to test legacy PHP code
License BSD-3-Clause
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package php-object-seam
PHP Object Seam
PHP Object Seam provides an easy way to create object seams in PHP. These are used in legacy code for breaking dependencies to make code testable with minimal changes to the Class Under Test.
Legacy code is hard to extend and maintain because of dependencies. Ideally it needs to be refactored, however there isn't always time for that. To be confident about new features or bug fixes to legacy code, automated tests need to be in place. But legacy code tends not to have (enough) automated tests. These are also hard to add, because of the same dependencies. To put tests in place, the dependencies have to be broken first by changing the code. These changes need to be tested as well, but that is difficult because of the same reasons.
In his book Working Effectively with Legacy Code Michael Feathers defines a seam as "a place to alter program behavior, without changing the code". This enables breaking of dependencies and adding automated tests with no or minimal change to the code. This library offers a way to create one of the seam types: object seams. With object seams it's possible to change the Object Under Test in automated tests and leave the code of the Class Under Test as is.
Installation
composer require --dev robvanaarle/php-object-seam ^1
Requirements
PHP >= 7.0
As legacy code often runs on older PHP versions, this package aims to support as many PHP versions as possible.
Features
- Call protected and private methods
- Call protected static methods
- Override public and protected methods
- Override public and protected static methods
- Instantiate an object with a custom constructor
- Capture and retrieve public and protected method calls
- Capture and retrieve public and protected static method calls
- Autocomplete in PhpStorm when using the
CreatesObjectSeamstrait - Testing framework agnostic
This allows for the following dependency breaking techniques from the book Working Effectively with Legacy Code.
- Subclass and make public
- Subclass and override
- Expose static method
Advantages over manually creating object seam code
- Less code: much of the required code is generated
- Faster to write
- More explicit about the intent to break dependencies: manually created object seam code tends to become fuzzy
- An
ObjectSeamcan be partially constructed before tests and altered (and even constructed) for specific test
Basic Usage
Use the trait PHPObjectSeam\CreatedObjectSeams in your test class to create an ObjectSeams. An ObjectSeam is usually created for the Object Under Test. It can then be altered with no or minimal code changes to the Class Under Test, for example to call non-public methods or override method behaviour. A created ObjectSeam is unconstructed: the original constructor, __construct, has not been called. This allows for setting up an ObjectSeam that can be reused and customized by multiple tests.
Usage
Call non-public method
This can be used for 'Subclass and make public'.
Call protected static method
This can be used for 'Subclass and make public'.
Override public or protected method
Overridden methods are executed in the scope of the object seam class.
Override with a Closure:
Override with a result value:
This can be used for 'Subclass and override' with the goal altering behaviour of a public or protected method.
Override public or protected static method
Overridden static methods are executed in the scope of the object seam class.
Override with a Closure:
Override with a result value:
This can be used for 'Subclass and override' with the goal altering behaviour of a public or protected static method.
Instantiate an object with a custom constructor
or set a custom constructor and call it later:
'Expose static method' can be achieved by not using a constructor and by calling the desired method. There is then no need to make that method static.
Call original constructor
Often there is no need for a custom constructor, the original constructor has to be called then.
or use the helper method callConstruct() for this
Capture and retrieve public and protected method calls
Capturing and retrieving calls allows for asserting that a method has been called and with which arguments.
Capture and retrieve public and protected static method calls
Capturing and retrieving static calls allows for asserting that a method has been called and with which arguments.
