Fleshpress

A very basic PHP MVC framework inspired by Express (NodeJS) and Flask (Python) made as my first PHP-assignment at Chas Academy - Fullstack Web Developer.

Please note that this code is obviously not something you would use in production!

Table of Contents

Basic Route Example
Models
Middleware Functions
More Examples
Middleware Classes
Config

Basic Route Example

$app = newFleshpress();
$app->get('/', function($req, $res) {
$res->send('Hello World!', 200);
});
$app->start();

Models

Custom models extend from Model and implement the abstract function abstract static public function register(); and a schema.

Here's a basic example where 'title' and 'content' are the names of the columns in your table and 'blog_posts' is the actual table name.

class BlogPostModel extends Model {
protectedstatic$tableName;
protected$schema;
publicfunction__construct(string$title, string$content) {
$this->schema = [
'title' => $title,
'content' => $content
];
}
publicstaticfunctionregister()
{
static::$tableName = 'blog_posts';
}
}
BlogPostModel::register();

The base model currently supports the following queries.

Model::findAll();
Model::find(array $params);
Model::findById(int $id);
Model::findOneById(int $id);
Model::findByIdAndUpdate(
int $id, array $params, bool $returnUpdatedItem = false, string $idDenominator = 'id'// may be removed
);
Model::delete(array $params);
Model::deleteOneById(int $id);

To create a new Blog Post in this example we would use the following syntax:

$newBlogPost = newBlogPostModel(
'This is a title',
'And this is the content'
);
$newBlogPost->save();

Middleware Functions

To use a middleware function we can use the following syntax:

/* Protected Route */$app->get('/protected', 'requireLogin', function($req, $res) {
$res->render_template('protected.html');
});
/* Middleware function, has acccess to the Request and Response-object */functionrequireLogin($req, $res) {
$isAuthed = false;
if (! $isAuthed) {
$res->json(["message" => "Oops. It seems as though you're not logged in."], 401);
}
}

More Examples

$app->get('/posts', function($req, $res) {
try {
$posts = BlogPostModel::findAll();
$res->render_template('posts.html', ['posts' => $posts]);
} catch (Exception$err) {
$res->error(['message' => $err->getMessage()], 500) // the Response error-method defaults to error.html
}
});
$app->get('/post/:id', function($req, $res) {
$post = BlogPostModel::findOneById($req->params['id']);
$res->json(['post' => $post]);
});
$app->get('/post/:id/:anotherID', function($req, $res) {
$id = $req->params['id']; // eg. 1$anotherID = $req->params['anotherID']; // eg. 3
});
$app->post('/post', function($req, $res) {
try {
$newPost = newBlogPostModel(
$req->body['title'],
$req->body['content']
);
$newPost->save();
$res->redirect('/posts');
} catch (Exception$err) {
$res->json(["message" => $err->getMessage()], 500);
}
});

Middleware

You can also add global middlewares like this.

Eg.

$app->use(newSomeMiddleware);

And to roll your own extend from the MiddleWare-class.

See Session Middleware for an example.

The Session Middleware is included on every page which can be useful for logging in/out a user or similar.

$app = newFleshpress();
$app->use(newSession());
$app->config['db'] = [
'dsn' => 'mysql:host=127.0.0.1;dbname=blog;charset=utf8',
'user' => 'root',
'password' => 'root'
];
/* Login */$app->post('/login', function($req, $res) {
$userFound = UserModel::find(['email' => $req->body['email']]);
if (! empty($userFound)) {
if (password_verify($req->body['password'], $userFound['password'])) {
$req->session->user = [
'id' => $userFound['id'],
'name' => $userFound['name']
];
$res->redirect('/admin');
}
}
$res->redirect('/login');
});
/* Logout */$app->get('/logout', function($req, $res) {
$req->session->user = null;
$res->redirect('/');
});

Config

Although I've tried to keep things as un-opinionated as possible, there are some default settings and some that needs to be followed, at the moment.

Template Folder

The template path defaults to /static/templates, this can be overriden by calling the config on the Fleshpress-object.

$app = newFleshpress();
$app->config['templatesFolder'] = '/some/path/';

Database Connection

Database connections are optional, but whenever you use it you must provide the config with the following information.

$app = newFleshpress();
$app->config['db'] = [
'dsn' => 'mysql:host=HOST;dbname=DBNAME;charset=utf8',
'user' => 'USER',
'password' => 'PASSWORD'
];

Authors

• Tom Ekander - Initial work - lessp

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments

• axelolsson - for help, trying to teach us this stuff and for letting me borrow bits and pieces
• Flask, Express, Mongoose - for inspiration