codefyphp/codefy

PHP framework for Domain Driven Development, CQRS, and Event Sourcing.

Fund package maintenance!
parkerj
Ko Fi

v2.0.0-BETA2 2023-11-19 03:06 UTC

This package is auto-updated.

Last update: 2024-05-19 04:10:21 UTC


README

Latest Stable Version PHP 8.2 License Total Downloads CodefyPHP Support Forum

CodefyPHP is not a framework such as the likes of Symfony, Laravel, Codeigniter or CakePHP. Codefy is a simple, light framework providing interfaces and implementations for architecting a Domain Driven project with CQRS, Event Sourcing and implementations of PSR-3, PSR-6, PSR-7, PSR-11, PSR-12, PSR-15, PSR-16 and PSR-17.

The philosophy of Codefy is that code should be systematized, maintainable, and follow OOP (Object-Oriented Programming). CodefyPHP tries not to be too opinionated, yet encourages best practices and coding standards by following Qubus Coding Standards. Use Codefy as you see fit. You can tap into all, some or none of the features and instead use the interfaces to build your own implementations for a domain driven project.

UserId ValueObject

📍 Requirement

  • PHP 8.2+
  • Additional constraints based on which components are used.

🏆 Highlighted Features

  • A powerful routing engine
  • Robust dependency injector for bootstrapping
  • Adapters for cookies, sessions and cache storage
  • Provides a simple hook and event system without affecting core code
  • Encourages object-oriented programming
  • Multiple PSR implementations
  • Dual query builders with migrations
  • Scheduler for scheduling tasks/jobs
  • Security and sanitizing helpers
  • Dual templating engines

📦 Installation

You can use the composer command below to install the library, or by creating a new Codefy project using the skeleton package.

composer require codefyphp/codefy

🕑 Releases

Version Minimum PHP Version Release Date Bug Fixes Until Security Fixes Until
1 8.2 September 2023 July 2024 March 2025
2 - LTS 8.2 January 2024 January 2027 January 2028
3 8.3 January 2024 November 2024 July 2025
4 - LTS 8.3 May 2024 May 2027 May 2028

📘 Documentation

Documentation is still a work in progress. Between the Qubus Components documentation and CodefyPHP's documentation, that should help you get started. If you have questions or need help, feel free to ask for help in the forums.

🙌 Sponsors

If you use CodefyPHP or you are interested in supporting the continued development of my opensource projects, please consider sponsoring me via Github or Ko-fi.

🖋 Contributing

CodefyPHP could always be better! If you are interested in contributing enhancements or bug fixes, here are a few rules to follow in order to ease code reviews, and discussions before I accept and merge your work.

  • You MUST follow the QubusPHP Coding Standards.
  • You MUST write (or update) unit tests.
  • You SHOULD write documentation.
  • Please, write commit messages that make sense, and rebase your branch before submitting your Pull Request.
  • Please squash your commits too. This is used to "clean" your Pull Request before merging it (I don't want commits such as fix tests, fix 2, fix 3, etc.).

🔐 Security Vulnerabilities

If you discover a vulnerability in the code, please email joshua@joshuaparker.dev.

📄 License

CodefyPHP is opensource software licensed under the MIT License.