Add a way to stream template rendering

[fabpot]

Even if we're using yield internally, there is no easy way to stream template rendering. This new method can be used like this to HTTP stream a template with Symfony:

use Symfony\Component\HttpFoundation\StreamedResponse;
use Twig\Environment;

$twig = new Environment(/* ... */);

$response = new StreamedResponse($twig->load('index')->stream([]));
$response->send();

[fabpot]

I thought about streaming blocks as well, but I'm not sure this is worth it.

[yceruto]

This will allow us to improve this method https://github.com/symfony/symfony/blob/7.3/src/Symfony/Bundle/FrameworkBundle/Controller/AbstractController.php#L267 👍

I thought about streaming blocks as well, but I'm not sure this is worth it.

I think yes, since there is a renderBlock() method added recently https://github.com/symfony/symfony/blob/dd882dbbd4910dce577d5bd280920e259dd782a5/src/Symfony/Bundle/FrameworkBundle/Controller/AbstractController.php#L428

[GromNaN]

Will you add a helper Twig\Environment::stream() as well?

[smnandre]

I think yes, since there is a renderBlock() method added recentl

And it's used via the #[Template] attribute too.

[smnandre]

And this will probably allow some decent optimizations in the TwigEngineRenderer / block systems :)

[fabpot]

I've just added a streamBlock() method as well.

[fabpot]

Will you add a helper Twig\Environment::stream() as well?

No, I don't think this is needed. The Environment class has already too many methods. I would like to do the opposite actually and deprecate the Environment::render() method.