Download the PHP package genealabs/laravel-socialiter without Composer

Socialiter for Laravel

Supporting This Package

This is an MIT-licensed open source project with its ongoing development made possible by the support of the community. If you'd like to support this, and our other packages, please consider sponsoring us via the button above.

We thank the following sponsors for their generosity, please take a moment to check them out:

• LIX

Table of Contents

• Requirements
• Installation
• Implementation

Requirements

• PHP 8.2, 8.3, 8.4, 8.5
• Laravel 11.x, 12.x, 13.x
• Socialite 5.3+

Installation

1. Install the composer package:

2. Add the social credentials table:

   To prevent automatic migrations from running (for example if you have a different migration setup, like multi-tenancy, etc.), add the following entry to your app's service provider:

   And then publish the migration files and manipulate them as needed:

3. Update the user model:

Custom Registration

By default, Socialiter creates new users with just their name, email, and a random password. If you need to customize how users are created (for example, to set additional attributes or use a custom creation flow), register a callback in your AppServiceProvider:

The callback receives the raw Socialite user object and must return a persisted User model instance. If no callback is registered, the default behavior is used. You can reset to default at any time with Socialiter::createUsersUsingDefault().

Note: The custom callback is only invoked when creating a new user. If an existing user with the same email is found, Socialiter links the social credentials to that user without invoking the callback.

Implementation

The following is an example controller implementation using the "Sign in with Apple" driver:

Commitment to Quality

During package development I try as best as possible to embrace good design and development practices, to help ensure that this package is as good as it can be. My checklist for package development includes:

• ✅ Achieve as close to 100% code coverage as possible using unit tests.
• ✅ Eliminate any issues identified by SensioLabs Insight and Scrutinizer.
• ✅ Be fully PSR1, PSR2, and PSR4 compliant.
• ✅ Include comprehensive documentation in README.md.
• ✅ Provide an up-to-date CHANGELOG.md which adheres to the format outlined at http://keepachangelog.com.
• ✅ Have no PHPMD or PHPCS warnings throughout all code.

Contributing

Please observe and respect all aspects of the included Code of Conduct.

Reporting Issues

When reporting issues, please fill out the included template as completely as possible. Incomplete issues may be ignored or closed if there is not enough information included to be actionable.

Submitting Pull Requests

Please review the Contribution Guidelines. Only PRs that meet all criterium will be accepted.

If you ❤️ open-source software, give the repos you use a ⭐️.

We have included the awesome symfony/thanks composer package as a dev dependency. Let your OS package maintainers know you appreciate them by starring the packages you use. Simply run composer thanks after installing this package. (And not to worry, since it's a dev-dependency it won't be installed in your live environment.)