From 4f5ea503c1a4ecb0a165bf6f130b567990120e1a Mon Sep 17 00:00:00 2001
From: klunejko <konrad@klunejko.net>
Date: Thu, 13 Mar 2025 19:39:03 +0100
Subject: [PATCH] Updated Function Runtime Documentation for Symfony

Updated Function Runtime documentation and added missing information for integrating with Symfony.
---
 docs/runtimes/function.mdx | 37 +++++++++++++++++++++++++++++++++++--
 1 file changed, 35 insertions(+), 2 deletions(-)

diff --git a/docs/runtimes/function.mdx b/docs/runtimes/function.mdx
index 3f6e73d15..ebcbc11c9 100644
--- a/docs/runtimes/function.mdx
+++ b/docs/runtimes/function.mdx
@@ -158,14 +158,47 @@ It is also possible to directly define PHP classes as AWS Lambda handlers.
                 handler: MyApp\Handler
         ```
     </Tab>
-    <Tab>
-        Set the class name as the `handler` and Bref will retrieve that class from Symfony's service container.
+    <Tab>        
+        Create a file that returns the Symfony Kernel (MUST be located at `public/index.php`)
+        ```php filename="public/index.php"
+        <?php 
+
+        use App\Kernel;
+        
+        require __DIR__ . '/vendor/autoload.php';
+        
+        return function () {
+            return new Kernel(
+                debug: (bool) $_SERVER['APP_DEBUG'],
+                environment: $_SERVER['APP_ENV'],
+            );
+        };
+        ```
+
+        Next, set the class name as the `handler` and Bref will retrieve that class from Symfony's service container.
 
         ```yml filename="serverless.yml"
         functions:
             hello:
                 handler: MyApp\Handler
         ```
+
+        Make sure the handler has been registered as public or you will get an error that the service or alias has been removed.
+        ```diff filename="src/Handler.php"
+        namespace App;
+
+        use Bref\Context\Context;
+        + use Symfony\Component\DependencyInjection\Attribute\Autoconfigure;
+        
+        + #[Autoconfigure(public: true)]
+        class Handler implements \Bref\Event\Handler
+        {
+            public function handle($event, Context $context): string
+            {
+                // ...
+            }    
+        }
+        ```        
     </Tab>
     <Tab>
         To achieve that, you must integrate Bref with your framework's Dependency Injection Container.