PHPackages                             autologic-web/redirect-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. [Utility & Helpers](/categories/utility)
4. /
5. autologic-web/redirect-bundle

ActiveSymfony-bundle[Utility & Helpers](/categories/utility)

autologic-web/redirect-bundle
=============================

A Symfony bundle for handling redirection

0.2.3(7y ago)410.9k↓33.3%3MITPHPPHP ^5.6|^7.0

Since Oct 16Pushed 7y ago5 watchersCompare

[ Source](https://github.com/autologic-web/redirect-bundle)[ Packagist](https://packagist.org/packages/autologic-web/redirect-bundle)[ RSS](/packages/autologic-web-redirect-bundle/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (6)Versions (9)Used By (0)

Symfony Redirect Bundle
=======================

[](#symfony-redirect-bundle)

[![Build Status](https://camo.githubusercontent.com/a603b9b31c593b366141bc4f14a5484bc9118ab10222e7bc709250aa9eb30a26/68747470733a2f2f7472617669732d63692e6f72672f6175746f6c6f6769632d7765622f72656469726563742d62756e646c652e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/autologic-web/redirect-bundle) [![StyleCI](https://camo.githubusercontent.com/4d61b5a39d0c2e8399cb471cc5f250e7a11164c496e6a159aa2d2a31e7605ca3/68747470733a2f2f7374796c6563692e696f2f7265706f732f3130363731333436372f736869656c643f6272616e63683d6d6173746572)](https://styleci.io/repos/106713467) [![Maintainability](https://camo.githubusercontent.com/a9d036b4bc6dcb77cffc40b23e9bd53ea834178e1f3d96dda3e0315431760847/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f33353064376433323765343734393730633636652f6d61696e7461696e6162696c697479)](https://codeclimate.com/github/autologic-web/redirect-bundle/maintainability) [![Test Coverage](https://camo.githubusercontent.com/8c1c7ea54de000329e5498f2e94f98f7c2fe97eae7882447ebb00d15853c131d/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f33353064376433323765343734393730633636652f746573745f636f766572616765)](https://codeclimate.com/github/autologic-web/redirect-bundle/test_coverage)

Configure redirections after a migration or structural changes to your app/website.

It catches exception events, if they are of type `NotFoundHttpException` it will look for a configured rule and return a `RedirectResponse` response to redirect the user.

Works for Symfony ^2.7, ^3.0 or ^4.0 with PHP ^5.6 or ^7.0

It's been designed to be as unobtrusive as possible since the need to do this sort of thing is often temporary - Google recommends leaving them in place for a year. Just include the bundle and add a block of configuration for your redirect rules.

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

[](#installation)

Install via Composer

```
$ composer require autologic-web/redirect-bundle
```

Symfony < 4
--------------

[](#symfony--4)

Include the bundle in `AppKernel.php`

```
# app/AppKernel.php

/**
 * Class AppKernel
 */
class AppKernel extends Kernel
{
    /**
     * @return array
     */
    public function registerBundles()
    {
        $bundles = [
            // All your bundles

            new Autologic\Bundle\RedirectBundle\AutologicRedirectBundle(),
        ];

        return $bundles;
    }
}
```

Symfony 4
---------

[](#symfony-4)

Include the bundle in `bundles.php`

```
# config/bundles.php

return [
    // All your bundles

    Autologic\Bundle\RedirectBundle\AutologicRedirectBundle::class => ['all' => true],
];
```

Configuration
-------------

[](#configuration)

### Basic Usage

[](#basic-usage)

```
# app/config.yml

autologic_redirect:
  rules:
    - { pattern: '/old-route/', redirect: 'domain.com/new-route' }
```

### `pattern` (string, required)

[](#pattern-string-required)

Use regular expressions to match the full URI being requested. The service catches 404 exceptions, uses `preg_match` to find a rule matching the missing page's URI before throwing the 404 in the event it cannot match.

### `redirect` (string, required)

[](#redirect-string-required)

The fully qualified redirect URI. The bundle will set the protocol (http/https) based on the incoming original request so it ports from dev to prod easily.

### `status` (int, optional)

[](#status-int-optional)

Set the status code (**default: 301**) for the redirection. Tip: use 302 while debugging to avoid 301 permanent redirects from being cached in the browser.

### `forwarding` (bool, optional)

[](#forwarding-bool-optional)

Append the original route to the redirection (**default: false**). Useful in the case that other services/applications have their own redirect logic in place or route structure is the same on a different domain or path.

### `absolute` (bool, optional)

[](#absolute-bool-optional)

Force absolute or relative redirects (**default: null/auto**). If left unset, it will detect a hostname in the redirect and either use the original request host if the redirect does not contain a host or use the redirect verbatim if it does.

### `protocol` (string, optional)

[](#protocol-string-optional)

Force the redirect protocol (**default: null/auto**). If left unset, it will detect the protocol from the original request and use that.

### Other Examples

[](#other-examples)

```
# app/config.yml

autologic_redirect:
  rules:
    # custom status code
    - { pattern: '/old-route/', redirect: 'domain.com/new-route', status: 302 }
    # forwarding: this will redirect to domain.com/new-route/old-route
    - { pattern: '/old-route/', redirect: 'domain.com/new-route', forwarding: true }
    # absolute: will force relative or absolute redirects
    # if false it will redirect to the route on the current host
    - { pattern: '/old-route/', redirect: '/new-route', absolute: false }
    # protocol: will force the protocol
    - { pattern: '/old-route/', redirect: '/new-route', protocol: 'ftp://' }
    # priority: this first rule will match first when a user visits /old-route/sub-route, the second acting as a fallback
    - { pattern: '/.*old-route\/sub-route', redirect: 'domain.com/new-route/sub-route' }
    - { pattern: '/.*old-route/', redirect: 'domain.com/new-route' }
    # match subdomains and more complex patterns and use parameters
    - { pattern: '/au\..+?\.[^\/]+.*blog\/old-australian-blog-post-on-any-domain-of-subdomain/',
        redirect: 'au.%base_domain%/news/new-australian-news-article' }
```

Logging
-------

[](#logging)

To enable logging of unmatched 404 errors, just inject a logger into the listener service in your services.yml:

```
# app/services.yml

services:
  autologic_redirect.event.redirect_listener:
    class: Autologic\Bundle\RedirectBundle\Event\RedirectListener
    arguments:
      - '@autologic_redirect.service.redirect_service'
      - '@logger'
    tags:
      - { name: kernel.event_listener, event: kernel.exception }
```

This will log at `notice` level to help sniff out 404s that don't have any redirection rules in place.

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity28

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~65 days

Recently: every ~82 days

Total

6

Last Release

2808d ago

PHP version history (3 changes)0.1.0PHP ^7.0

0.2.0PHP ^5.6 || ^7.0

0.2.1PHP ^5.6|^7.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/24142e4625810d480bfecbe0cc8b5375051bcadc9ebd614c3ff66665f2a275c2?d=identicon)[matt-halliday](/maintainers/matt-halliday)

---

Tags

exception-handlingredirectsseosymfony-bundle

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/autologic-web-redirect-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/autologic-web-redirect-bundle/health.svg)](https://phpackages.com/packages/autologic-web-redirect-bundle)
```

###  Alternatives

[codefog/contao-haste

haste extension for Contao Open Source CMS

42650.8k139](/packages/codefog-contao-haste)[codefog/contao-news_categories

News Categories bundle for Contao Open Source CMS

3183.3k6](/packages/codefog-contao-news-categories)[netgen/content-browser

Netgen Content Browser is a Symfony bundle that provides an interface which selects items from any kind of backend and returns the IDs of selected items back to the calling code.

14112.1k8](/packages/netgen-content-browser)[robole/sulu-ai-translator-bundle

Translate any type of content using DeepL

181.3k](/packages/robole-sulu-ai-translator-bundle)[numero2/contao-storelocator

Contao Plugin for managing stores (or in common address data) and providing a frontend-search based on geo data

121.5k](/packages/numero2-contao-storelocator)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)