bridgetphp/bridget

This package is abandoned and no longer maintained. The author suggests using the bridget/bridget package instead.

Bree - A modern PHP superset with strong typing and OOP enhancements

dev-main / 0.x-dev 2025-04-15 05:29 UTC

Requires

• php: ^8.4
• ext-readline: *

Requires (Dev)

• siguici/php-devtools: ^1.1

Replaces

• psr/container: ^2.0

MIT

• Sigui Kessé Emmanuel

• stream
• installer
• parser
• ini
• events
• compressor
• OOP
• type
• output
• input
• event-emitter
• typesafe
• compiler
• binary
• env
• dotenv
• fetch
• runtime
• bree
• archiver
• cli-app
• ftp-client
• ftp-server
• query-parsing
• event-listener
• path-parsing
• path-parser
• emit-event
• listen-event
• query-parser
• array-config
• put-files
• get-files
• let var
• templating-engine
• php-transpiler
• scripting-language
• blade-template
• oriented-object-programming
• programming-language
• uri-parsing
• uri-parser

README

Bree is a modern PHP framework designed to enhance development with strong typing, advanced object-oriented features, and a powerful templating system inspired by Blade. 💡✨

⚡ Quick Start

📦 Install Bree

Install Bree via Composer with:

composer global require bree/bree:dev-main

🎉 Try Bree

Create a hello.bg file:

Hello, $name!

Run it with:

bree run hello --name=Bree

This displays: Hello, Bree! 🎊

❓ What is Bree?

Bree is a cutting-edge PHP framework that introduces:

✅ Strong typing for better code reliability 🔍 ✅ Advanced OOP features for maintainable applications 🏗️ ✅ A powerful templating system for seamless UI rendering 🎨 ✅ Full PHP compatibility ensuring easy adoption 🔄

🔥 Why Choose Bree?

• 🚀 Enhances PHP without breaking compatibility – Upgrade your projects without major rewrites.
• ✍️ No need for PHPDoc & annotations – Types are enforced at both transpilation and runtime.
• ⚡ Inspired by TypeScript – Offers both static and dynamic typing for flexibility.
• 🎭 Blade-like templating – Clean and structured HTML rendering.

🌟 Features

• 🛡️ Strong Typing – Enforces types at compile-time and runtime.
• 🏗️ Advanced OOP – Expands PHP’s object-oriented capabilities.
• 🔄 Dynamic & Static Typing – Inspired by TypeScript.
• 🖥️ Integrated Templating Engine – A Blade-like system for clean HTML rendering.
• 🧩 Seamless PHP Integration – 100% compatible with existing PHP code.

📋 Requirements

🔹 PHP 8.4 or higher (8.4.3+ recommended)
🔹 Composer
🔹 Git
🔹 Node.js (Optional)

🚀 Installation

Install Bree from Packagist using Composer:

composer global require bree/bree:dev-main

🛠️ Usage

Bree transpiles .bg files into .php, introducing enhanced features while maintaining PHP compatibility.

🔧 Example Command

bree source.bree

This converts source.bg into an optimized PHP file.

📝 Example Code

<?php
// Strongly-typed function in Bree
function greet<T extends string>(T $name): T {
    return "Hello, $name!";
}

echo greet("World");

🏆 Transpiled PHP Code

<?php

function greet(string $name): string {
    return "Hello, $name!";
}

echo greet("World");

?>

Bree ensures type safety at transpilation, making PHP development more robust. 🛡️

🤝 Contributing

We welcome contributions! 💖 Whether it's bug fixes, new features, or documentation improvements, feel free to contribute.

📌 How to Contribute

1. 🍴 Fork the repository.
2. 🌱 Create a new branch.
3. 🛠️ Implement your changes and add tests.
4. 📤 Submit a pull request.

Please follow our coding style and contribution guidelines. 🙌

📜 License

Bree is licensed under the MIT License. See the LICENSE.md file for details.

💬 Support & Community

For questions, issues, or feedback:

• 🚀 Open an issue
• 💬 Join our discussions