JHFrame
JHFrame is a custom web framework for PHP, designed for traditional
server-side-view-creation MVC patterns but written for modern 5.5+ PHP. It could
be classified as "partially batteries-included", having a lighter footprint and
feature-set than enterprise-scale frameworks like Laravel or Rails but much more
than micro-frameworks like Lumen or Sinatra., (*1)
Features include:
- Simple dynamic injection of all dependencies
- Traits for granular code inheritance without heavy parent class chains
- Interfaces for all major services
- Unit Testing through PHPUnit
- PSR-3 compatible logging
- Semantic routing
- Templates with metadata
- Cacheing
- Argument-based form creation and validation
- Simple repository-pattern data access/modification
- Chainable SQL query creator
- Optional permission-based authentication for routes
- And more, (*2)
Development
JHFrame grew gradually out of a single major project of mine and has gone
through a large number of revisions and rewrites as I have improved as a coder
and attempted to implement better design patterns., (*3)
JHFrame is fully usable, fast, and has a reasonably comprehensive feature-set,
with some caveats. Public publishing is primarily intended to serve as a code
example for me in job-hunting, but please feel free to use, experiment, and
borrow from it for your own projects, and contribute if you find it useful., (*4)
Caveats
The project JHFrame arose from is a low-traffic site that is data-driven but
with a low change frequency, so most design decisions were made with that in
mind. It is built in a server-side page-centric manner not primarily intended
for a heavy client single-page js application + server REST-api style, though it
could be adapted to such., (*5)
While I have worked to make it as agnostic as possible, as this grew out of the
needs of a single project and abstracting it into a standalone framework
primarily came as an academic/personal exercise (and of course for the benefits
of decoupling core logic from app-specific logic), some parts may
unintentionally remain insufficiently abstract for a true general-use framework., (*6)
That aside, Laravel and Lumen are extremely nice frameworks probably much more
worth your time for a new project!, (*7)
Installation and Use
JHFrame is available through Composer, (*8)
Add "rakelley/jhframe": "^1.0.0" to the require section of your project's
composer.json, (*9)
For usage, please see the docs markdown files and run phpdoc against /src., (*10)
Testing
phpunit -c test/phpunit.xml test/
License
JHFrame is licensed under the MIT License, (*11)
Wallogit.com
