This is a project about MVC Skeleton/Boilerplate for the Slim Framework.
If you have not installed Composer, install it as following, http://getcomposer.org/doc/00-intro.md#installation
After you install Composer, run below command from the directory in which you want to install.
(assumed you install composer as /usr/bin/composer globally, or please replace composer
with php composer.phar
),
composer create-project zacao/slimvc [app-name]
Replace [app-name]
with the directory name of your new application, and then do as below steps:
- Set your virtual host document root to the
public/
directory. - Ensure folders under
var/
directory are writeable for your web server user, such as log, cache, and temp.
OR
your can download the latest code package from github directly to your local machine
- app
- controllers - controller classes
- models - model classes
- views - template files
- routers - Slim routes group by feature, should be named as feature_name.router.php
- middlewares - Slim customized middlware classes
- etc - configuation file, e.g. config.php
- lib - your customized lib classes against with the official composer classes in PSR-4 standard
- public - document root & the public assetic files, such as images, css and js
- var - writable folder, such as log, cache, temp and so on
Here should be the main folder which stores your own codes, such as controllers, models, views, middlewares and so on.
Slim routes group by feature, and names in <feature_name>.router.php format.
differenct with the Slim official example, we using <optional-namespace>\<class_name>:<method_name>
format to define a router, against with uing Clouse in Slim official doc.
article.router.php
$app->get('/article/:id', 'ArticleController:get');
$app->delete('/article/:id', 'ArticleController:delete');
- router files are loaded & sorted in alphanumeric order, you can priority routers by proper file names, such as, 0.default.router.php, 1.products.router.php (Thanks Wout's comments here)
- you can also call contollers with namespace specified, e.g.
$app->get('/admin/article/:id', 'Admin\ArticleController:get');
Stores controller classes files which defined in router. It MUST be one class per file, and the filename should be same as the controller class name.
IndexController.php
class IndexController extends Controller
{
public function index()
{
$data = array(
'title' => 'It works!',
'content' => 'Just have fun with the Slim in MVC way now!'
);
$this->render("index/index.phtml", $data);
}
}
As the Slim configurate format, please refer to the original Slim configuration doc
config.php
return array(
'debug' => true,
'templates.path' => BASE_DIR .'/app/views',
'pdo' => array(
'default' => array(
'dsn' => 'mysql:host=localhost;dbname=test',
'username' => 'root',
'password' => '',
'options' => array()
),
),
);
About the standard Slim middleware classes, Please refer to the original Slim middleware doc
The model classes should be here. You can implement the model classes as you like.
ArticleModel.php
class ArticleModel extends Model
{
public function delete($id)
{
// TODO related DML lines here
$dbh = $this->getWriteConnection();
return true;
}
}
Template files in default Slim format, Please refer to the original Slim middleware doc
Put your customize classes files here, in this sample, we using PSR-4 as autoloading standard, please refer to composer.json
and files under lib
folder for detail.
composer.json
"autoload": {
"psr-4": {
"": [
"app/controllers",
"app/models",
"app/middlewares"
],
"Slimvc\\": "lib/Slimvc"
}
}
There are Slimvc\Core\Controller, Slimvc\Core\Model sample classes created under the lib folder.
Controller.php
namespace Slimvc\Core;
abstract class Controller
{
protected $appname = "default";
protected function getApp()
{
return \Slim\Slim::getInstance($this->appname);
}
protected function getConfig()
{
return $this->getApp()->container['settings'];
}
protected function render($template, $data = array(), $status = null)
{
$this->getApp()->render($template, $data, $status);
}
}
Here is the document root (.htaccess
& index.php
) and repository for public static assets, such as images, css and javascripts
Location for writable entires, such as logs, caches and temporary files
https://packagist.org/packages/zacao/slimvc
This project is released under the MIT public license.