Install

Using Composer to manage Drupal site dependencies

Alternative installation files

Download tar.gz 271.76 KB
MD5: e6f25ff94827ce0081caccabbb6b94fc
SHA-1: 1764f2b28f75e6e12f4939b0c92b4b2c0f52a9e5
SHA-256: 66100644f535653c3767c1a5589e5c26ee9f8d1222962c448815f26cb5348309
Download zip 481.54 KB
MD5: 4ed4fa416174e9a32219cad2cf98fc11
SHA-1: 00e14ad0b0264d44a3f7232be82d788b8026a076
SHA-256: 75fa009146318595e084d8ae24390ab0d7ae2aa5045ac1bc3880391f7acdb0d2

Release notes

API Orchestrator 1.1.5

Multi-environment architecture overhaul — replaces the old multi-provider system with individual environment entities and URL-based detection.

New Environment Entity System

  • Replaced ApiEnvironmentProvider (textarea-based environment lists) with individual ApiEnvironment config entities
  • Each environment is now a standalone entity with its own label, machine name, URL pattern, weight, and default flag
  • Environments are managed via a dedicated admin list page with add/edit/delete operations
  • Three default environments ship with the module: Development, Test/Stage, and Live/Production

URL-Based Environment Detection

  • Environment detection now works exclusively by matching the current site hostname against each environment's URL pattern
  • URL pattern field is required and validated — must be a valid hostname (e.g. dev.mysite.com), no protocol or path allowed
  • One environment can be marked as default, used when no URL pattern matches (e.g. local development)
  • Removed settings.php / environment variable detection method — simplified to a single, clear approach

Plugin-Based Alert Channels

  • Added a plugin-based alert notification system with NotificationProvider plugin type using PHP attributes
  • Built-in providers: Slack, Discord, and Bearer Token notification channels
  • Configurable alert entities with threshold operators, time windows, cooldown periods, and severity levels

Endpoint Service Overrides

  • Endpoint forms now load environment entities directly for per-environment service overrides
  • Removed the old provider-based environment key resolution
  • Cleaner dropdown selection using environment entity labels

Settings Form Cleanup

  • Removed environment detection settings from the global settings form (detection method, env var name, fallback env var)
  • Removed corresponding config schema and install defaults
  • Environment configuration is now fully managed through the Environments admin tab

Code Quality

  • Added .cspell.json with flagged words for inclusive language checks
  • Hostname validation regex on environment forms prevents invalid URL patterns
  • Default flag management ensures only one environment is marked as default at a time

Notes

  • Breaking change: ApiEnvironmentProvider entities are replaced by ApiEnvironment entities — existing provider configs will need to be recreated as individual environments
  • The environment_provider field on endpoints has been removed — environment detection is now automatic via URL matching
  • Requires Drupal 11 (Drupal 10 support was dropped in this release cycle)
  • All CI checks clean: PHPCS (0), PHPStan (0), ESLint (0), Stylelint (0), CSpell (0)
  • Upgrade from 1.1.4: clear caches after update, then recreate environments via admin UI

Feedback and issue reports welcome at the issue queue.

Created by: levendclk
Created on: 10 Mar 2026 at 16:44 UTC
Last updated: 10 Mar 2026 at 16:46 UTC
Bug fixes
New features

Other releases