-<?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;
+
use Rapsys\UserBundle\Entity\Civility;
+use Rapsys\UserBundle\Entity\Group;
-class User implements UserInterface, \Serializable {
+/**
+ * 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 $enable;
/**
* @var \DateTime
*/
- protected $created;
+ protected \DateTime $created;
/**
* @var \DateTime
*/
- protected $updated;
+ protected \DateTime $updated;
/**
- * @var \Rapsys\UserBundle\Entity\Civility
+ * @var Civility
*/
- protected $civility;
+ protected ?Civility $civility;
/**
- * @var \Doctrine\Common\Collections\Collection
+ * @var Doctrine\Common\Collections\Collection
*/
- protected $groups;
+ protected Collection $groups;
/**
* Constructor
- */
- public function __construct() {
- $this->active = false;
+ *
+ * @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 $enable The user enable
+ */
+ public function __construct(string $mail, string $password, ?Civility $civility = null, ?string $forename = null, ?string $surname = null, bool $active = false, bool $enable = true) {
+ //Set defaults
+ $this->mail = $mail;
+ $this->password = $password;
+ $this->civility = $civility;
+ $this->forename = $forename;
+ $this->surname = $surname;
+ $this->active = $active;
+ $this->enable = $enable;
+ $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;
*
* @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 enable
+ *
+ * @param bool $enable
+ *
+ * @return User
+ */
+ public function setEnable(bool $enable): User {
+ $this->enable = $enable;
+
+ return $this;
+ }
+
+ /**
+ * Get enable
+ *
+ * @return bool
+ */
+ public function getEnable(): bool {
+ return $this->enable;
+ }
+
/**
* 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 civility
*/
- public function setCivility(Civility $civility) {
+ public function setCivility(?Civility $civility = null): User {
$this->civility = $civility;
return $this;
/**
* Get civility
*/
- public function getCivility(): Civility {
+ 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;
}
/**
* {@inheritdoc}
*/
- public function getRoles() {
+ public function getRoles(): array {
//Get the unique roles list by id
return array_unique(array_reduce(
//Cast groups as array
/**
* {@inheritdoc}
*/
- public function getRole() {
+ public function getRole(): ?string {
//Retrieve roles
$roles = $this->getRoles();
/**
* {@inheritdoc}
*/
- public function getSalt() {
+ public function getSalt(): ?string {
//No salt required with bcrypt
return null;
}
/**
* {@inheritdoc}
*/
- public function getUsername() {
+ public function getUsername(): string {
+ return $this->mail;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getUserIdentifier(): string {
return $this->mail;
}
/**
* {@inheritdoc}
*/
- public function eraseCredentials() {}
+ public function eraseCredentials(): void {}
- public function serialize(): string {
- return serialize([
+ /**
+ * {@inheritdoc}
+ */
+ public function __serialize(): array {
+ return [
$this->id,
$this->mail,
+ $this->forename,
+ $this->surname,
$this->password,
$this->active,
+ $this->enable,
$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->enable,
$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->enable;
+ }
+
/**
* {@inheritdoc}
*/
- public function preUpdate(\Doctrine\ORM\Event\PreUpdateEventArgs $eventArgs) {
+ public function preUpdate(PreUpdateEventArgs $eventArgs) {
//Check that we have an user instance
if (($user = $eventArgs->getEntity()) instanceof User) {
//Set updated value
}
}
+ /**
+ * 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
*