ZenstruckRedirectBundle

This bundle adds entities for redirects and 404 errors.

For redirects, 404 errors are intercepted and the requested path is looked up. If a match is found it redirects to the found redirect's destination. The count and last accessed date are updated as well. A redirect form type and validation is available as well.

404 errors can be logged as well. Each 404 error is it's own record in the database. The path, full URL, timestamp, and referer are stored. Storing each error as a separate record allows viewing statistics over time and seeing all the referer URLs. When a redirect is created or updated, 404 records that match it's path are deleted.

Installation

Install with composer:

$ composer require zenstruck/redirect-bundle

Enable the bundle: This Step is only needed if you are not using Symfony Flex.

// config/bundles.php return [ // ... ZenstruckRedirectBundleZenstruckRedirectBundle::class => ['all' => true], ];

Configuration

NOTE: A NotFound or Redirect or both must be configured.

Redirect

Create your redirect class inheriting the MappedSuperClass this bundle provides:

namespace AppEntity; use ZenstruckRedirectBundleModelRedirect as BaseRedirect; use DoctrineORMMapping as ORM; /** * @ORMEntity * @ORMTable(name="redirects") */ class Redirect extends BaseRedirect { /** * @ORMId * @ORMColumn(type="integer") * @ORMGeneratedValue(strategy="AUTO") */ private $id; }

Set this class in your zenstruck_redirect.yml:

zenstruck_redirect: redirect_class: AppEntityRedirect

Update your schema (or use a migration):

$ bin/console doctrine:schema:update --force

NotFound

Create your not found class inheriting the MappedSuperClass this bundle provides:

namespace AppEntity; use ZenstruckRedirectBundleModelNotFound as BaseNotFound; use DoctrineORMMapping as ORM; /** * @ORMEntity * @ORMTable(name="not_founds") */ class NotFound extends BaseNotFound { /** * @ORMId * @ORMColumn(type="integer") * @ORMGeneratedValue(strategy="AUTO") */ private $id; }

Set this class in your zenstruck_redirect.yml:

zenstruck_redirect: not_found_class: AppEntityNotFound

Update your schema (or use a migration):

$ bin/console doctrine:schema:update --force

Form Type

This bundle provides a form type (zenstruck_redirect) for creating/editing redirects.

$redirect = // ... $form = $this->createForm('zenstruck_redirect', $redirect);

You may want to disable the source field for already created redirects:

// new action $redirect = new Redirect(); $form = $this->createForm('zenstruck_redirect', $redirect); // edit action $redirect = // get from database $form = $this->createForm('zenstruck_redirect', $redirect, array('disable_source' => true));

Full Default Configuration

zenstruck_redirect: redirect_class: ~ # Required if not_found_class is not set not_found_class: ~ # Required if redirect_class is not set model_manager_name: ~ # When enabled, when a redirect is updated or created, the NotFound entities with a matching path are removed. remove_not_founds: true