teepluss / api
Laravel 4 Internal Request (HMVC)
Installs: 33 043
Dependents: 0
Suggesters: 0
Security: 0
Stars: 71
Watchers: 4
Forks: 24
Open Issues: 2
Requires
- php: >=5.3.0
- guzzle/guzzle: 3.9.1
- illuminate/support: 4.x
Requires (Dev)
- mockery/mockery: 0.7.2
This package is not auto-updated.
Last update: 2024-12-21 13:41:41 UTC
README
This package is no longer updated anymore, Now I've splited this package into 2.
API is a tool for making internal request (HMVC).
Installation
To get the lastest version of Theme simply require it in your composer.json
file.
"teepluss/api": "dev-master"
You'll then need to run composer install
to download it and have the autoloader updated.
Once Theme is installed you need to register the service provider with the application. Open up app/config/app.php
and find the providers
key.
'providers' => array(
'Teepluss\Api\ApiServiceProvider'
)
API also ships with a facade which provides the static syntax for creating collections. You can register the facade in the aliases
key of your app/config/app.php
file.
'aliases' => array(
'API' => 'Teepluss\Api\Facades\API'
)
Publish config using artisan CLI.
php artisan config:publish teepluss/api
Usage
API helping you to work with internal request.
Internal testing request.
// GET Request. API::get('user/1'); // POST Request. API::post('user', array('title' => 'Demo')); // PUT Request. API::put('user/1', array('title' => 'Changed')); // DELETE Request. API::delete('user/1'); // Internal request with domain route. API::invoke('http://api.domain.com', 'post', array('param' => 1)) // You can make remote request without changing code also. API::post('http://api.github.com', array('username' => 'teepluss')); // Request remote with invokeRemote. API::invokeRemote('http://api.github.com', 'post', array('username' => 'teepluss')); // Get Guzzle to use other features. $guzzle = API::getRemoteClient();
Remote request using Guzzle as an adapter.
Calling via artisan CLI.
// Internal GET. $ php artisan api:call --request GET /some/route?param=value // Internal POST. $ php artisan api:call --request POST /some/form --data "name=Tee" // Remote request. $ php artisan api:call --request GET http://google.com
also work with DELETE, PATCH, HEAD
Create reponses format for RESTful.
// Response entries. $users = User::all(); API::createResponse($users); // Response entry. $user = User::find($id); return API::createResponse($user); // Response Laravel error. $errors = $validation->messages()->all(':message'); return API::createResponse(compact('errors'), 400); // Response created data. $user = Url::create($data); return API::createResponse($user, 201); // Response 404. API::createResponse("User [$id] was not found.", 404); //Response deleted. API::createResponse(null, 204);
For RESTful response recommended to use Restable instead.
Changes
v1.0.1
- Add artisan CLI.
v1.0.0
- Release first master version.
Support or Contact
If you have some problem, Contact teepluss@gmail.com