2017 © Pedro Peláez
 

library go-aop-php

Library for aspect-oriented programming in PHP.

image

quickmobile/go-aop-php

Library for aspect-oriented programming in PHP.

  • Tuesday, December 16, 2014
  • by xavier-cousin
  • Repository
  • 3 Watchers
  • 0 Stars
  • 21,603 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 117 Forks
  • 0 Open issues
  • 14 Versions
  • 5 % Grown

The README.md

Go! Aspect-Oriented Framework for PHP

Go! AOP is a modern aspect-oriented framework in plain PHP with rich features for the new level of software development. Framework allows to solve a cross-cutting issues in the traditional object-oriented PHP code by providing a highly efficient and transparent hook system for your exisiting code., (*1)

Build Status Latest Stable Version Total Downloads Daily Downloads Latest Unstable Version Minimum PHP Version License, (*2)

Features

  • Provides dynamic hook system for PHP without changes in the original source code.
  • Doesn't require any PECL-extentions (php-aop, runkit, uopz) and DI-containers to work.
  • Object-oriented design of aspects, joinpoints and pointcuts.
  • Intercepting an execution of any public or protected method in a classes.
  • Intercepting an execution of static methods and methods in final classes.
  • Intercepting an execution of methods in the traits.
  • Intercepting an access to the public/protected properties for objects.
  • Hooks for static class initialization (after class is loaded into PHP memory).
  • Hooks for object initialization (intercepting new keywords).
  • Intercepting an invocation of system PHP functions.
  • Ability to change the return value of any methods/functions via Around type of advice.
  • Rich pointcut grammar syntax for defining pointcuts in the source code.
  • Native debugging for AOP with XDebug. The code with weaved aspects is fully readable and native. You can put a breakpoint in the original class or in the aspect and it will work (for debug mode)!
  • Can be integrated with any existing PHP frameworks and libraries.
  • Highly optimized for production use: support of opcode cachers, lazy loading of advices and aspects, joinpoints caching, no runtime checks of pointcuts, no runtime annotations parsing, no evals and __call methods, no slow proxies and call_user_func_array(). Fast bootstraping process (2-20ms) and advice invocation.

What is AOP?

AOP (Aspect-Oriented Programming) is an approach to cross-cutting concerns, where the concerns are designed and implemented in a "modular" way (that is, with appropriate encapsulation, lack of duplication, etc.), then integrated into all the relevant execution points in a succinct and robust way, e.g. through declarative or programmatic means., (*3)

In AOP terms, the execution points are called join points, a particular set of them is called a pointcut and the new behavior that is executed before, after, or "around" a join point is called advice. You can read more about AOP in Introduction section., (*4)

Installation

Go! AOP framework can be installed with composer. Installation is quite easy:, (*5)

  1. Download the framework using composer
  2. Create an application aspect kernel
  3. Configure the aspect kernel in the front controller
  4. Create an aspect
  5. Register the aspect in the aspect kernel

Step 1: Download the library using composer

Ask composer to download the Go! AOP framework with its dependencies by running the command:, (*6)

``` bash $ composer require lisachenko/go-aop-php, (*7)


Composer will install the framework to your project's `vendor/lisachenko/go-aop-php` directory. ### Step 2: Create an application aspect kernel The aim of this framework is to provide easy AOP integration to your application. Your first step then is to create the `AspectKernel` class for your application. This class will manage all aspects of your application in one place. The framework provides base class to make it easier to create your own kernel. To create your application kernel extend the abstract class `Go\Core\AspectKernel` ``` php <?php // app/ApplicationAspectKernel.php use Go\Core\AspectKernel; use Go\Core\AspectContainer; /** * Application Aspect Kernel */ class ApplicationAspectKernel extends AspectKernel { /** * Configure an AspectContainer with advisors, aspects and pointcuts * * @param AspectContainer $container * * @return void */ protected function configureAop(AspectContainer $container) { } }

3. Configure the aspect kernel in the front controller

To configure the aspect kernel, call init() method of kernel instance., (*8)

``` php // front-controller, for Symfony2 application it's web/app_dev.php, (*9)

include DIR . '/vendor/autoload.php'; // use composer, (*10)

// Initialize an application aspect container $applicationAspectKernel = ApplicationAspectKernel::getInstance(); $applicationAspectKernel->init(array( 'debug' => true, // use 'false' for production mode // Cache directory 'cacheDir' => DIR . '/path/to/cache/for/aop', // Include paths restricts the directories where aspects should be applied, or empty for all source files 'includePaths' => array( DIR . '/../src/' ) ));, (*11)


### 4. Create an aspect Aspect is the key element of AOP philosophy. And Go! AOP framework just uses simple PHP classes for declaring aspects! Therefore it's possible to use all features of OOP for aspect classes. As an example let's intercept all the methods and display their names: ``` php // Aspect/MonitorAspect.php namespace Aspect; use Go\Aop\Aspect; use Go\Aop\Intercept\FieldAccess; use Go\Aop\Intercept\MethodInvocation; use Go\Lang\Annotation\After; use Go\Lang\Annotation\Before; use Go\Lang\Annotation\Around; use Go\Lang\Annotation\Pointcut; /** * Monitor aspect */ class MonitorAspect implements Aspect { /** * Method that will be called before real method * * @param MethodInvocation $invocation Invocation * @Before("execution(public Example->*(*))") */ public function beforeMethodExecution(MethodInvocation $invocation) { $obj = $invocation->getThis(); echo 'Calling Before Interceptor for method: ', is_object($obj) ? get_class($obj) : $obj, $invocation->getMethod()->isStatic() ? '::' : '->', $invocation->getMethod()->getName(), '()', ' with arguments: ', json_encode($invocation->getArguments()), "<br>\n"; } }

Easy, isn't it? We declared here that we want to install a hook before the execution of all dynamic public methods in the class Example. This is done with the help of annotation @Before("execution(public Example->*(*))") Hooks can be of any types, you will see them later. But we doesn't change any code in the class Example! I can feel you astonishment now ), (*12)

5. Register the aspect in the aspect kernel

To register the aspect just add an instance of it in the configureAop() method of the kernel:, (*13)

``` php // app/ApplicationAspectKernel.php, (*14)

use Aspect/MonitorAspect;, (*15)

//..., (*16)

protected function configureAop(AspectContainer $container)
{
    $container->registerAspect(new MonitorAspect());
}

//... ```, (*17)

Now you are ready to use the power of aspects! Feel free to change anything everywhere. If you like this project, you could support it Flattr this project!, (*18)

Documentation

Documentation about Go! library can be found at [official site][1]., (*19)

The Versions

16/12 2014

dev-master

9999999-dev

Library for aspect-oriented programming in PHP.

  Sources   Download

MIT

The Requires

 

The Development Requires

php library aop aspect

16/12 2014

1.0.0

1.0.0.0

Library for aspect-oriented programming in PHP.

  Sources   Download

MIT

The Requires

 

The Development Requires

php library aop aspect

21/11 2014

dev-feature/pointcut-dsl-builder

dev-feature/pointcut-dsl-builder http://go.aopphp.com/

Library for aspect-oriented programming in PHP.

  Sources   Download

MIT

The Requires

 

The Development Requires

php library aop aspect

14/11 2014

0.x-dev

0.9999999.9999999.9999999-dev http://go.aopphp.com/

Library for aspect-oriented programming in PHP.

  Sources   Download

MIT

The Requires

 

The Development Requires

php library aop aspect

08/07 2014

0.5.0

0.5.0.0 http://go.aopphp.com/

Library for aspect-oriented programming in PHP.

  Sources   Download

MIT

The Requires

 

The Development Requires

php library aop aspect

24/05 2014

0.5.0-RC1

0.5.0.0-RC1 http://go.aopphp.com/

Library for aspect-oriented programming in PHP.

  Sources   Download

MIT

The Requires

 

The Development Requires

php library aop aspect

03/11 2013

0.4.3

0.4.3.0 http://go.aopphp.com/

Library for aspect-oriented programming in PHP.

  Sources   Download

MIT

The Requires

 

php library aop aspect

19/09 2013

0.4.2

0.4.2.0 http://go.aopphp.com/

Library for aspect-oriented programming in PHP.

  Sources   Download

MIT

The Requires

 

php library aop aspect

27/08 2013

0.4.1

0.4.1.0 http://go.aopphp.com/

Library for aspect-oriented programming in PHP.

  Sources   Download

MIT

The Requires

 

php library aop aspect

04/08 2013

0.4.0

0.4.0.0 http://go.aopphp.com/

Library for aspect-oriented programming in PHP.

  Sources   Download

MIT

The Requires

 

php library aop aspect

27/05 2013

0.3.0

0.3.0.0 http://go.aopphp.com/

Library for aspect-oriented programming in PHP.

  Sources   Download

MIT

The Requires

 

php library aop aspect

15/03 2013

0.2.0

0.2.0.0 http://go.aopphp.com/

Library for aspect-oriented programming in PHP.

  Sources   Download

MIT

The Requires

 

php library aop aspect

20/01 2013

0.1.1

0.1.1.0 http://lisachenko.github.com/go-aop-php/

Library for aspect-oriented programming in PHP.

  Sources   Download

MIT

The Requires

 

php library aop aspect

08/01 2013

0.1.0

0.1.0.0 http://lisachenko.github.com/go-aop-php/

Library for aspect-oriented programming in PHP.

  Sources   Download

MIT

The Requires

 

php library aop aspect