Download the PHP package knpuniversity/guard-bundle without Composer
On this page you can find all versions of the php package knpuniversity/guard-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download knpuniversity/guard-bundle
More information about knpuniversity/guard-bundle
Files in knpuniversity/guard-bundle
Package guard-bundle
Short Description This Bundle provides Guard-style authentication in Symfony
License MIT
Homepage http://knpuniversity.com
Informations about the package guard-bundle
KnpUGuardBundle
Add simple and beautiful authentication to your Symfony project.
This library is deprecated since Symfony 2.8 and won't work with Symfony 3.
The original purpose was to get feedback and use-cases from people so that we can merge this feature into Symfony itself (see symfony/symfony#14673).
Now it's good (see news from Symfony).
Upgrade to Symfony 3
On Symfony 2.8, use the official Guard component.
Step 1 - Remove the library from your composer.json
Be sure to be on Symfony 2.8, open composer.json
file and remove the library:
Before:
Now:
Step 2 - Remove it from your AppKernel
If you're using the Symfony framework, remove the KnpUGuardBundle from AppKernel.php
.
Step 3 - Modify firewall(s)
Open and modify security.yml
file, replace in your firewall(s) key(s) knpu_guard
by guard
:
Before:
Now:
Step 4 - Update Authenticator(s)
Update uses in Authenticator(s) class(es).
Warning: checkCredentials() NOW must return true in order for authentication to be successful. In KnpUGuard, if you did NOT throw an AuthenticationException, it would pass.
Before:
Now:
Step 5 - Yes we can test it
Upgrade to Symfony 3 (won't be worst than from Symfony 1 to Symfony 2) ;-)
- http://symfony.com/doc/current/cookbook/upgrade/major_version.html
- https://knpuniversity.com/screencast/new-symfony-2.2/symfony3
Documentation
Find a full tutorial here: https://knpuniversity.com/screencast/guard
Basic Usage
Check out the Tutorial for real documentation. But here's the basic idea.
Guard works by creating a single class - an authenticator - that handles everything about how you want to authenticate your users. And authenticator implements KnpU\Guard\GuardAuthenticatorInterface)
Here are some real-world examples from the tutorial:
Goal | Code | Tutorial |
---|---|---|
Authenticate by reading an X-TOKEN header |
ApiTokenAuthenticator.php | How to Authenticate via an API Token |
Form login authentication | FormLoginAuthenticator.php | How to Create a Login Form |
Social Login (Facebook) | FacebookAuthenticator.php | Social Login with Facebook |
Contributing
Find a bug or a use-case that this doesn't support? Open an Issue so we can make things better.
License
This library is under the MIT license. See the complete license in the LICENSE file.
All versions of guard-bundle with dependencies
knpuniversity/guard Version ~0.1
symfony/framework-bundle Version ~2.3
symfony/security-bundle Version ~2.6