Trait BackreferenceTrait

Provides a simple means for a trait to get a reference to another trait method that called it, providing the fully qualified method name one level up the

stack from the calling method, so it can determine it's caller.

Traits provide extended method support to classes without requiring a direct, linear chain of inheritance. This allows functions to inherit subsets of related methods without declaring a parent class.

In Oroboros core, ALL methods are granted to classes via traits, and the classes themselves are just containers that correlate their methods to an interface they are expected to honor. This approach maximizes interoperability, by entirely removing class inheritance as a requirement for extension of any class in this system.

3rd parties using this package are not expected to follow this approach,

but ALL of our internal class and logic structure does.

Direct Known Users

oroboros\core\traits\patterns\behavioral\RegistryTrait

Namespace: oroboros\core\traits\utilities\logic
Package: oroboros\core\utilities
Category: contract-interfaces
License: The MIT License (MIT)
Author: Brian Dayhoff mopsyd@me.com
Version: 0.2.4
Since: 0.2.4-alpha
Link: bitbucket.org/oroborosframework/oroboros-core/wiki/development/api/contract_interface.md
Located at core/traits/utilities/logic/BackReferenceTrait.php

Methods summary

`protected string\|boolean`	# `_getBackReference( )` Returns the accurate, immediate backreference of one prior level of the stack up from wherever it was called, honoring inheritance and trait definitions that were not overridden within a class. Returns the accurate, immediate backreference of one prior level of the stack up from wherever it was called, honoring inheritance and trait definitions that were not overridden within a class. Returns string\|boolean Returns false if backreference is a global call. Otherwise returns the fully qualified method or function declaration, from the class or trait that declared it.
`private`	# `_getBackReferenceTraceReferenceReflector( array $reference )` Logic Methods (private) Logic Methods (private) These methods are not externally exposed. They represent the actual work.
`private`	# `_findBackReferenceRealInheritanceLocation( ReflectionFunctionAbstract $reflector, array $reference )`
`private`	# `_getBackReferenceMatchingTraits( ReflectionFunctionAbstract $instance )` Will check if a reflector uses traits recursively through all levels of inheritance. Will check if a reflector uses traits recursively through all levels of inheritance. Parameters `$instance` $trait
`private`	# `_filterBackReferenceTraitInheritance( ReflectionFunctionAbstract $trait, array & $traits )`
`private`	# `_convertBackReferenceNameSpaceToRelativeFilePath( $class )`

Namespaces

Traits

Trait BackreferenceTrait

stack from the calling method, so it can determine it's caller.

but ALL of our internal class and logic structure does.

Direct Known Users

Methods summary

Returns

They represent the actual work.

Parameters