PHPackages                             dcs/user-core-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Authentication & Authorization](/categories/authentication)
4. /
5. dcs/user-core-bundle

ActiveSymfony-bundle[Authentication & Authorization](/categories/authentication)

dcs/user-core-bundle
====================

The DCSUserCoreBundle is the main part of a set of libraries that help you in the most common tasks for managing users

1123PHP

Since Jan 1Pushed 9y ago1 watchersCompare

[ Source](https://github.com/damianociarla/DCSUserCoreBundle)[ Packagist](https://packagist.org/packages/dcs/user-core-bundle)[ RSS](/packages/dcs-user-core-bundle/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

[![Build Status](https://camo.githubusercontent.com/29154f8297f95589e44edb1f7a7afe98c8e83849e41b8e95ee5397d249847c6f/68747470733a2f2f7472617669732d63692e6f72672f64616d69616e6f636961726c612f44435355736572436f726542756e646c652e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/damianociarla/DCSUserCoreBundle)[![Coverage Status](https://camo.githubusercontent.com/884ebd981e70784ca156dad13c97b7f015db5abb22cd29bce75effee73721620/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f64616d69616e6f636961726c612f44435355736572436f726542756e646c652f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/damianociarla/DCSUserCoreBundle?branch=master)

DCSUserCoreBundle
=================

[](#dcsusercorebundle)

The **DCSUserCoreBundle** is the main part of a set of libraries that help you in the most common tasks for managing users.

It provides the abstraction of operations such as saving, deleting and searching for a single user. As? Through specific events.

**Note:** This bundle does *not* provide the final implementation of the operations but you must add and configure libraries (or create your own) to ensure the execution of commands.

Introduction
------------

[](#introduction)

This bundle offers a number of services which in itself do not develop the entire operating logic, but they need of external services to work.

The list of exposed services is as follows:

- `dcs_user.manager.save`
- `dcs_user.manager.delete`
- `dcs_user.factory`
- `dcs_user.repository`

### Services

[](#services)

##### The managers

[](#the-managers)

The `dcs_user.manager.save` and `dcs_user.manager.delete` services do not perform the save or cancellation but emit a series of the events that can be used to perform the real action.

##### The factory

[](#the-factory)

The `dcs_user.factory` has the task of creating a new user instance.

##### The repository

[](#the-repository)

The `dcs_user.repository` is only an interface that exposes methods for the user's search. It must be implemented as a service and added in the bundle configuration.

### Events

[](#events)

Listeners hooked to events emitted by the various services will always receive an instance of `DCS\User\CoreBundle\Event\UserEvent`.

The complete list of events is within the class `DCS\User\CoreBundle\DCSUserCoreEvents`.

The DCS bundles
---------------

[](#the-dcs-bundles)

Several bundles have been developed that help you perform common tasks for user management:

##### Persistence

[](#persistence)

[DCSUserPersistenceORMBundle](https://github.com/damianociarla/DCSUserPersistenceORMBundle)

This bundle provides you the implementation of the persistence on database using Doctrine ORM. **Requirerment:** DCSUserCoreBundle.

##### Role management

[](#role-management)

[DCSRoleCoreBundle](https://github.com/damianociarla/DCSRoleCoreBundle)

This bundle provides the basic services for the role management. **Requirerment:** DCSUserCoreBundle.

[DCSRoleProviderORMBundle](https://github.com/damianociarla/DCSRoleProviderORMBundle)

This bundle provides you with the management of user roles using Doctrine ORM. **Requirerment:** DCSRoleCoreBundle.

[DCSRoleProviderArrayBundle](https://github.com/damianociarla/DCSRoleProviderArrayBundle)

This bundle provides you with the management of roles having the configuration as an array. **Requirerment:** DCSRoleCoreBundle.

##### Security

[](#security)

[DCSSecurityCoreBundle](https://github.com/damianociarla/DCSSecurityCoreBundle)

This bundle provides the basic services for the management of security. **Requirerment:** DCSUserCoreBundle.

[DCSSecurityAuthFormBundle](https://github.com/damianociarla/DCSSecurityAuthFormBundle)

This bundle provides an authentication system using the login form. **Requirerment:** DCSSecurityCoreBundle.

##### Password reset management

[](#password-reset-management)

[DCSPasswordResetCoreBundle](https://github.com/damianociarla/DCSPasswordResetCoreBundle)

This bundle provides the logic to perform a complete flow of password change request. **Requirerment:** DCSUserCoreBundle, DCSSecurityCoreBundle.

[DCSPasswordResetPersistenceORMBundle](https://github.com/damianociarla/DCSPasswordResetPersistenceORMBundle)

This bundle provides the implementation of the persistence on database using Doctrine ORM of all password requests. **Requirerment:** DCSPasswordResetCoreBundle.

[DCSPasswordResetExplainViewBundle](https://github.com/damianociarla/DCSPasswordResetExplainViewBundle)

This bundle provides the visual display of password recovery services through view and form. **Requirerment:** DCSPasswordResetCoreBundle.

Prerequisites
-------------

[](#prerequisites)

This version of the bundle requires Symfony 2.8+.

Installation
------------

[](#installation)

### Require the bundle

[](#require-the-bundle)

Run the following command:

```
$ composer require dcs/user-core-bundle "~1.0@dev"

```

Composer will install the bundle to your project's `vendor/dcs/user-core-bundle` directory.

### Enable the bundle

[](#enable-the-bundle)

Enable the bundle in the kernel:

```