surfnet/stepup-bundle

A Symfony 5|6 bundle that holds shared code and framework integration for all Step-up applications.

6.0.17 2024-05-24 13:37 UTC

Requires

• php: ^8.2
• ext-gmp: *
• ext-json: *
• ext-openssl: *
• guzzlehttp/guzzle: ^7.8
• monolog/monolog: ^3
• surfnet/stepup-saml-bundle: ^6.0
• symfony/config: ^5.4|^6.3
• symfony/dependency-injection: ^5.4|^6.3
• symfony/form: ^5.4|^6.3
• symfony/framework-bundle: ^5.4|^6.3
• symfony/http-kernel: ^5.4|^6.3
• symfony/twig-bridge: ^5.4|^6.3
• symfony/validator: ^5.4|^6.3

Requires (Dev)

• mockery/mockery: ^1.5
• overtrue/phplint: *
• phpmd/phpmd: ^2.13
• phpstan/phpstan: ^1.10
• phpstan/phpstan-symfony: ^1.3
• phpunit/phpunit: ^9.6
• sebastian/phpcpd: ^6.0
• slevomat/coding-standard: ^8.13
• squizlabs/php_codesniffer: ^3.7.1
• symfony/phpunit-bridge: ^5.4|^6.3

Apache-2.0

• stepup
• surf
• surf secure id

README

A Symfony 2 and 3 bundle that holds shared code and framework integration for all Step-up applications. See Stepup-Deploy for an overview of Stepup.

Installation

• Add the package to your Composer file (For Symfony 2 support, please use a version constraint "~3.5")

  composer require surfnet/stepup-bundle

• Add the bundle to your kernel in app/AppKernel.php

  public function registerBundles()
  {
      // ...
      $bundles[] = new Surfnet\StepupBundle\SurfnetStepupBundle;
  }

• Copy and adjust the error templates to your application folder

  • src/Resources/views/Exception/error.html.twig → app/Resources/SurfnetStepupBundle/views/Exception/error.html.twig
  • src/Resources/views/Exception/error404.html.twig → app/Resources/SurfnetStepupBundle/views/Exception/error404.html.twig

Install resources

{% stylesheets filter='less'
'@SurfnetStepupBundle/Resources/public/less/stepup.less'
%}
<link href="{{ asset_url }}" type="text/css" rel="stylesheet" media="screen" />
{% endstylesheets %}
{% javascripts
'@SurfnetStepupBundle/Resources/public/js/stepup.js'
%}
<script type="text/javascript" src="{{ asset_url }}"></script>
{% endjavascripts %}

Using the locale switcher

The locale switcher is a form that can be rendered with the help of a Twig function.

{% if app.user %}
    {% set locale_switcher = stepup_locale_switcher('handler_route', ['return-url' => app.request.uri]) %}
    {{ form_start(locale_switcher, { attr: { class: 'form-inline' }}) }}
    {{ form_widget(locale_switcher.locale) }}
    {{ form_widget(locale_switcher.switch) }}
    {{ form_end(locale_switcher) }}
{% endif %}
{% stylesheets filter='less'
'@SurfnetStepupBundle/Resources/public/less/style.less'
%}
<link href="{{ asset_url }}" type="text/css" rel="stylesheet" media="screen" />
{% endstylesheets %}
{% javascripts
'@SurfnetStepupBundle/Resources/public/js/index.js'
%}
<script type="text/javascript" src="{{ asset_url }}"></script>
{% endjavascripts %}

Release strategy

CHANGELOG

The changelog for the bundle is kept in the ./CHANGELOG file. A history of the releases can be found in this file. Previous RMT release notes are kept in this file for history purposes. Please use markdown to style the changelog.

Please update the changelog with any notable changes that are introduced in an upcoming release. If you are not yet certain what the next release number will be, give the release title a generic value like Upcoming release. Make sure before merging the changes to the release branch to update the release title in the changelog.

Example CHANGELOG entry

# 2.5.23
Brief explenation on the major changes of this release

## New features
 * Title of PR of the new feature #30
 * Support of POST binding for AuthnRequest #31
 
## Bugfixes
 * Title of PR of the bugfix #33

## Improvements
 * Title of PR of the improvement #29
 

When releasing a hotfix on a release branch, please update the changelog on the release branch and after releasing the hotfix, also merge the hotfix to develop.