WARNING: You are browsing the documentation for Symfony 3.0 which is not maintained anymore. Consider upgrading your projects to Symfony 4.2.

The Security Component

3.0 version

Maintained

3.4 4.2 current 4.3 master

Unmaintained

2.7 2.8 3.1 3.2 3.3 4.0 4.1

The Security Component¶

The Security component provides a complete security system for your web application. It ships with facilities for authenticating using HTTP basic or digest authentication, interactive form login or X.509 certificate login, but also allows you to implement your own authentication strategies. Furthermore, the component provides ways to authorize authenticated users based on their roles, and it contains an advanced ACL system.

Installation¶

You can install the component in 2 different ways:

Install it via Composer (symfony/security on Packagist);
Use the official Git repository (https://github.com/symfony/security).

Then, require the vendor/autoload.php file to enable the autoloading mechanism provided by Composer. Otherwise, your application won't be able to find the classes of this Symfony component.

The Security component is divided into four smaller sub-components which can be used separately:

symfony/security-core: It provides all the common security features, from authentication to authorization and from encoding passwords to loading users.
symfony/security-http: It integrates the core sub-component with the HTTP protocol to handle HTTP requests and responses.
symfony/security-csrf: It provides protection against CSRF attacks.
symfony/security-acl: It provides a fine grained permissions mechanism based on Access Control Lists.

Learn More¶

This work, including the code samples, is licensed under a Creative Commons BY-SA 3.0 license.