Recursos HTTP experimentais
Substituição do método HTTP
GET e POST são os únicos métodos HTTP suportados por formulários HTML em navegadores web. Nessas situações, você pode simular outros métodos usando Inphinit\Experimental\Http\Method::override(). Veja o exemplo abaixo:
use Inphinit\Experimental\Http\Method;
Method::override();
// E.g., http://localhost/form
$app->action('GET', '/form', function () {
echo '<form action="/status" method="POST">';
// Override
echo '<input type="hidden" name="_method" value="PUT">';
echo '<input type="text" name="message"><br>';
echo '<button>Update status</button>';
echo '</form>';
});
// E.g., http://localhost/status
$app->action('PUT', '/status', function () {
echo 'Status updated!<br>';
echo '<a href="/status?_method=DELETE">clear<a>';
});
// E.g., http://localhost/status
$app->action('DELETE', '/status', function () {
echo 'Status cleared!';
});
Usando o parametro _method
O parametro _method pode ser enviado no corpo de uma requisição POST:
POST /status HTTP/1.1
Host: localhost
Content-Type: application/x-www-form-urlencoded
field1=value1&field2=value2&_method=PUT
Em HTML:
<form action="/status" method="POST">
<input type="hidden" name="_method" value="PUT">
<input type="text" name="message"><br>
<button>Request</button>
</form>
Cabeçalhos
Para alterar o método em requisições GET deve-se usar o header x-http-method-override
GET /status HTTP/1.1
Host: localhost
Content-Type: application/x-www-form-urlencoded
x-http-method-override: DELETE
Alterando o comportamento:
Por padrão só os metodos DELETE, PATCH, PUT, QUERY são aceitos, mas é possivel ajustar o comportamento manualmente, usando:
use Inphinit\Experimental\Http\Method;
$override = new Method($_SERVER, $_POST);
// Altera os métodos permitidos para FOO e BAR
$override->setAllowed(['FOO', 'BAR']);
// O header que irá receber o método será o `x-my-header`
$override->setHeader('x-my-header');
// O parametro POST que irá receber o método será o `_foobar`
$override->setParam('_foobar');
$_SERVER['REQUEST_METHOD'] = (string) $override;