activecollab / user
User interface
Requires
- php: >=8.0
- activecollab/humannameparser: ^1.0
- activecollab/object: ^1.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^2.0
- phpunit/phpunit: ^9.0
README
User interface describes a single user:
- ID (if available),
- First name,
- Last name,
- Email address.
First and last name can be parsed from full name, or full name can be assembled from first and last name, depending on strategy that you select for implementation.
Identified and Unidentified Visitors
This library offers two solid classes: ActiveCollab\User\UnidentifiedVisitor
is a visitor that we know nothing about, and ActiveCollab\User\IdentifiedVisitor
which describe a single user who announces their identity by providing their email address and optionally full name.
$user = new ActiveCollab\User\IdentifiedVisitor('Ilija Studen', 'ilija@example.com'); print $user->getFirstName() . "\n"; print $user->getLastName() . "\n"; print $user->formatName(ActiveCollab\User\UserInterface::NAME_INITIALS) . "\n";
Users with Accounts
If the app has a concept of users with accounts, these classes should implement ActiveCollab\User\UserInterface
and provide access to required properties:
- User ID,
- User's email address,
- User's first and last name or full name.
Depending on what you have stored for #3, you can use one of the two traits to get most of the UserInterface implementation pasted to your user classes:
ActiveCollab\User\UserInterface\ImplementationUsingFirstAndLastName
ActiveCollab\User\UserInterface\ImplementationUsingFullName
Serialization
All instances that implement ActiveCollab\User\UserInterface
can be serialized to JSON:
$user = new ActiveCollab\User\IdentifiedVisitor('Ilija Studen', 'ilija@example.com'); print_r(json_decode(json_encode($user), true));
will output:
(
[id] => 0
[class] => ActiveCollab\User\IdentifiedVisitor
[first_name] => Ilija
[last_name] => Studen
[full_name] => Ilija Studen
[email] => ilija@example.com
)
Comparing Users
UserInterface::is()
method is handy when you need to check if a particular user instance is the same person as another instance:
$user1 = new ActiveCollab\User\IdentifiedVisitor('John Doe', 'john@example.com'); $user2 = new ActiveCollab\User\IdentifiedVisitor('Jane Doe', 'jane@example.com'); if ($user1->is($user2)) { print "Same person\n"; } else { print "Not the same person\n"; }
Users with accounts (ID > 0) are compared by their ID, and visitors without an account are compared by their email address. Comparisons are not mixed, so user with account will never be identified as visitor, even when their email addresses match.