Symfony bundle that provides services to find broken link URLs.

Installs: 1 394

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 3

Forks: 0


1.2.1 2014-04-28 11:59 UTC

This package is not auto-updated.

Last update: 2020-07-06 06:11:22 UTC


Symfony bundle that provides services to find broken link URLs.


Step 1: Add to composer.json

"require":  {

Step 2: Enable the bundle

Enable the bundle in the kernel:

// app/AppKernel.php

public function registerBundles()
    $bundles = array(
        // ...
        new Astina\Bundle\DeadlinkBundle\AstinaDeadlinkBundle(),


The bundle provides a command (astina:deadlink:check) that checks so called "link sources" for broken links and dispatches a BrokenLinksEvent if one or more broken links are found for a given source.

To create a link source:

  1. Create a class that implements Astina\Bundle\DeadlinkBundle\Link\LinkSourceInterface.
  2. Configure that class as a service and tag it as astina_deadlink.link_source.

To react to broken links:

  1. Create an event listener.
  2. Listen to the astina_deadlink.broken_links event.


<service id="deadlink_listener" class="Acme\FooBundle\DeadlinkListener">
    <tag name="kernel.event_listener" event="astina_deadlink.broken_links" method="onBrokenLinks" />
namespace Acme\FooBundle;

use Astina\Bundle\DeadlinkBundle\Event\BrokenLinksEvent;

class DeadlinkListener
    public function onBrokenLinks(BrokenLinksEvent $event)
        // ZOMG!

This bundle comes with a LoggingListener which logs broken links. In the logger config you can then decide what to do with the log message.


        class: Astina\Bundle\DeadlinkBundle\Event\LoggingListener
            - @logger
            - critical # log broken links as critical message
            - { name: kernel.event_listener, event: astina_deadlink.broken_links, method: onBrokenLinks }

Find broken links:

Run the astina:deadlink:check command to check all registered link sources for broken links. If a broken link is found, the astina_deadlink.broken_links event is dispatched.

####DoctrineLinkSource If you have are using Doctrine and have an Entity or Document that contain URLs (or text that contains URLs) you can use Astina\Bundle\DeadlinkBundle\Doctrine\DoctrineLinkSource and configure a service like this:

        class: Astina\Bundle\DeadlinkBundle\Doctrine\DoctrineLinkSource
            - @doctrine
            - AcmeFooBundle:MyEntity
            - [ text, lead ] # properties of the given entity that contain URLs
            - [] # optional: array of criteria to filter the entities
            - { name: astina_deadlink.link_source }