softspring/user-bundle

A complete user bundle

v5.5.7 2025-10-20 13:28 UTC

Requires

• php: >=8.1
• ext-json: *
• doctrine/doctrine-bundle: ^2.10
• doctrine/orm: ^3.3 | ^4.0
• softspring/crudl-controller: ^5.5
• softspring/doctrine-paginator: ^5.5
• softspring/doctrine-query-filters: ^5.5
• softspring/doctrine-target-entity-resolver: ^5.5
• softspring/events: ^5.5
• softspring/mime-translatable: ^5.5
• softspring/permissions-bundle: ^5.5
• softspring/twig-extra-bundle: ^5.5
• symfony/http-foundation: ^5.4|^6.0|^7.0
• symfony/http-kernel: ^5.4|^6.0|^7.0
• symfony/security-bundle: ^5.4|^6.0|^7.0
• symfony/translation: ^5.4|^6.0|^7.0
• symfony/twig-bundle: ^5.4|^6.0|^7.0
• symfony/validator: ^5.4|^6.0|^7.0
• symfony/yaml: ^5.4|^6.0|^7.0

Requires (Dev)

• doctrine/doctrine-fixtures-bundle: ^3.4
• fakerphp/faker: ^1.21
• friendsofphp/php-cs-fixer: ^3.68
• hwi/oauth-bundle: ^2.0
• phpstan/phpstan: ^1.10
• rector/rector: ^1.0
• softspring/account-bundle: ^5.5
• softspring/doctrine-templates: ^5.5
• softspring/mailer-bundle: ^5.5
• softspring/media-bundle: ^5.5
• symfony/browser-kit: ^5.4|^6.0|^7.0
• symfony/css-selector: ^5.4|^6.0|^7.0
• symfony/dom-crawler: ^5.4|^6.0|^7.0
• symfony/form: ^5.4|^6.0|^7.0
• symfony/http-client: ^5.4|^6.0|^7.0
• symfony/mailer: ^5.4|^6.0|^7.0
• symfony/phpunit-bridge: ^5.4|^6.0|^7.0

Suggests

• hwi/oauth-bundle: Integrate oauth clients
• softspring/mailer-bundle: Integrates with softspring's mailer bundle
• softspring/media-bundle: Stores media files for avatars

AGPL-3.0-or-later

README

A complete user bundle for Symfony applications, including user authentication flows, settings pages, invitations, and admin user management screens.

Armonic

This package is part of Armonic.

Documentation

Armonic Documentation

Optional Google Identity Platform Login

This bundle can render Google Sign-In on the login page and sync users with Google Identity Platform.

The feature is optional.

1. Add the optional fields to your user entity

Use the trait and interface only if you enable this feature.

use Softspring\UserBundle\Entity\GoogleIdentityPlatformTrait;
use Softspring\UserBundle\Model\GoogleIdentityPlatformAwareInterface;

class User extends UserModel implements GoogleIdentityPlatformAwareInterface
{
    use GoogleIdentityPlatformTrait;
}

You will usually also want these existing optional contracts:

• UserIdentifierEmailInterface
• NameSurnameInterface
• UserLastLoginInterface
• UserAvatarInterface
• ConfirmableInterface

2. Import the routes you want to expose

Create a dedicated route import in your application:

_sfs_user_google_identity_platform:
    resource: '@SfsUserBundle/config/routing/login_google_identity_platform.yaml'
    prefix: /auth/google

With that prefix, the callback URL will be /auth/google/callback.

3. Enable the feature in sfs_user

sfs_user:
    login:
        google_identity_platform:
            enabled: true
            client_id: '%env(default::GOOGLE_CLIENT_ID)%'
            api_key: '%env(default::IDENTITY_PLATFORM_API_KEY)%'
            tenant_id: '%env(default::IDENTITY_PLATFORM_TENANT_ID)%'
            success_route: app_home
            failure_route: sfs_user_login

4. Configure Google

The Google OAuth web client must allow:

• your login origin, for example https://example.test
• the callback URL from the imported route, for example https://example.test/auth/google/callback

The client_id must be a Google web client id ending with .apps.googleusercontent.com.

Notes

• The login page only renders the Google widget when the feature is enabled.
• If the routes are not imported, the login page shows a warning instead of rendering a broken button.
• The backend exchange uses IDENTITY_PLATFORM_API_KEY.
• tenant_id is optional.

Contributing

See CONTRIBUTING.md.

Report issues and send Pull Requests

Security

See SECURITY.md.

License

This package is free and released under the AGPL-3.0 license.