greenarmor/bamboo

BAMBOO (Bootstrapable Application Microframework Built for OpenSwoole Operations).

v1.2.3 2025-09-30 01:33 UTC

Requires

• php: ^8.4
• ext-openswoole: *
• guzzlehttp/guzzle: ^7.9
• http-interop/http-factory-guzzle: ^1.2
• illuminate/database: ^11.0
• monolog/monolog: ^3.6
• nikic/fast-route: ^1.3
• nyholm/psr7: ^1.8
• php-http/guzzle7-adapter: ^1.0
• predis/predis: ^2.2
• promphp/prometheus_client_php: ^2.7
• psr/container: ^2.0
• psr/log: ^3.0
• symfony/finder: ^7.1
• symfony/process: ^7.1
• vlucas/phpdotenv: ^5.6

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.68
• phpstan/phpstan: ^1.12
• phpunit/phpunit: ^11.2

MIT

• Emmanuel Secretaria

• framework
• queue
• php
• websocket
• bamboo
• http-server
• swoole
• openswoole

README

Bamboo is a lightweight PHP microframework that pairs OpenSwoole's asynchronous runtime with an Express-style developer experience. Use it when you need fast, event-driven services without the bulk of a monolithic stack.

Prerequisites

• PHP 8.2 or newer with the OpenSwoole extension enabled
• Composer

Detailed setup guidance for macOS, Linux, and containerized environments lives in the project documentation.

Quick start

$ composer create-project greenarmor/bamboo example-app
$ cd example-app
$ php bin/bamboo http.serve

Then visit http://127.0.0.1:9501 to view the default application.

Documentation

• Installation walkthroughs, CLI references, and upgrade notes are published in the Docs directory.
• The latest rendered documentation is available on the GitHub Pages site.

UI templating and theming

Need to customize the client-side templates or Bamboo UI theme? Read the UI templating and theming guide (also published on GitHub Pages) for a deep dive into TemplateEngineManager, component renderers, and CSS extension points.

Contributing

Interested in helping Bamboo grow? Fork the repository, review the contribution guidelines in the docs, and open a pull request with your improvements. We welcome bug fixes, new modules, and documentation updates.