Download domain-8.x-1.0-alpha9.tar.gztar.gz 120.3 KB
MD5: db27959da85c96de760a6395d24b98c2
SHA-1: 228a3d9238658d29b37bce9917e3a11b6144a05b
SHA-256: d7142b9f1b6418816e9a51a5d75f32b7783e5b2f5684dd8648c1a32b171cb720
Download domain-8.x-1.0-alpha9.zipzip 224.62 KB
MD5: 1bff4ef2d4de7abd9ccf81a6f78e6b39
SHA-1: 874f822732f90400ffdc817f9bcfc5a16670d955
SHA-256: 49c520c36aa44199397d23c1b67a0e4f4c674ba17b11cad0f5d2e763ed66715a
Install with Composer: $ composer require 'drupal/domain:^1.0'
Using Composer to manage Drupal site dependencies

Release info

Created by: agentrickard
Created on: 23 Apr 2017 at 18:38 UTC
Last updated: 1 Dec 2017 at 18:53 UTC
Core compatibility: 8.x
Release type: Bug fixes, New features

Release notes

This release adds the concept of Aliased Environments for development. Each domain alias can now be assigned to an environment group. The default set of environments are:

- default
- local
- development
- staging
- testing

When re-writing links, the environment will be used to find matching sets across your aliases. That means that working in example.local will write links to one.example.local if both aliases are assigned to the 'local' environment set.

The use of environments is entirely optional. The 'default' environment will be assigned to all existing aliases. When reading from the 'default' environment, no links are rewritten.

When editing a domain alias, the list of current environments is also shown.

See the information under Development Workflow in the Domain Alias file.

To use this new feature, your sire's services.yml must be configured with as a required cache context.

To do so, clone to services.yml (if you have not already done so) and change the required_cache_contexts value to:

    required_cache_contexts: ['languages:language_interface', 'theme', 'user.permissions', '']


This release includes settings and schema changes for Domain Alias. An update is provided and only required if you use that module.

API changes

- Aliases now have environments, and can be looked up by environment.
- Domains now have a 'canonical' property which indicated the base hostname. The canonical is used for text representations of the domain hostname in the UI, as the hostname may be overwritten by Domain Alias.

Issues fixed

  • Adds warnings and descriptions to permissions.
  • Validation fails when changing the domain machine name
  • Delete system actions on domain delete.
  • Clarifies handling of translation permissions.
  • Update links to use canonical hostname.
  • Adds canonical hostnames for use with aliases.
  • Adds tests for alias-based environment loading.
  • Issue #2866259: Trusted host pattern example in the readme file does not work by vasi1186: Trusted host pattern example in the readme file does not work
  • Show alias table on form.
  • Easier handling of domain alias environments.
  • Adds method for finding matching alias per environment.
  • Adds new field schema to domain_alias entities.
  • Implement hook_requirements for Domain Content.


The selected release is the release that will be used for automated testing. Optional projects are only used for testing.


No required projects


No optional projects