-<?php
+<?php declare(strict_types=1);
+
+/*
+ * this file is part of the rapsys packbundle package.
+ *
+ * (c) raphaël gertz <symfony@rapsys.eu>
+ *
+ * for the full copyright and license information, please view the license
+ * file that was distributed with this source code.
+ */
-// src/Rapsys/UserBundle/Entity/User.php
namespace Rapsys\UserBundle\Entity;
-use Rapsys\UserBundle\Entity\Group;
-use Symfony\Component\Security\Core\User\UserInterface;
+use Doctrine\Common\Collections\Collection;
use Doctrine\Common\Collections\ArrayCollection;
+use Doctrine\ORM\Event\PreUpdateEventArgs;
+use Symfony\Component\Security\Core\User\UserInterface;
+use Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface;
-class User implements UserInterface, \Serializable {
+use Rapsys\UserBundle\Entity\Civility;
+use Rapsys\UserBundle\Entity\Group;
+
+/**
+ * User
+ */
+class User implements UserInterface, PasswordAuthenticatedUserInterface {
/**
- * @var integer
+ * @var ?integer
*/
- protected $id;
+ protected ?int $id;
/**
* @var string
*/
- protected $mail;
+ protected string $mail;
/**
* @var string
*/
- protected $pseudonym;
+ protected string $password;
/**
- * @var string
+ * @var ?string
*/
- protected $forename;
+ protected ?string $forename;
/**
- * @var string
+ * @var ?string
*/
- protected $surname;
+ protected ?string $surname;
/**
- * @var string
+ * @var bool
*/
- protected $password;
+ protected bool $active;
/**
* @var bool
*/
- protected $active;
+ protected bool $disabled;
/**
* @var \DateTime
*/
- protected $created;
+ protected \DateTime $created;
/**
* @var \DateTime
*/
- protected $updated;
+ protected \DateTime $updated;
/**
- * @var \Rapsys\UserBundle\Entity\Title
+ * @var Civility
*/
- protected $title;
+ protected ?Civility $civility;
/**
- * @var \Doctrine\Common\Collections\Collection
+ * @var Doctrine\Common\Collections\Collection
*/
- protected $groups;
+ protected Collection $groups;
/**
- * User constructor.
- */
- public function __construct() {
- $this->active = false;
+ * Constructor
+ *
+ * @param string $mail The user mail
+ * @param string $password The user password
+ * @param ?Civility $civility The user civility
+ * @param ?string $forename The user forename
+ * @param ?string $surname The user surname
+ * @param bool $active The user active
+ * @param bool $disabled The user disabled
+ */
+ public function __construct(string $mail, string $password, ?Civility $civility = null, ?string $forename = null, ?string $surname = null, bool $active = false, bool $disabled = false) {
+ //Set defaults
+ $this->mail = $mail;
+ $this->password = $password;
+ $this->civility = $civility;
+ $this->forename = $forename;
+ $this->surname = $surname;
+ $this->active = $active;
+ $this->disabled = $disabled;
+ $this->created = new \DateTime('now');
+ $this->updated = new \DateTime('now');
+
+ //Set collections
$this->groups = new ArrayCollection();
}
/**
* Get id
*
- * @return integer
+ * @return ?int
*/
- public function getId() {
+ public function getId(): ?int {
return $this->id;
}
* Set mail
*
* @param string $mail
- *
* @return User
*/
- public function setMail($mail) {
+ public function setMail(string $mail): User {
+ //Set mail
$this->mail = $mail;
return $this;
*
* @return string
*/
- public function getMail() {
+ public function getMail(): string {
return $this->mail;
}
- /**
- * Set pseudonym
- *
- * @param string $pseudonym
- *
- * @return User
- */
- public function setPseudonym($pseudonym) {
- $this->pseudonym = $pseudonym;
-
- return $this;
- }
-
- /**
- * Get pseudonym
- *
- * @return string
- */
- public function getPseudonym() {
- return $this->pseudonym;
- }
-
/**
* Set forename
*
- * @param string $forename
+ * @param ?string $forename
*
* @return User
*/
- public function setForename($forename) {
+ public function setForename(?string $forename): User {
$this->forename = $forename;
return $this;
/**
* Get forename
*
- * @return string
+ * @return ?string
*/
- public function getForename() {
+ public function getForename(): ?string {
return $this->forename;
}
/**
* Set surname
*
- * @param string $surname
+ * @param ?string $surname
*
* @return User
*/
- public function setSurname($surname) {
+ public function setSurname(?string $surname): User {
$this->surname = $surname;
return $this;
/**
* Get surname
*
- * @return string
+ * @return ?string
*/
- public function getSurname() {
+ public function getSurname(): ?string {
return $this->surname;
}
*
* @return User
*/
- public function setPassword($password) {
+ public function setPassword(string $password): User {
+ //Set password
$this->password = $password;
return $this;
/**
* Get password
*
+ * {@inheritdoc}
+ *
* @return string
*/
- public function getPassword() {
+ public function getPassword(): string {
return $this->password;
}
*
* @return User
*/
- public function setActive($active) {
+ public function setActive(bool $active): User {
$this->active = $active;
return $this;
*
* @return bool
*/
- public function getActive() {
+ public function getActive(): bool {
return $this->active;
}
+ /**
+ * Set disabled
+ *
+ * @param bool $disabled
+ *
+ * @return User
+ */
+ public function setDisabled(bool $disabled): User {
+ $this->disabled = $disabled;
+
+ return $this;
+ }
+
+ /**
+ * Get disabled
+ *
+ * @return bool
+ */
+ public function getDisabled(): bool {
+ return $this->disabled;
+ }
+
/**
* Set created
*
*
* @return User
*/
- public function setCreated($created) {
+ public function setCreated(\DateTime $created): User {
$this->created = $created;
return $this;
*
* @return \DateTime
*/
- public function getCreated() {
+ public function getCreated(): \DateTime {
return $this->created;
}
*
* @return User
*/
- public function setUpdated($updated) {
+ public function setUpdated(\DateTime $updated): User {
$this->updated = $updated;
return $this;
*
* @return \DateTime
*/
- public function getUpdated() {
+ public function getUpdated(): \DateTime {
return $this->updated;
}
/**
- * Set title
+ * Set civility
*/
- public function setTitle($title) {
- $this->title = $title;
+ public function setCivility(?Civility $civility = null): User {
+ $this->civility = $civility;
return $this;
}
/**
- * Get title
+ * Get civility
*/
- public function getTitle() {
- return $this->title;
+ public function getCivility(): ?Civility {
+ return $this->civility;
}
/**
* Add group
*
- * @param \Rapsys\UserBundle\Entity\Group $group
+ * @param Group $group
*
* @return User
*/
- public function addGroup(Group $group) {
+ public function addGroup(Group $group): User {
$this->groups[] = $group;
return $this;
/**
* Remove group
*
- * @param \Rapsys\UserBundle\Entity\Group $group
+ * @param Group $group
+ *
+ * @return Doctrine\Common\Collections\Collection
*/
- public function removeGroup(Group $group) {
- $this->groups->removeElement($group);
+ public function removeGroup(Group $group): Collection {
+ return $this->groups->removeElement($group);
}
/**
* Get groups
*
- * @return \Doctrine\Common\Collections\Collection
+ * @return Doctrine\Common\Collections\Collection
*/
- public function getGroups() {
+ public function getGroups(): Collection {
return $this->groups;
}
- public function getRoles() {
- $roles = [ 'ROLE_USER' ];
+ /**
+ * {@inheritdoc}
+ */
+ public function getRoles(): array {
+ //Get the unique roles list by id
+ return array_unique(array_reduce(
+ //Cast groups as array
+ $this->groups->toArray(),
+ //Reduce to an array of id => group tuples
+ function ($array, $group) {
+ $array[$group->getId()] = $group->getRole();
+ return $array;
+ },
+ //Init with empty array
+ //XXX: on registration, add each group present in rapsys_user.default.group array to user
+ //XXX: see vendor/rapsys/userbundle/Controller/DefaultController.php +450
+ []
+ ));
+ }
- foreach($this->groups->toArray() as $group) {
- $roles[] = $group->getRole();
+ /**
+ * {@inheritdoc}
+ */
+ public function getRole(): ?string {
+ //Retrieve roles
+ $roles = $this->getRoles();
+
+ //With roles array empty
+ if ($roles === []) {
+ //Return null
+ return null;
}
- return array_unique($roles);
+ //Return the role with max id
+ //XXX: should be rewriten if it change in your configuration
+ return $roles[array_reduce(
+ array_keys($roles),
+ function($cur, $id) {
+ if ($cur === null || $id > $cur) {
+ return $id;
+ }
+ return $cur;
+ },
+ null
+ )];
}
- public function getSalt() {
+ /**
+ * {@inheritdoc}
+ */
+ public function getSalt(): ?string {
//No salt required with bcrypt
return null;
}
- public function getUsername() {
+ /**
+ * {@inheritdoc}
+ */
+ public function getUsername(): string {
return $this->mail;
}
- public function eraseCredentials() {
+ /**
+ * {@inheritdoc}
+ */
+ public function getUserIdentifier(): string {
+ return $this->mail;
}
- public function serialize() {
- return serialize(array(
+ /**
+ * {@inheritdoc}
+ */
+ public function eraseCredentials(): void {}
+
+ /**
+ * {@inheritdoc}
+ */
+ public function __serialize(): array {
+ return [
$this->id,
$this->mail,
+ $this->forename,
+ $this->surname,
$this->password,
$this->active,
+ $this->disabled,
$this->created,
$this->updated
- ));
+ ];
}
- public function unserialize($serialized) {
+ /**
+ * {@inheritdoc}
+ */
+ public function __unserialize(array $data): void {
list(
$this->id,
$this->mail,
+ $this->forename,
+ $this->surname,
$this->password,
$this->active,
+ $this->disabled,
$this->created,
$this->updated
- ) = unserialize($serialized);
+ ) = $data;
}
- //XXX: was from vendor/symfony/security-core/User/AdvancedUserInterface.php, see if it's used anymore
- public function isEnabled() {
+ /**
+ * Check if account is activated
+ *
+ * @see vendor/rapsys/userbundle/Checker/UserChecker.php
+ */
+ public function isActivated(): bool {
return $this->active;
}
+
+ /**
+ * Check if account is enabled
+ *
+ * @see vendor/symfony/security-core/User/InMemoryUserChecker.php
+ */
+ public function isEnabled(): bool {
+ return !$this->disabled;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function preUpdate(PreUpdateEventArgs $eventArgs) {
+ //Check that we have an user instance
+ if (($user = $eventArgs->getEntity()) instanceof User) {
+ //Set updated value
+ $user->setUpdated(new \DateTime('now'));
+ }
+ }
+
+ /**
+ * Returns a recipient name of the user
+ *
+ * @return string
+ */
+ public function getRecipientName(): string {
+ //Without forename and surname
+ if (empty($this->forename) && empty($this->surname)) {
+ //Return recipient name from mail
+ return ucwords(trim(preg_replace('/[^a-zA-Z]+/', ' ', current(explode('@', $this->mail)))));
+ }
+
+ //Return recipient name from forename and surname
+ return implode(' ', [$this->forename, $this->surname]);
+ }
+
+ /**
+ * Returns a string representation of the user
+ *
+ * @return string
+ */
+ public function __toString(): string {
+ return $this->civility.' '.$this->forename.' '.$this->surname;
+ }
}