Download the PHP package sulaimanmisri/easy-login without Composer
On this page you can find all versions of the php package sulaimanmisri/easy-login. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download sulaimanmisri/easy-login
More information about sulaimanmisri/easy-login
Files in sulaimanmisri/easy-login
Package easy-login
Short Description A simple Laravel Social Login for your Laravel application.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package easy-login
Easy Login for Laravel Application
Easy Login is a Laravel package designed to simplify OAuth authentication using Laravel Socialite. It provides pre-built success/failed mechanism, routes and streamlined configuration to integrate third-party OAuth providers effortlessly.
Installation
-
Install the package via Composer
-
Run the installation wizard:
- Configure your OAuth credentials in .env. Example:
[!IMPORTANT] You should only change the {provider} name to the specific provider that you choose. For example, if you choose
/auth/facebook/callback
That's it for the installation. You can use it in your application right now.
Usage
You can modify the post-login redirect paths in the config/easy-login.php file:
After you finish the installation and modify the easy-login config, you can use the pre-defined route in your own html button. Like this :
or
List of pre-defined Route Names
- easy-login.github
- easy-login.google
- easy-login.facebook
- easy-login.twitter
- easy-login.azure
- easy-login.linkedin
- easy-login.slack
- easy-login.bitbucket
- easy-login.gitlab
- More to coming!
Auth Session
This package comes with Success and Failed login mechanisms. When a user tries to login via any selected Social Login and their email is not found in your DB, they will be redirected to the path set in the config, where you can display a custom message.
You can change the Success and Failed Messages by modifying the error value inside the config/easy-login.php file:
- For Success session, use
easy-successas the key - For Failed session, use
easy-erroras the key
Example:
Key Features
1. Seamless Integration with Laravel Socialite
Easily connect your application to providers like GitHub, Google, and more through Laravel Socialite.
2. Simple Configuration
Manage OAuth providers in a single configuration file.
3. Pre-Built Routes
Automatically provides routes for:
- Redirecting to OAuth providers (e.g., GitHub)
- Handling authentication callbacks
4. Customizable Behavior
Extend or override the config data or callback logic easily using the CallbackServices class.
Contributing
Feel free to contribute to this package by submitting issues or pull requests. Follow the standard coding guidelines for consistency.
Developer Customization
You might want to use Easy Login as your primary Social Login, but the provider is not there. You can contribute to this Package too! By default, you need to follow other Provider Redirection inside the EasyLoginController.
But, if you find that the provider you want is not supported by Laravel Socialite by default, you can create a custom Controller by naming the file like so : EasyLoginForWhatProviderNameController. Change the WhatProviderName to your own provider name. Eg : EasyLoginForMySpaceController
Then, create a Service file inside the Services and follow the naming convention. Like so : YourProviderServices.
To use the EasyLoginServices interface, implement it in your services class and provide concrete implementations for the required methods. Your services must implement the EasyLoginServices.
Coding Standards
To maintain consistency and quality across the codebase, please adhere to the following coding standards when contributing to this project.
1. Strict Typing
- Always declare strict_types=1 at the top of every PHP file.
- Use return type declarations for all methods.
- Use type hints for all method parameters.
2. Namespace and Class Naming
- Follow PSR-4 autoloading standards.
- Follow PSR-12 coding style guidelines.
- Use PascalCase for class and interface names.
- Namespaces should match the directory structure.
3. Method Naming
- Use camelCase for method names.
- Method names should be descriptive and reflect their purpose.
4. Comments and Documentation
- Use PHPDoc blocks to document all classes, methods, and properties.
- Include a description, parameter details, return types, and exceptions (if any).
- Keep comments concise but informative. Or at least a room for the code to "breath"
5. Commit Messages
- Use clear and descriptive commit messages.
- Follow the Conventional Commits format:
Final Notes
By following these coding standards, we can ensure that the codebase remains clean, consistent, and easy to maintain. If you have any questions or need clarification, feel free to open an issue or reach out to the maintainers.
