Anzeige
Anzeige
UX & Design

Ein Enterprise Feature übertragen in die PHP-Welt: Aspektorientierte Programmierung mit FLOW3

Aspektorientierte Programmierung (AOP) ist ein Programmierparadigma. Ziel von AOP ist es, Programmteile abzukapseln, die nicht direkt zur Domäne, also der Hauptaufgabe des Programms, gehören und dennoch häufig gebraucht werden. Diese Teile werden erst zur Laufzeit mit dem Code der Domäne zusammengefügt. Das Resultat verhält sich, als wäre es aus einem Guss. Anhand des Anwendungsbeispiels eines Profilers veranschaulicht dieser Artikel den Einsatz von AOP in FLOW3.

5 Min.
Artikel merken
Anzeige
Anzeige

Ein Profiler kann bei vielen komplexen Entwicklungen helfen, rechenintensive Schwachstellen aufzuspüren. Dazu protokolliert er die Zeit zwischen Ausführungsbeginn und Ausführungsende eines Funktionsaufrufs. Um nun eine spezifische Komponente einem solchen Profiling zu unterziehen, wäre es nötig an Ort und Stelle entsprechende Codezeilen zur Zeitberechnung zu hinterlegen, bestenfalls durch den Aufruf einer ausgelagerten Methode. Der Code der Komponente ist damit jedoch unweigerlich mit Programmzeilen verstrickt, die nicht zur Kernlogik der Komponente beitragen. Durch den Einsatz eines Programmierparadigmas, wie dem der Aspektorientierten Programmierung [1], ist es möglich, diesen Umstand zu umgehen und eine klare Aufteilung aller Komponenten in ihre jeweiligen Dömanen vorzunehmen. Fremdartige Aspekte wie das Profiling werden der Komponente dann zur Laufzeit hinzugefügt.

Was ist was?

Anzeige
Anzeige

Im Sinne von AOP werden Aspekte, die nicht unmittelbar zur Domäne des Programms gehören, auch als „cross-cutting concerns“ bezeichnet. Die Klasse, auf die diese concerns angewandt werden, heißt „target-class“.

Gebräuchlich Begriffe bei AOP
Aspect
Als Aspect wird Code bezeichnet, der „cross-cutting concerns“ beinhaltet, also nicht zur Kernlogik diverser Klassen gehört.
Target
Die Zielklasse, auf die Aspekte angewandt werden.
Advice
Ein Advice bezeichnet den Code, der am Join Point in den Programmablauf miteinfließt.
Join Point
Ein Join Point ist die Stelle eines Programmablaufs, an dem ein bestimmter Code eines Aspects ausgeführt wird.
Pointcut
Ein Pointcut definiert eine Menge an Join Points, an denen ein oder mehrere Advices ausgeführt werden.
Pointcut expression
Die Pointcut expression ist die Schreibweise eines Pointcuts. So kann
diese beispielsweise bewirken, dass alle Methoden einer Zielklasse, die
mit „save“ beginnen, einen Pointcut für einen Aspekt wie Sicherheit
darstellen.
Introduction
Mit einer Introduction wird erreicht, dass eine Klasse ein neues Interface und deren Methoden implementiert.

Der Begriff „Advice“ lässt sich darüber hinaus nach seinem Ausführungszeitpunkt unterteilen:

Anzeige
Anzeige
Arten von Advices
Before advice
Wird vor der Zielmethode ausgeführt.
After returning advice
Wird aufgerufen, wenn die Methode der Zielklasse einen Wert zurückgibt.
Dieser Wert kann vom Advice gelesen, aber nicht verändert werden. Wirft
die Methode eine Exception, wird auch der After returning advice nicht
ausgeführt.
After throwing advice
Wird ausgeführt, wenn die Methode der Zielklasse eine Exception wirft.
After advice
Wird in jedem Fall ausgeführt, nachdem die Methode der Zielklasse ausgeführt wurde.
Around advice
Wird vor und nach dem Methodenaufruf der Zielklasse ausgeführt und kann diesen sogar ganz verhindern. Zudem kann hierdurch der Rückgabewert verändert werden.
Advice chain
Als Advice chain wird eine Reihe von Around advices bezeichnet, die wie Schichten einer Zwiebel aufgerufen werden: „Advice 1 -> Advice 2 -> Target Method -> Advice 2 -> Advice 1“. Jeder dieser Advices kann dabei den Rückgabewert verändern oder die Advice chain abbrechen.

Das Fundament

Ein Aspekt wie Profiling wird in FLOW3 durch eine reguläre PHP-Klasse beschrieben, die eine beliebige Anzahl an Pointcuts, Introductions und Advices beinhaltet. Sie muss in ihrem Kommentar lediglich mittels „@aspect“ als Aspekt getagged werden. Zuvor sollte jedoch der seit PHP 5.3.0 eingeführte Namensraum für die Klasse gesetzt werden. Dieser entspricht in der Regel dem Namensraum für das Paket, dem der Aspekt angehört (hier: SomePackage).

Anzeige
Anzeige
PHP
namespace F3::SomePackage;
/**
 * Profiling Aspect
 * @aspect
 */
class ProfilingAspect{}

Listing 1

Einschnitt im Programmablauf

Da der Profiler in diesem Beispiel darauf basieren wird, die Zeit vor und nach einem Methodenaufruf der target-class zu messen, sollte zunächst ein Schnittpunkt definiert werden, der für diese Aufrufe zutrifft. Um einen solchen Pointcut zu definieren, wird eine leere Methode angelegt, die in ihrem Kommentar die entsprechende Pointcut-Expression enthält. Diese Expression nutzt ebenfalls die neue Namespace-Syntax und besteht jeweils aus einem Bezeichner und seinen Parametern, die reguläre Ausdrücke beinhalten können. Derzeit sind die folgenden fünf Bezeichner verfügbar:

Bezeichner für Pointcut-Expressions
method
Mit diesem Bezeichner lassen sich Pointcuts für Methodenaufrufe definieren. Zudem kann mit Hilfe von „method(public|protected|private ClassName->methodName())“ nach Sichtbarkeit einer Methode gefiltert werden. Wird hierzu nichts angegeben, werden nur sichtbare Methoden geliefert.
class
Hiermit lässt sich ein Pointcut für alle Methodenaufrufe eines Pakets
definieren. Mittels regulärer Ausdrücke können hier auch alle Klassen
eines Pakets einbezogen werden.
within
Mittels „within()“ können Pointcuts für alle Methodenaufrufe definiert
werden, die ein bestimmtes Interface implementieren oder eine bestimmte
Klasse erweitern.
classTaggedWith
Wie der Name schon vermittelt, werden hiermit Klassen angesprochen, die mit einem bestimmten Tag gekennzeichnet sind.
filter
Durch diesen Bezeichner lassen sich eigene Logiken definieren, um Pointcuts zu setzen.

Ein geeigneter Pointcut für den Profiler aus diesem Beispiel stellt einen Schnittpunkt für alle Methodenaufrufe dar, die innerhalb des Pakets „SomePackage“ stattfinden:

Anzeige
Anzeige
PHP
/**
* @pointcut method(F3::SomePackage::.*->.*())
*/
public function allMethodsInPackagePointcut() {}

Listing 2

Ein weiterer Pointcut für alle Methoden desselben Pakets, die mit „find“ beginnen und der Klasse „SomeClass“ angehören, könnte so aussehen:

PHP
/**
 * @pointcut method(F3::SomePackage::SomeClass->find.*())
 */
public function someClassFindMethodsPointcut() {}

Listing 3

Beratender Programmauflauf

Die soeben definierten Pointcuts lassen sich nun dazu nutzen, Advices wie die Zeitmessung darin einzuhängen. Diese werden ähnlich wie Pointcuts definiert. Sie bestehen wieder aus einer Pointcut-Expression im Kommentar und einer Methode. Jedoch kann diese nun mit Kommandos befüllt werden. In ihrer Pointcut-Expression wird dabei auf die zuvor definierten Pointcuts verwiesen. Anstelle eines Pointcuts kann hier auch eine direkte Referenz auf einen Methodenaufruf beschrieben werden. Der Methode eines Advices kann ein Join Point des Typs „F3::FLOW3::AOPJoinPointInterface“ übergeben werden, der automatisch von FLOW3 bereitgestellt wird. Dieses Interface stellt nun neun Methoden zur Verfügung, mit denen Informationen über die Zielklasse und die Methode, die es zu beeinflussen gilt, eingeholt werden können:

  • getProxy()
  • getClassName()
  • getMethodName()
  • getMethodArguments()
  • getMethodArgument($argumentName)
  • isMethodArgument($argumentName)
  • getAdviceChain()
  • getException()
  • getResult()

Im Falle des Profilers bietet es sich an, einen Around advice zu definieren, der das Ergebnis seiner Zeitmessung in ein Logfile schreibt. Zuvor muss jedoch erst ein geeigneter Logger eingebunden werden – idealerweise im Konstruktor des Aspekts:

Anzeige
Anzeige
PHP
/**
 * @var F3::FLOW3::Log::LoggerInterface Instanz des Loggers
 */
protected $logger;
/**
 * Konstruktor-Methode des Aspekts
 * 
 * @param F3::FLOW3::Log::LoggerInterface $logger: Instanz eines Loggers
 * @return void 
*/
public function __construct(F3::FLOW3::Log::LoggerInterface $logger) {
	$this->logger = $logger;
}

Listing 4

FLOW3 erkennt hierbei die Typendeklaration „F3::FLOW3::Log::LoggerInterface“ des Parameters „$logger“ und versucht automatisch eine Instanz dieses Typs zu übergeben. Letztendlich kann nun der Advice definiert werden:

PHP
/**
 * @around F3::SomePackage::ProfilingAspect->allMethodsInPackagePointcut
 */
public function profileMethods(F3::FLOW3::AOPJoinPointInterface $joinPoint) {
	$beforeTime = microtime(true);
	$result = $joinPoint->getAdviceChain()->proceed($joinPoint);
	$proceedTime = microtime(true) - $beforeTime;
	$this->logger->log('Method Execution Time: ' . $joinPoint->getMethodName() . ' of Class '.$joinPoint->getClassName().' took '.$proceedTime.'ms');
	return $result;
}

Listing 5

Unter der Haube

FLOW3 verwendet für sein AOP-Framework [2] weder PHP-Extensions, die zusätzlich installiert werden müssen, noch einen Pre-Processor, sondern ausschließlich reines PHP. Dabei wird intensiv auf die Reflection-Klasse zurückgegriffen, um Aspekte, Pointcuts und Advices zu erkennen. FLOW3 erzeugt dann eine Unterklasse der Zielklasse in Form eines dynamischen Proxys. Dieser implementiert eine Methode zum Abfangen von Funktionsaufrufen, auf die ein bestimmter Advice angewandt werden soll. Diese Proxyklasse wird automatisch vom Framework erzeugt und gecached.

Mehr zu diesem Thema
Fast fertig!

Bitte klicke auf den Link in der Bestätigungsmail, um deine Anmeldung abzuschließen.

Du willst noch weitere Infos zum Newsletter? Jetzt mehr erfahren

Anzeige
Anzeige
Schreib den ersten Kommentar!
Bitte beachte unsere Community-Richtlinien

Wir freuen uns über kontroverse Diskussionen, die gerne auch mal hitzig geführt werden dürfen. Beleidigende, grob anstößige, rassistische und strafrechtlich relevante Äußerungen und Beiträge tolerieren wir nicht. Bitte achte darauf, dass du keine Texte veröffentlichst, für die du keine ausdrückliche Erlaubnis des Urhebers hast. Ebenfalls nicht erlaubt ist der Missbrauch der Webangebote unter t3n.de als Werbeplattform. Die Nennung von Produktnamen, Herstellern, Dienstleistern und Websites ist nur dann zulässig, wenn damit nicht vorrangig der Zweck der Werbung verfolgt wird. Wir behalten uns vor, Beiträge, die diese Regeln verletzen, zu löschen und Accounts zeitweilig oder auf Dauer zu sperren.

Trotz all dieser notwendigen Regeln: Diskutiere kontrovers, sage anderen deine Meinung, trage mit weiterführenden Informationen zum Wissensaustausch bei, aber bleibe dabei fair und respektiere die Meinung anderer. Wir wünschen Dir viel Spaß mit den Webangeboten von t3n und freuen uns auf spannende Beiträge.

Dein t3n-Team

Melde dich mit deinem t3n Account an oder fülle die unteren Felder aus.

Bitte schalte deinen Adblocker für t3n.de aus!
Hallo und herzlich willkommen bei t3n!

Bitte schalte deinen Adblocker für t3n.de aus, um diesen Artikel zu lesen.

Wir sind ein unabhängiger Publisher mit einem Team von mehr als 75 fantastischen Menschen, aber ohne riesigen Konzern im Rücken. Banner und ähnliche Werbemittel sind für unsere Finanzierung sehr wichtig.

Schon jetzt und im Namen der gesamten t3n-Crew: vielen Dank für deine Unterstützung! 🙌

Deine t3n-Crew

Anleitung zur Deaktivierung
Artikel merken

Bitte melde dich an, um diesen Artikel in deiner persönlichen Merkliste auf t3n zu speichern.

Jetzt registrieren und merken

Du hast schon einen t3n-Account? Hier anmelden

oder
Auf Mastodon teilen

Gib die URL deiner Mastodon-Instanz ein, um den Artikel zu teilen.

Anzeige
Anzeige