Async/parallel resource execution library for BEAR.Sunday.
BEAR.Async enables transparent parallel execution of BEAR.Sunday’s #[Embed] resources.
Traditional async programming requires rewriting code with special syntax like async/await, Promise, or yield. Developers must explicitly manage concurrency and learn new patterns. BEAR.Async takes a different approach: your existing #[Embed] attributes work as-is. Just install a module, and embedded resources automatically execute in parallel. No syntax changes, no rewriting, no learning curve.
#[Embed(rel: 'profile', src: 'app://self/user/profile?id={user_id}')]
#[Embed(rel: 'posts', src: 'app://self/user/posts?user_id={user_id}')]
#[Embed(rel: 'notifications', src: 'app://self/notifications?user_id={user_id}')]
public function onGet(int $user_id): static
With BEAR.Async module installed, these 3 embeds execute in parallel instead of sequentially. If each resource takes 50ms to fetch, synchronous execution takes 150ms total, while parallel execution completes in approximately 50ms—a 3x speedup with zero code changes.
For PHP-FPM/Apache environments using ext-parallel thread pool.
$this->install(new AsyncParallelModule(
namespace: 'MyVendor\MyApp',
context: 'prod-app',
appDir: dirname(__DIR__),
));
For Swoole HTTP Server environments using coroutines.
$this->install(new AsyncSwooleModule());
$this->install(new PdoPoolEnvModule(
'PDO_DSN',
'PDO_USER',
'PDO_PASSWORD',
));