senj/dynamic-subdomain-bundle

Symfony3 Dynamic subdomain handler Bundle

1.0.0 2017-02-26 15:53 UTC

This package is not auto-updated.

Last update: 2025-06-21 23:49:16 UTC


README

Install

In composer.json:

"require": {
    "senj/dynamic-subdomain-bundle": "dev-master"
}

In app/AppKernel.php:

$bundles = array(
    # [...]
    new Senj\DynamicSubdomainBundle\SenjDynamicSubdomainBundle(),
    # [...]
);

Configure

In app/config.yaml

senj_dynamic_subdomain:
    base_host: domain.com
    parameter_name: ~
    entity: Acme\DemoBundle\Entity\MySite
    property: ~
  • base_host:

    • The domain base host, where all subdomains are attached
    • required
    • example: domain.com
  • parameter_name:

    • The name of the parameter that will be set on the current Request
    • optional
    • default value: subdomain
  • entity:

    • The class or Doctrine alias of the entity mapped to subdomains
    • required
    • example: Acme\DemoBundle\Entity\MySite
  • property:

    • The name of the property storing the subdomain name in your entity
    • optional
    • default value: subdomain
  • method:

    • The name of method that will be called to get object with the property defined
    • optional
    • default value: findOneBy

Use

  1. Create the entities mapped to your subdomains
  2. Get the current subdomain object through the Symfony Request object

In php, assuming that senj_dynamic_subdomain.property equals subdomain (the default value):

use Symfony\Component\HttpFoundation\Request;

class DefaultController extends Controller {

    public function indexAction(Request $request) {
        $subdomainobject = $request->attributes->get('subdomain');
        var_dump($subdomainobject);
    }

In twig, assuming that senj_dynamic_subdomain.property equals subdomain (the default value), and that the entity mapped to subdomains has a title property:

{{ app.request.attributes.get('subdomain').title }}

Notes

If the subdomain is not found in the database, an exception will be thrown by the Bundle (Symfony\Component\HttpKernel\Exception\NotFoundHttpException).