Laminas Stratigility v2.2.0 Release Notes

Release Date: 2018-03-12 // over 4 years ago
  • โž• Added

    • zendframework/zend-stratigility#140 adds the class Laminas\Stratigility\Middleware\CallableMiddlewareDecorator for the purpose of decorating callable, standards-signature middleware for use with a MiddlewarePipe instance. Instantiate it directly, passing the callable middleware as the sole argument, or use the Laminas\Stratigility\middleware() utility function to generate the instance: middleware($callable).

    • zendframework/zend-stratigility#140 adds the class Laminas\Stratigility\Middleware\DoublePassMiddlewareDecorator for the purpose of decorating callable, double-pass middleware for use with a MiddlewarePipe instance. Instantiate it directly, passing the callable middleware and a response instance as arguments, or use the Laminas\Stratigility\doublePassMiddleware() utility function to generate the instance: doublePassMiddleware($callable, $response).

    • zendframework/zend-stratigility#140 adds the class Laminas\Stratigility\Middleware\PathMiddlewareDecorator for the purposes of creating path-segregated middleware. The constructor expects a string path literal as the first argument, and an Interop\Http\Server\MiddlewareInterface instance for the second argument. Alternately, use the Laminas\Stratigility\path() utility function to generate the instance: path('/foo', $middleware).

    This decorator class replaces usage of the $path argument to MiddlewarePipe::pipe(), and should be used to ensure your application is forwards-compatible with the upcoming version 3 release.

    ๐Ÿ”„ Changed

    • Nothing.

    ๐Ÿ—„ Deprecated

    • ๐Ÿ—„ zendframework/zend-stratigility#140 deprecates the class Laminas\Stratigility\Route. This class is an internal detail, and will be removed in version 3.0.0.

    • ๐Ÿ—„ zendframework/zend-stratigility#140 deprecates the class Laminas\Stratigility\Exception\InvalidMiddlewareException. This class will be removed in version 3.0.0 as it will no longer be necessary due to typehint usage.

    • ๐Ÿ—„ zendframework/zend-stratigility#140 deprecates the class Laminas\Stratigility\Exception\InvalidRequestTypeException as it is no longer used by the package. It will be removed in version 3.0.0.

    • ๐Ÿ—„ zendframework/zend-stratigility#140 deprecates the class Laminas\Stratigility\Middleware\CallableInteropMiddlewareWrapper as it is based on interfaces that will no longer be used starting in version 3.0.0. It will be removed in version 3.0.0. Please use the new class Laminas\Stratigility\Middleware\CallableMiddlewareDecorator, or the utility function middleware(), to decorate callable standards-signature middleware.

    • ๐Ÿ—„ zendframework/zend-stratigility#140 deprecates the class Laminas\Stratigility\Middleware\CallableMiddlewareWrapper as it is based on interfaces that will no longer be used starting in version 3.0.0. It will be removed in version 3.0.0. Please use the new class Laminas\Stratigility\Middleware\DoublePassMiddlewareDecorator, or the utility function doublePassMiddleware(), to decorate callable double pass middleware.

    • ๐Ÿ—„ zendframework/zend-stratigility#140 deprecates the class Laminas\Stratigility\Middleware\CallableMiddlewareWrapperFactory as the class it is associated will be removed starting in version 3.0.0. The class will be removed in version 3.0.0.

    • ๐Ÿ—„ zendframework/zend-stratigility#140 deprecates the class Laminas\Stratigility\NoopFinalHandler as the class will be removed starting in version 3.0.0.

    • ๐Ÿ—„ zendframework/zend-stratigility#140 deprecates the two-argument form of Laminas\Stratigility\MiddlewarePipe::pipe(). If you need to perform path segregation, use the Laminas\Stratigility\Middleware\PathMiddlewareDecorator class and/or the Laminas\Stratigility\path() function to decorate your middleware in order to provide path segregation.

    • ๐Ÿ—„ zendframework/zend-stratigility#140 deprecates the piping of double pass middleware directly to pipe(); decorate your double-pass middleware using Laminas\Stratigility\Middleware\DoublePassMiddleware or Laminas\Stratigility\doublePassMiddleware() prior to piping.

    • ๐Ÿ—„ zendframework/zend-stratigility#159 deprecates Laminas\Stratigility\MiddlewarePipe::setCallableMiddlewareDecorator(). Use Laminas\Stratigility\doublePassMiddleware() or Laminas\Stratigility\Middleware\DoublePassMiddleware prior to passing your double-pass middleware to MiddlewarePipe::pipe().

    • ๐Ÿ—„ zendframework/zend-stratigility#159 deprecates Laminas\Stratigility\MiddlewarePipe::setResponsePrototype(). This was used only to seed an instance of Laminas\Stratigility\Middleware\CallableMiddlewareWrapperFactory previously; pass your response prototype directly to a new instance of Laminas\Stratigility\Middleware\DoublePassMiddleware or the `Laminas\Stratigility\doublePassMiddleware() function instead.

    • ๐Ÿ—„ zendframework/zend-stratigility#159 deprecates Laminas\Stratigility\MiddlewarePipe::hasResponsePrototype().

    โœ‚ Removed

    • Nothing.

    ๐Ÿ›  Fixed

    • Nothing.