clancats / framework
ClanCats Framework, because your time is precious. HMVC PHP framework.
Requires
- clancats/core: 2.0.*
This package is auto-updated.
Last update: 2024-09-24 01:30:56 UTC
README
ClanCatsFramework, painless web development no overkill. HMVC PHP framework.
This is the Application repository if you like to contribute take a look at the core repository: https://github.com/ClanCats/Core
Philosophy
There are a many brilliant frameworks out there and I don't want to reinvent the wheel. My vision of CCF is a:
- modern
- well-architected
- high performance
- user friendly
full stack php framework.
User friendly or developer friendly is the core philosophy. The trick should be to keep the balance between the simplest and the best solution for a problem. I've been working on a lot big applications using Zend and Symfony2 and there was always the point where I looked at the code and thought:
"wait so to generate a random string I need a class extending a container wich provides me the util service factory to create a new string util instance where i can execute the random string method on?".
Often it's a complete overkill to reach a simple goal using these frameworks. So the goal of CCF is to make development comfortable instead of following 100% a convetion.
History
This PHP framework was originally build 2010 as the core of a social Plattform called "ClanCats". In 2012 I decided to split the core and the application apart, so CCF was born. After developing several application on CCF v1.0, the point has come to rethink the core structure and rewrite the entire thing to a new version that should go open source.
Installation
Setting up a new instance of CCF2 can be done simply with one command, or, in other words, with composer.
Run the following command to create a new CCF project.
$ composer create-project clancats/framework <your project name> --prefer-dist
Composer not installed? Read the installation guide here: https://getcomposer.org/download/
Requirements
To run this framework please check the following requirements:
- PHP >= 5.3.9
- PHP JSON
- PHP MCrypt
- PHP Multibyte String
- Apache with mod_rewrite or Nginx
Permissions
For some operations ( storage, packtacular etc. ) we may need to grant write permissions in the file system.
Storage: /CCF/storage/
Packtacular: /public/assets/packtacular/
You can also set these using the cli
doctor.
$ php cli doctor::permissions
If you get an error setting the permissions try to run the that command with sudo
.
Structure
In the new CCF2 folder structure we split some things apart to make deployment much more efficient.
- CCF/
- app/ // Your Application
- core/ // The CCF Core
- orbit/ // Orbit ships ( plugins / modules )
- storage/ // Internal file storage for logs, cache etc.
- vendor/ // Composer vendor
- boot/
- environment.php // The Environment configuration
- paths.php // Framework paths configuration
- cli // Command line utility
- composer.json
- framework.php
- phpunit.xml
- public/
- index.php // Web Application public
Configuration
There is usually no configuration required to just run the framework (depending on your environment). We do, however, recommend to do some configuration before you start developing your awesome application.
Boot
The boot configuration allow you change the core behavior of the CCF.
Environment
Define how your application detects the environment.
You can create an entirely new script of your own to return the runtime environment or you can make use of the env detector.
/boot/environment.php
Check out the environment docs: Environment
Paths
Plan on running multiple CCF installations on one machine? Using just a single core? This is no problem because you can modify the CCF paths.
/boot/paths.php
You are also free to add new paths. Adding a new element to the array will add the path to runtime and also create a path define:
<value> = <value>PATH
test = TESTPATH
main config
You will find an initial main configuration file under:
/CCF/app/config/main.config.php
Security Salt
At several points CCF is going to encrypt certain things by employing salt. You should define your own salt to keep your application secure.
You can generate a random salt using the following command:
$ php cli doctor::security_key
When using composer to create a new project the salt is generated automatically.
Otherwise you will find the key under security in the main configuration:
'security' => array( 'salt' => 'L~7(%(9=@9+8u.Oo4+ysT45fkA4,82', ),
Path offset
Maybe you would like to run your application from somewhere other than the domain root, e.g. from a subfolder. forums.
// www.yourdomain.com/forums/ 'url' => array( 'path' => '/forums/', ),
For everything else, check out the main configuration documents: Configuration
Routing
Depending on your system you will need to set something up so that all public requests end on the public/index.php
file.
CCF ships with an .htaccess
for apache systems with mod_rewrite
enabled:
RewriteEngine On # RewriteBase /subdir/ # Only Rewrite URL if file not exits RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d # Default RewriteRule ^(.*)$ index.php?/$1 [QSA,L]