Présentation

ICopixCredentialHandler est l'interface de base des gestionnaires de droit.

interface ICopixCredentialHandler {
	public function assert ($pStringType, $pString, $pUser);
}

Tester les droits

Les gestionnaires de droits n'ont pour tâche que le test des droits d'un utilisateur donné.

Pour ce faire, il doivent implémenter la méthode "assert" qui retourne un booléen true ou false si l'utilisateur dispose ou non des droits en question.

La méthode reçoit trois paramètres :

• $pStringType le type de droit (en standard basic?, group, module?, ou dynamic?)
• $pString La chaine de droit à tester (sans le type de droit)
• $pUser L'utilisateur courant sous la forme d'un objet CopixUser

En cas de tests multiples pour un même couple utilisateur / clef, Copix se souvient des résultats et n'appellera votre gestionnaire qu'une seule fois.

Exemples de tests de droits

_currentUser ()->assertCredential ('basic:registered');//on demande à ce que l'utilisateur soit connecté
_currentUser ()->assertCredential ('group:[admin]');//on demande à ce que l'utilisateur appartienne à un groupe nommé "admin"
_currentUser ()->assertCredential ('module:write@news');//on demande à ce que l'utilisateur dispose du droit "write" déclaré dans le module "news"