MicroAPI is an extremely lightweight PHP framework for creating REST APIs.
- Apache 2.0+
- mod_rewrite enabled
- PHP 5.4+
A MicroAPI application by default has the following structure.
- App
- Controller
- Models
- Services
- MicroAPI
- public
The directory structure can be changed by editing the constants MICROAPI_PATH and APP_PATH in public/const.php then moving the directories to their corresponding locations. It is advisable to keep application code out of the public directory.
The App directory is where you write your application.
The MicroAPI directory contains the framework. If there are multiple websites using MicroAPI on the same system they can be configured to share one copy of it.
The public directory is where the requests enter the framework.
MicroAPI follows the PSR-4 standard for autoloading classes.
Within the App directory there are three files
- App/config.php function is executed
- App/run.php function is executed
- App/routes.php function is executed - If a route is matched its controller is executed
Configuration variables for the application can be defined in App/config.php. By default there are options for the database and response already listed.
It's recommended not to define values that have a key starting with microapi..
Routes for your application are defined in the app/routes.php file. The router will initialise the controller for the first match, once a match has been found the rest of the routes will not be checked.
By default the app/routes.php has two sample routes showing how to setup a function and a class.
return function($router)
{
$router->get([
'route' => '/name/(name)',
'class' => 'Example@getName',
'require' => function() {
return 1 + 1 == 2;
}
]);
$router->post([
'route' => '/name/(name)',
'function' => 'functionExample@postName',
]);
};The router has the methods get, post, put, delete which match the corresponding HTTP methods and any which will match any HTTP method.
The require function allows for any additional requirements to be specified before the route is matched. If anything other than true is returned from the function the route will not be matched.
$router->get([
'route' => '/user/(id)',
'function' => 'user@details',
'require' => function($database, $request) {
$user = $database->select('SELECT id FROM User WHERE id = ?', $request->getPathWildcard('id'));
return count($user) === 1;
}
]);Controllers are dependency injected, they can be either a function or a method on an object.
function myController($request, $response, $database)
{
$id = $request->getParam('id');
$results = $database->select('SELECT * FROM Table WHERE id = ?', $id);
$response->make($results);
}A service is an object that can be injected at various places in the application, there will only one instance of each service per request. By default MicroAPI comes with six services.
The request object is a representation of the request the user made.
Responses are "replies" to a clients request, only one response should be sent per request.
The database service is built on top of PDO, it has four convenience functions to make accessing the database easier.
For more specific tasks you can access the database directly by calling getConnection() which returns the PDO object.