Download the PHP package knpuniversity/guard without Composer
On this page you can find all versions of the php package knpuniversity/guard. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download knpuniversity/guard
More information about knpuniversity/guard
Files in knpuniversity/guard
Package guard
Short Description Provides Guard-style authentication in Symfony's security component
License MIT
Homepage http://knpuniversity.com
Informations about the package guard
KnpGuard
Add simple and beautiful authentication to Symfony's security component in Silex and anywhere else.
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
That's it! Try it out, and then upgrade to Symfony 3 :).
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.