]> Raphaël G. Git Repositories - userbundle/blobdiff - Entity/User.php
Add note about normalisation prevention
[userbundle] / Entity / User.php
index 5df315a11f24bf94183f4d46dba758b506e4a154..61be1051684af4a8e533d809413d1aa558eb3c9b 100644 (file)
@@ -1,14 +1,28 @@
-<?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\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, \Serializable {
        /**
         * @var integer
         */
@@ -19,11 +33,6 @@ class User implements UserInterface, \Serializable {
         */
        protected $mail;
 
-       /**
-        * @var string
-        */
-       protected $pseudonym;
-
        /**
         * @var string
         */
@@ -60,21 +69,40 @@ class User implements UserInterface, \Serializable {
        protected $updated;
 
        /**
-        * @var \Rapsys\UserBundle\Entity\Civility
+        * @var Civility
         */
        protected $civility;
 
        /**
-        * @var \Doctrine\Common\Collections\ArrayCollection
+        * @var ArrayCollection
         */
        protected $groups;
 
        /**
         * Constructor
-        */
-       public function __construct() {
+        *
+        * @param ?string $mail The user mail
+        */
+       public function __construct(?string $mail) {
+               //With mail
+               if ($mail !== null && !empty($mail)) {
+                       $this->mail = $mail;
+                       $this->password = $mail;
+               //Without mail
+               } else {
+                       $this->mail = '';
+                       $this->password = '';
+               }
+
+               //Set defaults
+               $this->forename = null;
+               $this->surname = null;
                $this->active = false;
                $this->disabled = false;
+               $this->created = new \DateTime('now');
+               $this->updated = new \DateTime('now');
+
+               //Set collections
                $this->groups = new ArrayCollection();
        }
 
@@ -90,12 +118,24 @@ class User implements UserInterface, \Serializable {
        /**
         * Set mail
         *
-        * @param string $mail
-        *
+        * @param ?string $mail
         * @return User
         */
-       public function setMail(string $mail) {
-               $this->mail = $mail;
+       public function setMail(?string $mail): User {
+               //With mail
+               if ($mail !== null && !empty($mail)) {
+                       //Set mail
+                       $this->mail = $mail;
+
+                       //Without password
+                       if (empty($this->password)) {
+                               //Set mail as password
+                               $this->password = $mail;
+                       }
+               //Without mail
+               } else {
+                       $this->mail = '';
+               }
 
                return $this;
        }
@@ -105,40 +145,18 @@ class User implements UserInterface, \Serializable {
         *
         * @return string
         */
-       public function getMail(): ?string {
+       public function getMail(): string {
                return $this->mail;
        }
 
-       /**
-        * Set pseudonym
-        *
-        * @param string $pseudonym
-        *
-        * @return User
-        */
-       public function setPseudonym(string $pseudonym) {
-               $this->pseudonym = $pseudonym;
-
-               return $this;
-       }
-
-       /**
-        * Get pseudonym
-        *
-        * @return string
-        */
-       public function getPseudonym(): ?string {
-               return $this->pseudonym;
-       }
-
        /**
         * Set forename
         *
-        * @param string $forename
+        * @param ?string $forename
         *
         * @return User
         */
-       public function setForename(string $forename) {
+       public function setForename(?string $forename): User {
                $this->forename = $forename;
 
                return $this;
@@ -147,7 +165,7 @@ class User implements UserInterface, \Serializable {
        /**
         * Get forename
         *
-        * @return string
+        * @return ?string
         */
        public function getForename(): ?string {
                return $this->forename;
@@ -156,11 +174,11 @@ class User implements UserInterface, \Serializable {
        /**
         * Set surname
         *
-        * @param string $surname
+        * @param ?string $surname
         *
         * @return User
         */
-       public function setSurname(string $surname) {
+       public function setSurname(?string $surname): User {
                $this->surname = $surname;
 
                return $this;
@@ -169,7 +187,7 @@ class User implements UserInterface, \Serializable {
        /**
         * Get surname
         *
-        * @return string
+        * @return ?string
         */
        public function getSurname(): ?string {
                return $this->surname;
@@ -182,8 +200,14 @@ class User implements UserInterface, \Serializable {
         *
         * @return User
         */
-       public function setPassword(string $password) {
-               $this->password = $password;
+       public function setPassword(?string $password): User {
+               //With password
+               if ($password !== null && !empty($password)) {
+                       $this->password = $password;
+               //Without password
+               } else {
+                       $this->password = '';
+               }
 
                return $this;
        }
@@ -195,7 +219,7 @@ class User implements UserInterface, \Serializable {
         *
         * @return string
         */
-       public function getPassword(): ?string {
+       public function getPassword(): string {
                return $this->password;
        }
 
@@ -206,7 +230,7 @@ class User implements UserInterface, \Serializable {
         *
         * @return User
         */
-       public function setActive(bool $active) {
+       public function setActive(bool $active): User {
                $this->active = $active;
 
                return $this;
@@ -228,7 +252,7 @@ class User implements UserInterface, \Serializable {
         *
         * @return User
         */
-       public function setDisabled(bool $disabled) {
+       public function setDisabled(bool $disabled): User {
                $this->disabled = $disabled;
 
                return $this;
@@ -250,7 +274,7 @@ class User implements UserInterface, \Serializable {
         *
         * @return User
         */
-       public function setCreated(\DateTime $created) {
+       public function setCreated(\DateTime $created): User {
                $this->created = $created;
 
                return $this;
@@ -272,7 +296,7 @@ class User implements UserInterface, \Serializable {
         *
         * @return User
         */
-       public function setUpdated(\DateTime $updated) {
+       public function setUpdated(\DateTime $updated): User {
                $this->updated = $updated;
 
                return $this;
@@ -290,7 +314,7 @@ class User implements UserInterface, \Serializable {
        /**
         * Set civility
         */
-       public function setCivility(Civility $civility) {
+       public function setCivility(Civility $civility): User {
                $this->civility = $civility;
 
                return $this;
@@ -306,7 +330,7 @@ class User implements UserInterface, \Serializable {
        /**
         * Add group
         *
-        * @param \Rapsys\UserBundle\Entity\Group $group
+        * @param Group $group
         *
         * @return User
         */
@@ -319,7 +343,7 @@ class User implements UserInterface, \Serializable {
        /**
         * Remove group
         *
-        * @param \Rapsys\UserBundle\Entity\Group $group
+        * @param Group $group
         */
        public function removeGroup(Group $group) {
                $this->groups->removeElement($group);
@@ -328,7 +352,7 @@ class User implements UserInterface, \Serializable {
        /**
         * Get groups
         *
-        * @return \Doctrine\Common\Collections\ArrayCollection
+        * @return ArrayCollection
         */
        public function getGroups(): ArrayCollection {
                return $this->groups;
@@ -396,15 +420,27 @@ class User implements UserInterface, \Serializable {
                return $this->mail;
        }
 
+       /**
+        * {@inheritdoc}
+        */
+       public function getUserIdentifier(): string {
+               return $this->mail;
+       }
+
        /**
         * {@inheritdoc}
         */
        public function eraseCredentials(): void {}
 
+       /**
+        * {@inheritdoc}
+        */
        public function serialize(): string {
                return serialize([
                        $this->id,
                        $this->mail,
+                       $this->forename,
+                       $this->surname,
                        $this->password,
                        $this->active,
                        $this->disabled,
@@ -413,10 +449,15 @@ class User implements UserInterface, \Serializable {
                ]);
        }
 
+       /**
+        * {@inheritdoc}
+        */
        public function unserialize($serialized) {
                list(
                        $this->id,
                        $this->mail,
+                       $this->forename,
+                       $this->surname,
                        $this->password,
                        $this->active,
                        $this->disabled,
@@ -428,7 +469,8 @@ class User implements UserInterface, \Serializable {
        /**
         * Check if account is activated
         *
-        * @xxx was from deprecated AdvancedUserInterface, see if it's used anymore
+        * It was from deprecated AdvancedUserInterface, see if it's used anymore
+        *
         * @see vendor/symfony/security-core/User/AdvancedUserInterface.php
         */
        public function isActivated(): bool {
@@ -438,7 +480,8 @@ class User implements UserInterface, \Serializable {
        /**
         * Check if account is disabled
         *
-        * @xxx was from deprecated AdvancedUserInterface, see if it's used anymore
+        * It was from deprecated AdvancedUserInterface, see if it's used anymore
+        *
         * @see vendor/symfony/security-core/User/AdvancedUserInterface.php
         */
        public function isDisabled(): bool {
@@ -448,7 +491,7 @@ class User implements UserInterface, \Serializable {
        /**
         * {@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
@@ -456,6 +499,22 @@ class User implements UserInterface, \Serializable {
                }
        }
 
+       /**
+        * 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
         *