Sou o desenvolvedor deste framework, vamos isolar algumas explicações
Inphinit requer uma classe com 7 funções
Na verdade não é requerido, todos são opcionais, basicamente a classe Rest
checa quais métodos da classe são validos em:
private static $valids = array(
'index' => array( 'GET', '/' ),
'create' => array( 'GET', '/create' ),
'store' => array( 'POST', '/' ),
'show' => array( 'GET', '/{:[^/]+:}' ),
'edit' => array( 'GET', '/{:[^/]+:}/edit' ),
'update' => array( array('PUT', 'PATCH'), '/{:[^/]+:}' ),
'destroy' => array( 'DELETE', '/{:[^/]+:}' ),
);
E depois comparando ao que você setou:
$route = empty(self::$valids[$method]) ? false : self::$valids[$method];
A classe Rest
é apenas um facilitador, ela cria as rotas conforme você configura a classe do seu controller
É possível desabilitar elas?
Sim, são opcionais
Tanto é um facilitador que sem ele você poderia criar a sua API manualmente (se assim deseja-se), por exemplo com sessões para simular a gravação e leitura de dados:
<?php
use Inphinit\Routing\Route;
use Inphinit\Http\Request;
use Inphinit\Http\Response;
session_start();
// Cria os dados iniciais se não existirem `Inphinit\Experimental\Rest`
if (empty($_SESSION['exemplo'])) {
$_SESSION['exemplo'] = array(
array( 'id' => 1, 'name' => 'Guilherme Costamilam' ),
array( 'id' => 2, 'name' => 'Wallace Maxters' ),
array( 'id' => 3, 'name' => 'Carlos Bacco' )
);
}
function getItemById($id)
{
foreach ($_SESSION['exemplo'] as $key => $value) {
if ($value['id'] == $id) return $key;
}
return false;
}
// Lista todas "entidades"
Route::set('GET', '/api/', function () {
Response::type('application/json');
return json_encode($_SESSION['exemplo']);
});
// Adiciona uma nova "entidade"
Route::set('POST', '/api/', function () {
$raw = stream_get_contents( Request::raw() );
$json = null;
if ($raw) {
$json = json_decode($raw);
}
//Pega a ultima ID
$lastId = max(array_column($_SESSION['exemplo'], 'id'));
//Nova ID
$newId = ++$lastId;
if (empty($json->name)) {
$status = 400;
$response = array( 'response' => 'Dados inválidos' );
} else {
$_SESSION['exemplo'][] = array(
'id' => $newId,
'name' => $json->name
);
$status = 201;
$response = array( 'response' => true );
}
Response::status($status);
Response::type('application/json');
return json_encode($response);
});
// Lê uma entidade especifica
Route::set('GET', '/api/{:\d+:}', function ($id) {
Response::type('application/json');
$key = getItemById($id);
if (empty($_SESSION['exemplo'][$key])) {
Response::status(404);
$response = array( 'response' => 'Não encontrado' );
} else {
$response = $_SESSION['exemplo'][$key];
}
return json_encode($response);
});
// Deleta uma entidade especifica
Route::set('DELETE', '/api/{:\d+:}', function ($id) {
Response::type('application/json');
$key = getItemById($id);
if (empty($_SESSION['exemplo'][$key])) {
Response::status(404);
$response = array( 'response' => 'Não encontrado' );
} else {
unset($_SESSION['exemplo'][$key]);
$response = array( 'response' => true );
}
return json_encode($response);
});
Isso seria um exemplo de uma API bem básica, claro que tudo feito "manualmente", agora criando um controlador e usado a classe Inphinit\Experimental\Rest
ficaria algo assim:
./system/main.php
<?php
use Inphinit\Experimental\Routing\Rest;
Rest::create('Photo');
./system/application/Controller/Pessoas.php
<?php
namespace Controller;
use Inphinit\Response;
class Pessoas
{
//Ao instanciar a classe (ocorre internamente dentro de )
public function __construct()
{
session_start();
// Cria os dados iniciais se não existirem
if (empty($_SESSION['exemplo'])) {
$_SESSION['exemplo'] = array(
array( 'id' => 1, 'name' => 'Guilherme Costamilam' ),
array( 'id' => 2, 'name' => 'Wallace Maxters' ),
array( 'id' => 3, 'name' => 'Carlos Bacco' )
);
}
}
// acesse via GET http://site.com/
public function index()
{
return json_encode($_SESSION['exemplo']);
}
// acesse via POST http://site.com/
public function store()
{
$raw = Request::raw();
$json = null;
if ($raw) {
$json = json_decode($raw);
}
if (empty($json->name)) {
$status = 400;
$response = array( 'response' => 'Dados inválidos' );
} else {
$status = 201;
$response = array( 'response' => true );
}
Response::status($status);
Response::type('application/json');
return json_encode($response);
}
// acesse via GET http://site.com/show/<ID>
public function show($id)
{
$key = getItemById($id);
if (empty($_SESSION['exemplo'][$key])) {
Response::status(404);
$response = array( 'response' => 'Não encontrado' );
} else {
$response = $_SESSION['exemplo'][$id];
}
return json_encode($response);
}
// acesse via DELETE http://site.com/<ID>
public function destroy($id)
{
$key = getItemById($id);
if (empty($_SESSION['exemplo'][$key])) {
Response::status(404);
$response = array( 'response' => 'Não encontrado' );
} else {
unset($_SESSION['exemplo'][$key]);
$response = array( 'response' => true );
}
return json_encode($response);
}
private function getItemById($id)
{
foreach ($_SESSION['exemplo'] as $key => $value) {
if ($value['id'] == $id) return $key;
}
return false;
}
}
Essa explicação toda foi para entender o que pode "facilitar", agora vamos a explicação dos metódos especificos create
e edit
, pessoalmente creio que estes métodos sejam necessários somente em ambientes como páginas web ou que irá renderizar algo como formulários HTML.
Por exemplo nestes métodos teriam formulários que fariam requisições fetch()
ou XmlHttpRequest
que acessariam os metodos store
e update
.
Agora outro cenário, imagine que você esta criando uma aplicação JavaFX, e deseja usar FXML (leia https://docs.oracle.com/javafx/2/api/javafx/fxml/doc-files/introduction_to_fxml.html), então o create
:
public function create($id)
{
Response::type('application/xml');
return '<?xml version="1.0" encoding="UTF-8"?>
<?import java.net.*?>
<?import javafx.geometry.*?>
<?import javafx.scene.control.*?>
<?import javafx.scene.layout.*?>
<?import javafx.scene.text.*?>
<GridPane fx:controller="fxmlexample.FXMLExampleController"
xmlns:fx="http://javafx.com/fxml" alignment="center" hgap="10" vgap="10"
styleClass="root">
<padding><Insets top="25" right="25" bottom="25" left="25"/></padding>
<Label text="Digite o nome do novo usuário:"
GridPane.columnIndex="0" GridPane.rowIndex="1"/>
<TextField
GridPane.columnIndex="1" GridPane.rowIndex="1"/>
<HBox spacing="10" alignment="bottom_right"
GridPane.columnIndex="1" GridPane.rowIndex="4">
<Button text="Sign In"
onAction="#handleSubmitButtonAction"/>
</HBox>
</GridPane>';
}
E no edit
retornariam algo como:
public function edit($id)
{
Response::type('application/xml');
$name = null;
foreach ($_SESSION['foobarbaz'] as $key => $value) {
if ($value['id'] == $id) {
$name = $value['name'];
break;
}
}
if (!$name) {
Response::status(404);
$response = '<?xml version="1.0" encoding="UTF-8"?>
<?import javafx.scene.control.Label?>
<Label text="Não encontrado!"/>';
} else {
$response = '<?xml version="1.0" encoding="UTF-8"?>
<?import java.net.*?>
<?import javafx.geometry.*?>
<?import javafx.scene.control.*?>
<?import javafx.scene.layout.*?>
<?import javafx.scene.text.*?>
<GridPane fx:controller="fxmlexample.FXMLExampleController"
xmlns:fx="http://javafx.com/fxml" alignment="center" hgap="10" vgap="10"
styleClass="root">
<padding><Insets top="25" right="25" bottom="25" left="25"/></padding>
<Label text="Edite o nome do usuário:"
GridPane.columnIndex="0" GridPane.rowIndex="1"/>
<TextField text="' . $name . '"
GridPane.columnIndex="1" GridPane.rowIndex="1"/>
<HBox spacing="10" alignment="bottom_right"
GridPane.columnIndex="1" GridPane.rowIndex="4">
<Button text="Sign In"
onAction="#handleSubmitButtonAction"/>
</HBox>
</GridPane>';
}
return $response;
}
Se tiver alguma falha nos FXMLs me informe, não é minha área
São exemplos hipotéticos apenas, muitas coisas me basiei em frameworks existentes para facilitar as pessoas se adaptarem e aprenderem rápido o uso do framework, tentando deixar um pouco mais fácil
Devo deixar algo claro sobre o namespace Inphinit\Experimental
, tudo que estiver nele é voltado a sugestões (não que os demais não aceitem), aceito qualquer sugestão e vou analisar com calma, mas para resumir se tiverem sugestões de como trabalhar com REST no framework podem entrar em contato comigo por onde desejar, facebook, telegram e linkedin.
Para resumir, se deseja somente uma API com JSON ou Xml você apenas criar os métodos assim:
class Usuarios
{
// acesse via GET http://site/photo/
public function index()
{
...
}
// acesse via GET http://site/photo/create
public function create()
{
...
}
// acesse via POST http://site/photo/
public function store()
{
...
}
// acesse via GET http://site/photo/show/<digite o nome ou ID>
public function show($id)
{
...
}
// acesse via PUT http://site/photo/<digite o nome ou ID>
public function update($id)
{
...
}
// acesse via DELETE http://site/photo/<digite o nome ou ID>
public function destroy($id)
{
...
}
}
Desta forma as rotas GET /create
e GET /<id ou algo assim>/edit
não estarão disponíveis
Extra: Agrupar rotas
Você pode isolar a API por uma "sub-rota" com Inphinit\Experimental\Group
algo como:
<?php
use Inphinit\Experimental\Routing\Rest;
use Inphinit\Experimental\Routing\Group;
Group::create()->path('/api/')->then(function () {
Rest::create('Usuarios');
});
Pode isolar por domínios:
//Acessivel via foobar.com ou www.foobar.com
Group::create()->domain('{:www|:}.foobar.com')->then(function () {
Route::set('GET', '/', 'Foo:index');
Route::set('GET', '/abc', 'Foo:bar');
Route::set('GET', '/xyz/', 'Foo:baz');
});
//Acessivel via api.foobar.com
Group::create()->domain('api.foobar.com')->then(function () {
Rest::create('Usuarios');
});
O que seria outra forma de isolar o que são formulários e afins e isolar o que são APIs
create
eedit
siga uma lógica parecida com o do Laravel: criar a camada de visualização, para exibição de formulários.create()
eedit()
, se na classe não tiver então seria semelhante a usarRoute::resource('photos', 'Usuarios')->except([ 'create', 'edit' ]);
do Laravel, a diferença é que não precisa executar um except, basta não criar os métodos na classe e o FW se encarrega disto.