This repository contains the skeleton package for creating a new CodefyPHP project. If you are only interested in the core framework, visit the main CodefyPHP Framework repository.
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.
- PHP 8.2+
- Additional constraints based on which components are used.
- 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
- NIST Level 2 Standard Role-Based Access Control
To create a new project, run the following command:
composer create-project codefyphp/skeleton my-app-name
Replace my-app-name
with the directory name to which you are starting your new project. Once installed, cd
into
the root directory of your app and start the development server by running the following terminal command:
php codex serve
Once the server starts, visit the new install at http://localhost:8080
.
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 | September 2024 | September 2027 | September 2028 |
3 | 8.3 | October 2024 | August 2025 | April 2026 |
4 | 8.4 | February 2025 | December 2025 | August 2026 |
5 - LTS | 8.4 | April 2025 | April 2028 | April 2029 |
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.
If you use CodefyPHP or you are interested in supporting the continued development of my opensource projects, please consider sponsoring me via Github.
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.).
If you discover a vulnerability in the code, please email [email protected].
CodefyPHP is opensource software licensed under the MIT License.