From 6d90eec0c883a69a87e0ad31d0e8ba617b809057 Mon Sep 17 00:00:00 2001
From: Bernard Hamlin <948122+blueo@users.noreply.github.com>
Date: Wed, 2 Feb 2022 16:03:13 +1300
Subject: [PATCH] DOC Injector syntax docs update (#10221)

---
 .../05_Extending/05_Injector.md               | 38 ++++++++++++++++++-
 1 file changed, 37 insertions(+), 1 deletion(-)

diff --git a/docs/en/02_Developer_Guides/05_Extending/05_Injector.md b/docs/en/02_Developer_Guides/05_Extending/05_Injector.md
index 5ba5cdd70..e22421680 100644
--- a/docs/en/02_Developer_Guides/05_Extending/05_Injector.md
+++ b/docs/en/02_Developer_Guides/05_Extending/05_Injector.md
@@ -141,7 +141,31 @@ SilverStripe\Core\Injector\Injector:
       - [ pushHandler, [ %$DefaultHandler ] ]
 ```
 
-## Using constants as variables
+### Special YML Syntax
+
+You can use the special `%$` prefix in the configuration yml to fetch items via the Injector. For example:
+
+```yml
+App\Services\MediumQueuedJobService:
+    properties:
+      queueRunner: '%$App\Tasks\Engines\MediumQueueAsyncRunner'
+```
+
+It is equivalent of calling `Injector::get()->instance(MediumQueueAsyncRunner::class)` and assigning the result to the `MediumQueuedJobService::queueRunner` property. This can be useful as these properties can easily updated if provided in a module or be changed for unit testing. It can also be used to provide constructor arguments such as [this example from the assets module](https://github.com/silverstripe/silverstripe-assets/blob/1/_config/asset.yml):
+
+```yml
+SilverStripe\Core\Injector\Injector:
+  # Define the secondary adapter for protected assets
+  SilverStripe\Assets\Flysystem\ProtectedAdapter:
+    class: SilverStripe\Assets\Flysystem\ProtectedAssetAdapter
+  # Define the secondary filesystem for protected assets
+  League\Flysystem\Filesystem.protected:
+    class: League\Flysystem\Filesystem
+    constructor:
+      FilesystemAdapter: '%$SilverStripe\Assets\Flysystem\ProtectedAdapter'
+```
+
+## Using constants and environment variables
 
 Any of the core constants can be used as a service argument by quoting with back ticks "`". Please ensure you also quote the entire value (see below).
 
@@ -152,6 +176,18 @@ CachingService:
     CacheDir: '`TEMP_DIR`'
 ```
 
+Environment variables can be used in the same way:
+
+```yml
+App\Services\MyService:
+    class: App\Services\MyService
+    constructor:
+      baseURL: '`SS_API_URI`'
+      credentials:
+        id: '`SS_API_CLIENT_ID`'
+        secret: '`SS_API_CLIENT_SECRET`'
+```
+
 Note: undefined variables will be replaced with null.