Sf TIC Bundles

DefaultController extends TICController
in package

Application

Uses ControllerViewable

#Security("has_role('ROLE_ADMIN')")

Properties

$ctxBundle : mixed: nom du sous-dossier du controlleur (ex: '', 'Admin', 'Front', ...)
$ctxClass : mixed
$ctxForm : mixed: nom dans les tokens génériques (ex: 'item', 'user', 'book", 'foobar')
$ctxMesg : mixed: préfixe utilisé pour les tokens (ex: 'app.foobar.', 'admin.foobar.', 'ticdemo.foobar.')
$ctxName : mixed: espace de nommage de base du bundle (ex: 'App', 'TIC\DemoBundle')
$ctxPath : mixed: nom du controlleur en camel case (ex: 'Default', 'User', 'Book', 'FooBar', ...)
$ctxRoot : mixed: type de la classe courante (ex: 'Controller', 'Command')
$ctxRoute : mixed: nom du controlleur en snake case (ex: 'default', 'book', 'foo_bar')
$ctxSnake : mixed: alias du bundle pour repo, views... (ex: null, '@TICDemo')
$ctxTrans : mixed: préfixe utilisé pour les routes (ex: 'app_foobar_', 'admin_foobar_', 'ticdemo_foobar_')
$ctxType : mixed: nom complet de la classe courante (ex: 'App\Controller\Admin\FooBarController')
$defaultViewPage : mixed
$defaultViewPath : mixed
$defaultViewType : mixed

Methods

index() : Response
setContextProperties() : void: DI avec auto-wiring (inutile de définir le "call" sur le service grace à l'attribut @required).
alert() : RedirectResponse: Ajout d'un message dans le FlashBag (avec redirection optionnelle).
checkCSRF() : bool: Vérification de la validité d'un token CSRF dans la requête.
checkRole() : bool: Vérification que l'utilisateur courant dispose de l'un des droits mentionnés.
fileDownload() : Response: Méthode utilitaire pour retourner un fichier en réponse d'une action.
fileHeaders() : array<string|int, mixed>: Retourne les entêtes HTTP pour le téléchargement d'un fichier du serveur.
fileStream() : StreamedResponse: Méthode utilitaire pour retourner un fichier en réponse d'une action (version stream avec option delete).
getContextProperties() : array<string|int, mixed>: Retourne la liste des propriétés définies dans un tableaux (utile pour du debug).
getForm() : FormInterface: Raccourci pour créer le formulaire correspondant au controlleur.
getItemLabel() : string: Retourne le nom (traduit, au singulier ou au pluriel) de l'objet du controlleur.
getRoute() : string: Raccourci pour générer le nom de la route d'une action du controlleur.
getView() : string: Raccourci pour retourner la vue associée par défaut à l'action du controlleur.
mesg() : string
redirectItem() : RedirectResponse: Redirection vers l'action par défaut de fiche.
redirectList() : RedirectResponse: Redirection vers l'action par défaut de liste.
redirectReferer() : RedirectResponse: Redirection vers l'adresse du referer (depuis entêtes du serveur web).
redirectTo() : RedirectResponse: Redirection automatique selon le paramètre (liste, fiche, referer, autre...).
renderAction() : Response: Génération du rendu de la vue de l'action spécifiée.
renderContent() : string: Génération du rendu de la vue de l'action spécifiée.
trans() : string|array<string|int, mixed>: Raccourci vers la méthode trans du translator.

$ctxBundle

nom du sous-dossier du controlleur (ex: '', 'Admin', 'Front', ...)


    protected
        mixed
    $ctxBundle

$ctxClass


    protected
        mixed
    $ctxClass

$ctxForm

nom dans les tokens génériques (ex: 'item', 'user', 'book", 'foobar')


    protected
        mixed
    $ctxForm

$ctxMesg

préfixe utilisé pour les tokens (ex: 'app.foobar.', 'admin.foobar.', 'ticdemo.foobar.')


    protected
        mixed
    $ctxMesg
     = 'item'

$ctxName

espace de nommage de base du bundle (ex: 'App', 'TIC\DemoBundle')


    protected
        mixed
    $ctxName

$ctxPath

nom du controlleur en camel case (ex: 'Default', 'User', 'Book', 'FooBar', ...)


    protected
        mixed
    $ctxPath

$ctxRoot

type de la classe courante (ex: 'Controller', 'Command')


    protected
        mixed
    $ctxRoot

$ctxRoute

nom du controlleur en snake case (ex: 'default', 'book', 'foo_bar')


    protected
        mixed
    $ctxRoute

$ctxSnake

alias du bundle pour repo, views... (ex: null, '@TICDemo')


    protected
        mixed
    $ctxSnake

$ctxTrans

préfixe utilisé pour les routes (ex: 'app_foobar_', 'admin_foobar_', 'ticdemo_foobar_')


    protected
        mixed
    $ctxTrans

$ctxType

nom complet de la classe courante (ex: 'App\Controller\Admin\FooBarController')


    protected
        mixed
    $ctxType

$defaultViewPage


    protected
        mixed
    $defaultViewPage
     = 'index'

$defaultViewPath


    protected
        mixed
    $defaultViewPath
     = null

$defaultViewType


    protected
        mixed
    $defaultViewType
     = 'html'

index()


    public
                    index(Request $request) : Response

Parameters

$request : Request

Return values

Response

setContextProperties()

DI avec auto-wiring (inutile de définir le "call" sur le service grace à l'attribut @required).


    public
                    setContextProperties([string|null $classType = null ]) : void

Parameters

$classType : string|null = null

alert()

Ajout d'un message dans le FlashBag (avec redirection optionnelle).


    protected
                    alert(string $type, string|array<string|int, mixed> $message[, mixed $redirect = null ]) : RedirectResponse

Parameters

$type : string: Contexte bootstrap : success | info | warning | danger
$message : string|array<string|int, mixed>: Texte simple ou structure avec : title [text] [extra] [params]
$redirect : mixed = null: Boolean (liste/referer), Entité (ou id) ou autre route

Return values

RedirectResponse —

Réponse HTTP avec redirection selon le paramètre $redirect

checkCSRF()

Vérification de la validité d'un token CSRF dans la requête.


    protected
                    checkCSRF(string $name[, Request $request = null ]) : bool

Parameters

$name : string: Clé du token à vérifier dans la requête
$request : Request = null: Requête courante pour récupération de la valeur du token

Return values

bool

checkRole()

Vérification que l'utilisateur courant dispose de l'un des droits mentionnés.


    protected
                    checkRole(string|array<string|int, mixed> $roles[, string|bool $exception = false ]) : bool

Parameters

$roles : string|array<string|int, mixed>: Liste des rôles requis (test 'OR'), sans le préfixe 'ROLE_'
$exception : string|bool = false: Message pour lever une exception (True pour le message par défaut)

Return values

bool —

True si l'un des rôles est trouvé, sinon False (si $exception à False)

fileDownload()

Méthode utilitaire pour retourner un fichier en réponse d'une action.


    protected
                    fileDownload(string $filepath[, string $filename = null ][, bool $inline = false ][, bool|string $mimetype = null ]) : Response

Parameters

$filepath : string: Chemin complet sur le système de fichier
$filename : string = null: Nom à présenter pour le téléchargement (depuis $filepath par défaut)
$inline : bool = false: Faux pour forcer le téléchargement
$mimetype : bool|string = null: Type MIME (deviné par défaut, application/octet-stream si True)

Return values

Response —

Réponse HTTP contenant les données du fichier

fileHeaders()

Retourne les entêtes HTTP pour le téléchargement d'un fichier du serveur.


    protected
                    fileHeaders(string $filepath, string $filename, bool|string $mimetype, bool $inline) : array<string|int, mixed>

Parameters

$filepath : string: Chemin complet sur le système de fichier
$filename : string: Nom à présenter pour le téléchargement (depuis $filepath par défaut)
$mimetype : bool|string: Type MIME (deviné par défaut, application/octet-stream si True)
$inline : bool: Faux pour forcer le téléchargement

Return values

array<string|int, mixed> —

Liste d'entêtes HTTP pour une Response

fileStream()

Méthode utilitaire pour retourner un fichier en réponse d'une action (version stream avec option delete).


    protected
                    fileStream(string $filepath[, string $filename = null ][, bool $inline = false ][, bool|string $mimetype = null ][, bool $delete = false ]) : StreamedResponse

Parameters

$filepath : string: Chemin complet sur le système de fichier
$filename : string = null: Nom à présenter pour le téléchargement (depuis $filepath par défaut)
$inline : bool = false: Faux pour forcer le téléchargement
$mimetype : bool|string = null: Type MIME (deviné par défaut, application/octet-stream si True)
$delete : bool = false: Suppression du fichier à la fin du téléchargement

Return values

StreamedResponse —

Réponse HTTP avec callback pour transmission des données du fichier

getContextProperties()

Retourne la liste des propriétés définies dans un tableaux (utile pour du debug).


    protected
                    getContextProperties() : array<string|int, mixed>

Return values

array<string|int, mixed>

getForm()

Raccourci pour créer le formulaire correspondant au controlleur.


    protected
                    getForm([mixed $data = null ][, Request $request = null ][, array<string|int, mixed> $options = [] ]) : FormInterface

Parameters

$data : mixed = null
$request : Request = null
$options : array<string|int, mixed> = []: Options du formulaire + facultatif "form_name" pour spécifier son nommage

Return values

FormInterface

getItemLabel()

Retourne le nom (traduit, au singulier ou au pluriel) de l'objet du controlleur.


    protected
                    getItemLabel([bool $pluriel = false ]) : string

Parameters

$pluriel : bool = false

Return values

string

getRoute()

Raccourci pour générer le nom de la route d'une action du controlleur.


    protected
                    getRoute(string $action[, mixed $item = null ][, array<string|int, mixed> $params = [] ]) : string

Parameters

$action : string: Nom de l'action (utilisée en suffixe de la route)
$item : mixed = null: Entité (avec getId) ou clé primaire pour la route (id)
$params : array<string|int, mixed> = []: Liste des paramètres pour la génération de l'URL

Return values

string —

URL de la route correspondante

getView()

Raccourci pour retourner la vue associée par défaut à l'action du controlleur.


    protected
                    getView([string $page = null ][, string $type = null ]) : string

Exemples: 'demo_pizza/index.html.twig' 'admin/demo_pizza/index.html.twig' '@TICDemo/crud_object/index.html.twig'

Parameters

$page : string = null: Nom de base du template Twig (voir $defaultViewPage)
$type : string = null: Suffixe du type du template (voir $defaultViewType)

Return values

string

mesg()


    protected
                    mesg(string $mesg) : string

Parameters

$mesg : string

Return values

string

redirectItem()

Redirection vers l'action par défaut de fiche.


    protected
                    redirectItem(mixed $item[, array<string|int, mixed> $params = [] ][, int $status = 303 ]) : RedirectResponse

Parameters

$item : mixed: Entité (avec getId) ou clé primaire pour la route (id)
$params : array<string|int, mixed> = []: Liste des paramètres pour la génération de l'URL
$status : int = 303: Code HTTP de la réponse à retourner

Return values

RedirectResponse —

Réponse HTTP avec redirection vers la route correspondante

redirectList()

Redirection vers l'action par défaut de liste.


    protected
                    redirectList([array<string|int, mixed> $params = [] ][, int $status = 303 ]) : RedirectResponse

Parameters

$params : array<string|int, mixed> = []: Liste des paramètres pour la génération de l'URL
$status : int = 303: Code HTTP de la réponse à retourner

Return values

RedirectResponse —

Réponse HTTP avec redirection vers la route correspondante

redirectReferer()

Redirection vers l'adresse du referer (depuis entêtes du serveur web).


    protected
                    redirectReferer([int $status = 302 ]) : RedirectResponse

Parameters

$status : int = 302: Code HTTP de la réponse à retourner

Return values

RedirectResponse —

Réponse HTTP avec redirection vers la page précédente

redirectTo()

Redirection automatique selon le paramètre (liste, fiche, referer, autre...).


    protected
                    redirectTo([mixed $target = false ]) : RedirectResponse

Parameters

$target : mixed = false: Boolean (liste/referer), Entité (ou id) ou autre route

Return values

RedirectResponse —

Réponse HTTP avec redirection vers l'URL correspondante

renderAction()

Génération du rendu de la vue de l'action spécifiée.


    protected
                    renderAction([string $action = '' ][, array<string|int, mixed> $parameters = array() ][, Response $response = null ]) : Response

Parameters

$action : string = '': (peu contenir le $type en suffixe)
$parameters : array<string|int, mixed> = array(): (conversion auto des FormType en FormView)
$response : Response = null: (si une réponse déjà initialisée doit être utilisée)

Return values

Response —

(status code 422 si FormType en échec)

renderContent()

Génération du rendu de la vue de l'action spécifiée.


    protected
                    renderContent(string $action[, array<string|int, mixed> $parameters = array() ]) : string

Parameters

$action : string: (peut contenir le $type en suffixe)
$parameters : array<string|int, mixed> = array()

Return values

string

trans()

Raccourci vers la méthode trans du translator.


    protected
                    trans(atring|array<string|int, mixed> $message[, array<string|int, mixed> $parameters = [] ]) : string|array<string|int, mixed>

Parameters

$message : atring|array<string|int, mixed>: Clé de message à traduire (possibilité de traiter une liste)
$parameters : array<string|int, mixed> = []: Liste de paramètres à fournir à la méthode du translator

Return values

string|array<string|int, mixed> —

Chaine traduite (ou liste des chaines traduites)

DefaultController extends TICController in package Application Uses ControllerViewable

Table of Contents

Properties

Methods

Properties

$ctxBundle

$ctxClass

$ctxForm

$ctxMesg

$ctxName

$ctxPath

$ctxRoot

$ctxRoute

$ctxSnake

$ctxTrans

$ctxType

$defaultViewPage

$defaultViewPath

$defaultViewType

Methods

index()

Parameters

Tags

Return values

setContextProperties()

Parameters

Tags

alert()

Parameters

Return values

checkCSRF()

Parameters

Return values

checkRole()

Parameters

Return values

fileDownload()

Parameters

Return values

fileHeaders()

Parameters

Return values

fileStream()

Parameters

Return values

getContextProperties()

Return values

getForm()

Parameters

Return values

getItemLabel()

Parameters

Return values

getRoute()

Parameters

Return values

getView()

Parameters

Return values

mesg()

Parameters

Return values

redirectItem()

Parameters

Return values

redirectList()

Parameters

Return values

redirectReferer()

Parameters

Return values

redirectTo()

Parameters

Return values

renderAction()

Parameters

Return values

renderContent()

Parameters

Return values

DefaultController extends TICController
in package

Application

Uses ControllerViewable