Download the PHP package goaop/goaop-zend-expressive-middleware without Composer

GoAop Expressive Middleware

The GoAop middleware adds support for Aspect-Oriented Programming via Go! AOP Framework for Zend Expressive applications.

Overview

Aspect-Oriented Paradigm allows to extend the standard Object-Oriented Paradigm with special instruments for effective solving of cross-cutting concerns in your application. This code is typically present everywhere in your application (for example, logging, caching, monitoring, etc) and there is no easy way to fix this without AOP.

AOP defines new instruments for developers, they are:

• Joinpoint - place in your code that can be used for interception, for example, execution of single public method or accessing of single object property.
• Pointcut is a list of joinpoints defined with a special regexp-like expression for your source code, for example, all public and protected methods in the concrete class or namespace.
• Advice is an additional callback that will be called before, after or around concrete joinpoint. For PHP each advice is represented as a \Closure instance, wrapped into the interceptor object.

• Aspect is a special class that combines pointcuts and advices together, each pointcut is defined as an annotation and each advice is a method inside this aspect.

  You can read more about AOP in different sources, there are good articles for Java language and they can be applied for PHP too, because it's general paradigm.

Installation

GoAopModule can be easily installed with composer. Just ask a composer to download the bundle with dependencies by running the command:

Add the \Go\Zend\Expressive\Middleware\AspectMiddleware to your list of middleswares in the config/pipeline.php:

It is the best to add the middleware as early as possible, so that the AOP engine can take actions before any other middleware is applied.

Configuration

The default configuration in the config/module.config.php file. Copy this file to your own config directory to modify the values.

Configuration can be used for additional tuning of AOP kernel and source code whitelistsing/blacklisting.

Defining new aspects

Aspects are services in the ZF2 application and loaded into the AOP container by the integration module after putting them into the goaop_aspect section in the application.config.php file. Here is an example how to implement a logging aspect that will log information about public method invocations in the module/ directory.

Definition of aspect class with pointcut and logging advice

To register this application aspect in the container, create an appropriate definition for this service in the module.config.php file:

If you need to inject several dependencies into your aspect, then you can define your own factories, initializers, etc

To automatically register the aspect in the AOP kernel, add it's service name into the goaop_aspect config section of your Application module module.config.php or application.config.php:

License

This module is under the MIT license. See the complete LICENSE in the root directory