afridlund85/asd-framework

Minimalistic framework for PHP7

Asd(name?) PHP7 API Framework

PHP7 Framework for API applications., _(*1)

Installation

None, it is not even close to ready for release., _(*2)

Some Key Concepts

• PHP 7 only
• No dependencies(expect PSR-7 interfaces)
• PSR: 1,2,4,7
• No statics, no globals
• No forced strict conventions in naming/routing, folder structure etc when using
• No settings or configs
• Transparency, no unncessary abstraction/wrapping
• Use PHP 7 strict types, (except PSR-7 classes, cuz they're not PHP 7)

Intended usage

Presumptions: htaccess configured and PSR-4 autoloading, _(*3)

Define routes with HTTP-method, path and controllerclass + method, _(*4)

index.php, _(*5)

require_once('vendor/autoload.php');

use Asd\Asd;
use Asd\Router\Route;
use Asd\FunctionCallback;
use Asd\MethodCallback;

$app = new Asd();

//Controller class extending from Asd\Controller and has dependency to Asd\Session
$app->addRoute(new Route('GET', '/', new MethodCallback('MyApp\Controllers', 'Welcome', 'start')));

//Just some class with a method
$app->addRoute(new Route('GET', 'about', new MethodCallback('MyApp', 'SomeClass', 'about')));

//Closure/Anonymus function
$app->addRoute(new Route('post', 'blog', new FunctionCallback(function($req, $res){
  //do stuff
  return $this->res; //return response
})));

//Closure/anonymus function with dependency
$app->addRoute(new Route('post', 'auth', new FunctionCallback(function($req, $res, Asd\Session $session){
  //session class automatically injected through DI
  return $this->res;//return response
})));

$app->run();

MyApp/Controllers/Welcome.php, _(*6)

namespace MyApp\controllers;

use Asd\Controller;

class Welcome extends Controller
{
  public function __construct(Asd\Session $session)
  {
    //session class automatically injected through DI
  }
  public function start($req, $res)
  {
    return $res->withJsonResponse('Hello!');
  }
}

MyApp/SomeClass.php, _(*7)

namespace MyApp;

class SomeClass
{
  public function about($req, $res)
  {
    //do stuff;
    return $res;
  }
}

Setup Development environment

Requires PHP7, _(*8)

git clone https://github.com/afridlund85/php7-api-framework.git
cd php7-api-framework
composer install

Tests

Three levels of testing, unit, integration and system., _(*9)

Runing tests

Run all test suites, _(*10)

composer test

Run Unit test suite, _(*11)

composer unit

Run Integration test suite, _(*12)

composer integration

Run System test suite, _(*13)

composer system

PSR-2 linting

Check for PSR-2 errors, _(*14)

composer sniff

Code coverage

Generate code coverage, _(*15)

composer coverage