Download the PHP package pinkcrab/perique-route without Composer
On this page you can find all versions of the php package pinkcrab/perique-route. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download pinkcrab/perique-route
More information about pinkcrab/perique-route
Files in pinkcrab/perique-route
Package perique-route
Short Description WP REST Endpoint creation library for the Perique Framework.
License MIT
Homepage https://pinkcrab.co.uk
Informations about the package perique-route
Perique - Route
Library for registering WP Rest Routes in a more simple way.
Why?
Registering WP Rest Routes can either be extremely simple or a frustrating wit the argument array format. The Perique Route library allows for a simpler way to register single routes and groupes.
Setup
To install, you can use composer
You will need to include the Registration_Middleware to the App at boot. We have provided a static method that will handle the dependency injection.
One you have the Route Middleware added to the registration process, all classes which extend Route_Controller
will now be processed and all routes defined will be registered.
To create a route controller, just extend Route_Controller
and return an array of all routes and groups. The controllers are constructed with the DI Container, so all dependencies can be passed.
Once you have your Route_Controller setup, its just a case of passing the class to the registration
array and it will be loaded along with Perique.
Routes
Each route must be defined as part of a Route Model
, these can either be created by hand or using the supplied Route_Factory
(which is how the Route_Controller
operates.)
Route Model
A route model has 4 properties which must be defined, $method
, $route
, $callback
& $namespace
. Route and Method are passed via the constructor, but namespace must be set manually.
As per WP Api standards, all arguments in the route must be defined, this is all handled via the Arguments
object and is explained in more detail below.
All properties are defined as
protected
and should be handled via the supplied methods
It is also possible to define an authentication
callback too
Route Docs
- Route::namespace()
- Route::authentication()
- Route::callback()
- Route::argument()
- Route::with_method()
Route_Group
Like single Route Models, the Route_Group allows for a similar process of creating related routes that share a common endpoint route and also some functionality. Also like Routes, its better to use the supplied Route_Factory, but the details here will express how to create a Route_Group
manually (the core methods are used the same regardless).
This would then create a group where all routes assigned are created with the above namespace and route.
Read Group Docs
Setters
- Route_Group::post()
- Route_Group::get()
- Route_Group::patch()
- Route_Group::put()
- Route_Group::delete()
- Route_Group::authentication()
- Route_Group::argument()
Route_Factory
As most of the time you will be creating endpoints with a fixed namespace, there is a factory that can be used to populate this for every route it creates, while giving a clean, fluent API that can be used to create routes inline as part of arrays and return values.
Both of the above endpoints will be created with the my_endpoints/v2
namespace.
Method Helpers
There are a collection of helper methods on the Route_Factory
which make it really easy to add methods to the existing namespace.
It is even possible to create a group around the same route.
Route Controller
The easiest way to define routes, is to extend the Route_Controller
abstract class. This can be created with a predefined protected ?string $namespace;
property and a method for defining the routes/group abstract protected function define_routes( Route_Factory $factory): array
See the example above
Manual Route Creation
If you do not wish to use the Route Controller above, you will need create an instance of the Route_Manager
class and add your route or groups to the manager and the execute the manager before rest_init
hook is called.
When
execute()
is called, it will create therest_init
hooks, so there is no need to doadd_action(...)
Previous Versions
- For Perique 1.4. use Route 1.0.
- For Perique 1.0 - 1.3. use Route 0.1.
Change Log
- 2.0.1 Update dependencies and extended tests to cover WP6.3 & WP6.4
- 2.0.0 Support for Perique 2.0
- 1.0.1 Update readme/docs
- 1.0.0 Update dev testing dependencies for WP6.1, Remove Utils and replace all with FunctionConstructors and updated docs to use
construct_registration_middleware()
rather than being given a constructed instance of the Middleware. - 0.1.2 Update dev testing dependencies for WP6.0
- 0.1.1 Bumped to version 0.2.0 of PinkCrab Collection Dependency
- 0.1.0 Inital version
All versions of perique-route with dependencies
pinkcrab/perique-framework-core Version 2.0.*
pinkcrab/collection Version ^0.1.0
pinkcrab/wp-rest-schema Version *
pinkcrab/function-constructors Version ^0.2.0