qboot / proxy-symfony

redirection.io Proxy for Symfony

RedirectionIO Proxy for Symfony

Symfony Proxy works in combination with redirection.io.

If you don't know what is redirection.io, take the time to make a quick tour on the website.

Before using it, you need:

• a redirection.io account. If you don't have an account, please contact us here.
• a configured redirection.io agent on your server. Please follow the installation guide.

Drop us an email to [e-mail] if you need help or have any questions.

Installation

composer require redirectionio/proxy-symfony

Configuration

Configuration file location

• Symfony framework-standard-edition: app/config/config.yml
• Symfony Flex: config/packages/redirectionio.yaml

Configuration Example

# redirection.io Configuration
redirection_io:
    project_key: 'foo:bar'
    connections:
        agent_tcp: 'tcp://127.0.0.1:20301'
        agent_unix: 'unix:///var/run/redirectionio_agent.sock'

Configuration reference

The following command dump the configuration reference:

bin/console config:dump-reference redirection_io

The following command dump your configuration:

bin/console  debug:config redirection_io

Do not process some requests

You might want to exclude some requests, because you know they will never have some redirections on it, or you don't want log them. It's the case for debug routes for example: /_wdt, /_profiler, and /_error. That's why we ignore theses request by default thanks to their URL prefixes.

Ignore requests by URL prefix

You can add more prefixes to the configuration:

redirection_io:
    excluded_prefixes:
        - /admin
        - /api
        # ...

Ignore requests by Host

redirection_io:
    excluded_hosts:
        - api.example.com
        - admin.example.com
        # - 127.0.0.1
        # ...

Ignore other requests

If you need to do custom code to ignore some requests, you have to implement RedirectionIO\Client\ProxySymfony\CircuitBreaker\CircuitBreakerInterface.

If you are not using the default configuration of Symfony (autowire=true and autoconfigure=true), you will have to register the service and tag it with redirectionio.circuit_breaker.