helvetica/standard

The Standard PHP framework

1.0.1 2018-10-10 12:55 UTC

This package is not auto-updated.

Last update: 2024-05-06 16:29:10 UTC


README

GitHub PyPI - Status

Simple is Power

Installation

composer require helvetica/standard 1.0.1

Import the composer autoload

require('vendor/autoload.php');

Get Start

use Helvetica\Standard\App;
use Helvetica\Standard\Router;
use Helvetica\Standard\Library\Response;

$router = new Router();

$router->set('/hello/<name>', function(Response $response, $name) {
    return $response->withContent('hello ' . $name);
});

(new App)->start();

Test with built-in server

php -S localhost:8080

Visit http://localhost:8080/hello/world to say: "hello world"

Using template

hello.php

<!DOCTYPE html>
<html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>Document</title>
    </head>
    <body>
        <h1>hello <?= $name ?></h1>
    </body>
</html>

index.php

use Helvetica\Standard\App;
use Helvetica\Standard\Router;
use Helvetica\Standard\Library\Template;
use Helvetica\Standard\Library\Response;

$router = new Router();

$router->set('/hello/<name>', function(Response $response, Template $temp, $name) {
    $output = $temp->render(__DIR__ . '/hello.php', ['name' => $name]);
    return $response->withContent($output);
});

(new App)->start();

Visit http://localhost:8080/hello/world to say: "hello world"

Controller classes

index.php

use Helvetica\Standard\App;
use Helvetica\Standard\Router;
use Helvetica\Standard\Library\Response;

class PrintController
{
    public function hello(Response $response, $name)
    {
        return $response->withContent('hello ' . $name);
    }
}

$router = new Router();

$router->set('/hello/<name>', [PrintController::class, 'hello']);

(new App)->start();

Visit http://localhost:8080/hello/world to say: "hello world"

Using filter

use Helvetica\Standard\App;
use Helvetica\Standard\Router;
use Helvetica\Standard\Library\Request;
use Helvetica\Standard\Library\Response;
use Helvetica\Standard\Abstracts\ActionFilter;

class SayHelloFilter extends ActionFilter
{
    /**
     * The method hook is injectable, and has a fixed param $next.
     * You can call and return the $next closure to continue
     * or just return a response to terminate the process.
     */
    public function hook(Request $request, $next)
    {
        $params = $this->getParams();
        $name = $params['name'];
        $request->withAttributes(['text' => 'hello ' . $name]);
        return $next();
    }
}

$router = new Router();

$router->set('/hello/<name>', function(Request $request, Response $response, $name) {
    $text = $request->getAttribute('text');
    return $response->withContent($text);
})->setFilters([SayHelloFilter::class]);

(new App)->start();

Visit http://localhost:8080/hello/world to say: "hello world"

Using handler

Let's raise a 404 not found exception, and register a not found handler.

use Helvetica\Standard\App;
use Helvetica\Standard\Router;
use Helvetica\Standard\Exception\NotFoundException;
use Helvetica\Standard\Abstracts\HttpExceptionHandler;

$router = new Router();

$router->set('/not-found', function() {
    throw new NotFoundException();
});

// create a not found handler
class MyNotFoundHandler extends HttpExceptionHandler
{
    public function getResponse(Response $response)
    {
        return $response->withContent('This is my not found exception message.');
    }
}

$app = new App();

$app->setHandler(App::HANDLE_NOT_FOUND, MyNotFoundHandler::class);

$app->start();

Visit http://localhost:8080/not-found to say: "This is my not found exception message."