Bref v3

[mnapoli]

This PR will contain all changes for Bref v3.

This will be a long-running PR, I like to keep this open for months so that we have a place to preview and discuss changes. I do not intend to merge this pull request soon.

This PR goes hand-in-hand with brefphp/aws-lambda-layers#257.

Breaking changes:

• Dropped support for PHP 8.0 and 8.1
• Underlying Linux upgrade -> 99% of projects should not be impacted
• Deployment via containers: need to change because of Refactor to a single layer aws-lambda-layers#256 (docs coming soon)
• The pgsql extension is now enabled by default
• The small bref CLI is removed, this was already stripped down with the v2 upgrade and could only set up new projects. That built-in CLI is no longer needed. It is replaced by serverless CLI commands and the bref external CLI (https://github.com/brefphp/cli).

All changes:

• Support PHP 8.5 #1988
• Remove support for PHP 8.0 and 8.1 in Bref v3 #1954
• Refactor to a single layer aws-lambda-layers#256
• Add ap-southeast-3 and me-central-1 regions in Bref v3 #1952
• Optimize layer sizes aws-lambda-layers#262
• The pgsql extension is now enabled by default
• Publish v3 layers to a separate AWS account (873528684822)
• Switch to Amazon Linux 2023 for Bref v3 aws-lambda-layers#122
• Add the Redis extension aws-lambda-layers#284
• Drop the blackfire extension from "dev" container images
• Remove the deprecated "hooks" system #2012
• Prepare Bref v3 laravel-bridge#190
• Delete the bref CLI (Bref v3) #2030

Ideas considered:

• Facilitate deploying container images based on anything (e.g. Debian/Ubuntu)
• Automatically gzip large responses #1661

TODO:

• Update all documentation to point to provided.al2023 instead of provided.al2
• Document the migration to provided.al2023 in the upgrade guide
• v3: broken locale support (gettext) aws-lambda-layers#305

[aromka]

Do you have any ETA in mind for this?

[mnapoli]

Targeting end of November or early December hopefully. You can start using v3 right now, I have published the first alpha versions.

[jlabedo]

Hello @mnapoli , thank you for your work, I am using Bref since a while and working like a charm.

But, I am about to drop bref runtime (php files) and only keep base layers for the reason that I can't send the response BEFORE calling kernel.terminate and do some heavy work (my use case is mostly sending opentelemetry data for now). I am using the function runtime (way faster than fpm because of connection reuse) and symfony.

So I built a custom runtime for symfony + bref, doing some low level things I would prefer see in Bref :)
Have you considered leveraging the symfony runtime for v3 ? I could help you and open a PR if you think it might be a good thing.

here is my http runner code, leveraging symfony runtime:

public function run(): int
    {
        $loops = 0;
        $memoryLeakDetector = new MemoryLeakDetector();

        while ($invocation = $this->apiClient->nextInvocation()) {            
            try {
                if (is_string($invocation->event)) {
                    throw new Exception('Invalid event: ' . $invocation->event);
                }
                $request = RequestConverter::convert($invocation->event);

                $response = $this->kernel->handle($request);

                $lambdaResponse = ResponseConverter::convert($response);
            } catch (Throwable $e) {
                $invocation->signalFailure($e);
                return 0;
            }
            
            $invocation->sendResponse($lambdaResponse);
            
            if ($this->kernel instanceof TerminableInterface) {
                $this->kernel->terminate($request, $response);
            }

            // Only check loop max if it's set and > 0
            if ($this->loopMax > 0 && ++$loops > $this->loopMax) {
                return 0;
            }

            // Boot kernel to prepare for next invocation (resets resettable services)
            if ($this->kernel instanceof \Symfony\Component\HttpKernel\KernelInterface) {
                $this->kernel->boot();
            }

            // Clear memory between invocations
            gc_collect_cycles();

            // Check for memory leak
            if ($memoryLeakDetector->checkAndRecord()) {
                return 0;
            }
        }
    }

[mnapoli]

@jlabedo I think this already exists: https://bref.sh/docs/symfony/keep-alive right?

(PS: can you create a separate issue if this isn't it, to avoid cluttering the v3 PR)