API Responses ExpandResponseInterface - evansims/openfga-php GitHub Wiki

Interface for relationship expansion response objects. This interface defines the contract for responses returned when expanding relationships in OpenFGA. An expand response contains a tree structure that shows all the users and usersets that have a particular relationship with an object, providing a comprehensive view of the authorization graph. Relationship expansion is useful for understanding complex authorization structures, debugging permission issues, and visualizing how relationships are resolved.

OpenFGA\Responses

View source code

• ResponseInterface

• ExpandResponse (implementation)
• ExpandRequestInterface (request)

public function getTree(): UsersetTreeInterface|null

Get the expansion tree for the queried relationship. Returns a hierarchical tree structure that represents all users and usersets that have the specified relationship with the target object. The tree shows both direct relationships and computed relationships through other relations.

View source

UsersetTreeInterface | null — The relationship expansion tree, or null if no relationships found