abstract class Presenter extends Control implements IPresenter

Presenter component represents a webpage instance. It converts Request to Response.

Constants

InvalidLinkSilent

bad link handling Presenter::$invalidLinkMode

InvalidLinkWarning

bad link handling Presenter::$invalidLinkMode

InvalidLinkException

bad link handling Presenter::$invalidLinkMode

InvalidLinkTextual

bad link handling Presenter::$invalidLinkMode

internal PresenterKey

internal SignalKey

internal ActionKey

internal FlashKey

internal DefaultAction

deprecated INVALID_LINK_SILENT

deprecated INVALID_LINK_WARNING

deprecated INVALID_LINK_EXCEPTION

deprecated INVALID_LINK_TEXTUAL

deprecated PRESENTER_KEY

deprecated SIGNAL_KEY

deprecated ACTION_KEY

deprecated FLASH_KEY

deprecated DEFAULT_ACTION

Properties

$invalidLinkMode
$onStartup
$onRender
$onShutdown
$autoCanonicalize

automatically call canonicalize()

$absoluteUrls

use absolute Urls or paths?

deprecated $allowedMethods
stdClass read-only $payload

Methods

Request|null
getRequest()

No description

Presenter|null
getPresenter()

Returns self.

Presenter|null
getPresenterIfExists()

Returns the presenter where this component belongs to.

bool
hasPresenter() deprecated

No description

string
getUniqueId()

Returns a name that uniquely identifies component.

bool
isModuleCurrent(string $module)

No description

bool
isForwarded()

No description

run(Request $request)

No description

void
startup()

No description

void
beforeRender()

Common render method.

void
afterRender()

Common render method.

void
shutdown(Response $response)

No description

void
detectedCsrf()

This method will be called when CSRF is detected.

void
checkHttpMethod() deprecated

No description

void
processSignal()

No description

array|null
getSignal()

Returns pair signal receiver and name.

bool
isSignalReceiver(Component|string $component, string|bool|null $signal = null)

Checks if the signal receiver is the given one.

string
getAction(bool $fullyQualified = false)

Returns current action name.

void
changeAction(string $action)

Changes current action.

never
switch(string $action)

Switch from current action or render method to another.

string
getView()

Returns current view.

setView(string $view)

Changes current view. Any name is allowed.

string|bool
getLayout()

Returns current layout name.

setLayout(string|bool $layout)

Changes or disables layout.

never
sendTemplate(Template|null $template = null)

No description

string
findTemplateFile()

Finds template file name.

string|null
findLayoutTemplateFile()

Finds layout template file name.

array
formatLayoutTemplateFiles()

Formats layout template file names.

array
formatTemplateFiles()

Formats view template file names.

static string
formatActionMethod(string $action)

Formats action method name.

static string
formatRenderMethod(string $view)

Formats render view method name.

createTemplate(string|null $class = null)

No description

string|null
formatTemplateClass()

No description

getPayload()

No description

bool
isAjax()

Is AJAX request?

never
sendPayload()

Sends AJAX payload to the output.

never
sendJson(mixed $data)

Sends JSON data to the output.

never
sendResponse(Response $response)

Sends response and terminates presenter.

never
terminate()

Correctly terminates presenter.

never
forward(Request $destination, array|mixed $args = [])

Forward to another presenter or action.

never
redirectUrl(string $url, int|null $httpCode = null)

Redirect to another URL and ends presenter execution.

Request|null
getLastCreatedRequest()

Returns the last created Request.

bool
getLastCreatedRequestFlag(string $flag)

Returns the last created Request flag.

void
canonicalize(string|null $destination = null, mixed ...$args)

Conditional redirect to canonicalized URI.

void
lastModified(string|int|DateTimeInterface|null $lastModified, string|null $etag = null, string|null $expire = null)

Attempts to cache the sent entity by its last modification date.

string|null
createRequest(Component $component, string $destination, array $args, string $mode) deprecated

No description

static array
parseDestination(string $destination) deprecated

No description

string
requestToUrl(Request $request, bool|null $relative = null) deprecated

No description

string
processInvalidLink(InvalidLinkException $e)

Invalid link handler. Descendant can override this method to change default behaviour.

string
storeRequest(string $expiration = '+ 10 minutes')

Stores current request to session.

void
restoreRequest(string $key)

Restores request from session.

static array
getPersistentComponents()

Descendant can override this method to return the names of custom persistent components.

array
getGlobalState(string|null $forClass = null)

Saves state information for all subcomponents to $this->globalState.

void
saveGlobalState()

Permanently saves state information for all subcomponents to $this->globalState.

array
popGlobalParameters(string $id)

Pops parameters for specified component.

bool
hasFlashSession()

Checks if a flash session namespace exists.

SessionSection
getFlashSession()

Returns session namespace provided to pass temporary data between redirects.

void
injectPrimary(IRequest $httpRequest, IResponse $httpResponse, IPresenterFactory|null $presenterFactory = null, Router|null $router = null, Session|null $session = null, User|null $user = null, TemplateFactory|null $templateFactory = null)

No description

IRequest
getHttpRequest()

No description

IResponse
getHttpResponse()

No description

SessionSection
getSession(string|null $namespace = null)

No description

User
getUser()

No description

getLinkGenerator()

No description

Details

at line 117
final Request|null getRequest()

No description

Return Value

Request|null

at line 126
final Presenter|null getPresenter()

Returns self.

Return Value

Presenter|null

at line 132
final Presenter|null getPresenterIfExists()

Returns the presenter where this component belongs to.

Return Value

Presenter|null

at line 139
final bool hasPresenter() deprecated

deprecated

No description

Return Value

bool

at line 148
string getUniqueId()

Returns a name that uniquely identifies component.

Return Value

string

at line 154
bool isModuleCurrent(string $module)

No description

Parameters

string $module

Return Value

bool

at line 161
bool isForwarded()

No description

Return Value

bool

at line 170
Response run(Request $request)

No description

Parameters

Request $request

Return Value

Response

at line 276
protected void startup()

No description

Return Value

void

at line 286
protected void beforeRender()

Common render method.

Return Value

void

at line 294
protected void afterRender()

Common render method.

Return Value

void

at line 299
protected void shutdown(Response $response)

No description

Parameters

Response $response

Return Value

void

at line 307
void detectedCsrf()

This method will be called when CSRF is detected.

Return Value

void

at line 318
protected void checkHttpMethod() deprecated

deprecated use #[Requires(methods: ...)] to specify allowed methods

No description

Return Value

void

at line 335
void processSignal()

No description

Return Value

void

Exceptions

BadSignalException

at line 359
final array|null getSignal()

Returns pair signal receiver and name.

Return Value

array|null

at line 368
final bool isSignalReceiver(Component|string $component, string|bool|null $signal = null)

Checks if the signal receiver is the given one.

Parameters

Component|string $component
string|bool|null $signal

Return Value

bool

at line 400
final string getAction(bool $fullyQualified = false)

Returns current action name.

Parameters

bool $fullyQualified

Return Value

string

at line 411
void changeAction(string $action)

Changes current action.

Parameters

string $action

Return Value

void

at line 421
never switch(string $action)

Switch from current action or render method to another.

Parameters

string $action

Return Value

never

at line 430
final string getView()

Returns current view.

Return Value

string

at line 439
Presenter setView(string $view)

Changes current view. Any name is allowed.

Parameters

string $view

Return Value

Presenter

at line 450
final string|bool getLayout()

Returns current layout name.

Return Value

string|bool

at line 459
Presenter setLayout(string|bool $layout)

Changes or disables layout.

Parameters

string|bool $layout

Return Value

Presenter

at line 469
never sendTemplate(Template|null $template = null)

No description

Parameters

Template|null $template

Return Value

never

Exceptions

AbortException

at line 482
string findTemplateFile()

Finds template file name.

Return Value

string

at line 500
string|null findLayoutTemplateFile()

internal  
 

Finds layout template file name.

Return Value

string|null

at line 526
array formatLayoutTemplateFiles()

Formats layout template file names.

Return Value

array

at line 563
array formatTemplateFiles()

Formats view template file names.

Return Value

array

at line 586
static string formatActionMethod(string $action)

Formats action method name.

Parameters

string $action

Return Value

string

at line 595
static string formatRenderMethod(string $view)

Formats render view method name.

Parameters

string $view

Return Value

string

at line 601
protected Template createTemplate(string|null $class = null)

No description

Parameters

string|null $class

Return Value

Template

at line 608
string|null formatTemplateClass()

No description

Return Value

string|null

at line 619
final stdClass getPayload()

No description

Return Value

stdClass

at line 628
bool isAjax()

Is AJAX request?

Return Value

bool

at line 642
never sendPayload()

Sends AJAX payload to the output.

Return Value

never

Exceptions

AbortException

at line 652
never sendJson(mixed $data)

Sends JSON data to the output.

Parameters

mixed $data

Return Value

never

Exceptions

AbortException

at line 665
never sendResponse(Response $response)

Sends response and terminates presenter.

Parameters

Response $response

Return Value

never

Exceptions

AbortException

at line 676
never terminate()

Correctly terminates presenter.

Return Value

never

Exceptions

AbortException

at line 687
never forward(Request $destination, array|mixed $args = [])

Forward to another presenter or action.

Parameters

Request $destination
array|mixed $args

Return Value

never

Exceptions

AbortException

at line 705
never redirectUrl(string $url, int|null $httpCode = null)

Redirect to another URL and ends presenter execution.

Parameters

string $url
int|null $httpCode

Return Value

never

Exceptions

AbortException

at line 725
final Request|null getLastCreatedRequest()

internal  
 

Returns the last created Request.

Return Value

Request|null

at line 735
final bool getLastCreatedRequestFlag(string $flag)

internal  
 

Returns the last created Request flag.

Parameters

string $flag

Return Value

bool

at line 746
void canonicalize(string|null $destination = null, mixed ...$args)

Conditional redirect to canonicalized URI.

Parameters

string|null $destination
mixed ...$args

Return Value

void

Exceptions

AbortException

at line 783
void lastModified(string|int|DateTimeInterface|null $lastModified, string|null $etag = null, string|null $expire = null)

Attempts to cache the sent entity by its last modification date.

Parameters

string|int|DateTimeInterface|null $lastModified
string|null $etag

strong entity tag validator

string|null $expire

like '20 minutes'

Return Value

void

Exceptions

AbortException

at line 801
protected string|null createRequest(Component $component, string $destination, array $args, string $mode) deprecated

deprecated @internal

No description

Parameters

Component $component
string $destination
array $args
string $mode

Return Value

string|null

at line 808
static array parseDestination(string $destination) deprecated

deprecated @internal

No description

Parameters

string $destination

Return Value

array

at line 815
protected string requestToUrl(Request $request, bool|null $relative = null) deprecated

deprecated @internal

No description

Parameters

Request $request
bool|null $relative

Return Value

string

Invalid link handler. Descendant can override this method to change default behaviour.

Parameters

InvalidLinkException $e

Return Value

string

Exceptions

InvalidLinkException

at line 845
string storeRequest(string $expiration = '+ 10 minutes')

Stores current request to session.

Parameters

string $expiration

Return Value

string

at line 861
void restoreRequest(string $key)

Restores request from session.

Parameters

string $key

Return Value

void

at line 890
static array getPersistentComponents()

Descendant can override this method to return the names of custom persistent components.

Return Value

array

at line 899
array getGlobalState(string|null $forClass = null)

Saves state information for all subcomponents to $this->globalState.

Parameters

string|null $forClass

Return Value

array

at line 973
protected void saveGlobalState()

Permanently saves state information for all subcomponents to $this->globalState.

Return Value

void

at line 1049
final array popGlobalParameters(string $id)

internal  
 

Pops parameters for specified component.

Parameters

string $id

Return Value

array

at line 1072
bool hasFlashSession()

Checks if a flash session namespace exists.

Return Value

bool

at line 1083
SessionSection getFlashSession()

Returns session namespace provided to pass temporary data between redirects.

Return Value

SessionSection

at line 1097
final void injectPrimary(IRequest $httpRequest, IResponse $httpResponse, IPresenterFactory|null $presenterFactory = null, Router|null $router = null, Session|null $session = null, User|null $user = null, TemplateFactory|null $templateFactory = null)

No description

Parameters

IRequest $httpRequest
IResponse $httpResponse
IPresenterFactory|null $presenterFactory
Router|null $router
Session|null $session
User|null $user
TemplateFactory|null $templateFactory

Return Value

void

at line 1123
final IRequest getHttpRequest()

No description

Return Value

IRequest

at line 1129
final IResponse getHttpResponse()

No description

Return Value

IResponse

at line 1135
final SessionSection getSession(string|null $namespace = null)

No description

Parameters

string|null $namespace

Return Value

SessionSection

at line 1147
final User getUser()

No description

Return Value

User

at line 1153
final TemplateFactory getTemplateFactory()

No description

Return Value

TemplateFactory

at line 1159
final protected LinkGenerator getLinkGenerator()

No description

Return Value

LinkGenerator