haruncpi / wp-api
An elegant WordPress REST API routing system
v1.0.1
2023-12-15 05:42 UTC
Requires
- php: >=7.1.0
This package is not auto-updated.
Last update: 2024-12-13 10:30:20 UTC
README
An elegant WordPress REST API routing system.
Support
Documentation
Installation
composer require haruncpi/wp-api
Configuration
In your plugin init file, write this simple config code.
ApiConfig::set_route_file( __DIR__ . '/api-routes.php' ) ->set_namespace( 'MyPlugin\Api' ) ->init();
Route Define
Open api-routes.php
file and write route
Syntax
ApiRoute::get( $prefix, $endpoint, $callback, $auth = false ); ApiRoute::post( $prefix, $endpoint, $callback, $auth = false ); // Multiple route in a prefix group. ApiRoute::prefix( $prefix, function( ApiRoute $route ) { $route->get( $endpoint, $callback, $auth = false ); $route->post( $endpoint, $callback, $auth = false ); });
Where
$prefix
is your plugin name with api version. Example:myplugin/v1
- By default,
$auth
is false means the endpoint can be access without authentication. - To make a endpoint
secure
pass a callback in the place of$auth
Example
ApiRoute::get( 'myplugin/v1', '/me', 'ApiController@me' );
Secure route
ApiRoute::get( 'myplugin/v1', '/me', 'ApiController@me', 'AuthController@check' );
Various way to write callback.
ApiRoute::get( 'myplugin/v1', '/me', 'ApiController@me' );
ApiRoute::get( 'myplugin/v1', '/me', array( ApiController:class, 'me' ) );
ApiRoute::get( 'myplugin/v1', '/me', array( 'MyPlugin\Api\ApiController', 'me' ) );
ApiRoute::get( 'myplugin/v1', '/me', function() { // Do something. });
Multiple route register
ApiRoute::prefix( 'myplugin/v1', function( ApiRoute $route ) { $route->get( '/products', 'ApiController@products' ); $route->get( '/categories', 'ApiController@categories' ); });
With auth check
// With auth check ApiRoute::prefix( 'myplugin/v1', function( ApiRoute $route ) { $route->get( '/me', 'ApiController@me' ); $route->get( '/settings', 'ApiController@settings' ); $route->post( '/logout', 'ApiController@logout' ); })->auth( 'AuthController@check' );
Plugin Example
API Plugin is a WordPress example plugin for this composer package.