A REST Client Inside Your Laravel Projects

 

Laravel Compass is a package by David H. Sianturi providing a REST client inside your Laravel project:

Laravel Compass is an elegant REST assistant for the Laravel framework that you can use to test API calls and create API documentation. It provides endpoints automatically for GET, POST, PUT/PATCH, DELETE, various auth mechanisms, and other utility endpoints based on Laravel routes in your project.

Compass provides an SPA backend experience with your routes preloaded. That’s right, compass will automatically provide endpoints based on Laravel route definitions. If you’ve ever used Postman, the Laravel Compass UI will feel familiar:

You can learn more about this package, get full installation instructions, and view the source code on GitHub at davidhsianturi/laravel-compass.

Sources : https://laravel-news.com/

Read More

HTTP Client That Handles Retries and Logging

 

Gustavo Ocanto created an HTTP client on top of Guzzle that handles retries and logging. Typically you’d have some code like the following (and likely a try/catch too) if you need to retry an HTTP call:

use GuzzleHttp\Client;

$retry = 1;
$response = null;

do {
    $response = (new Client)->get('http://foo.com');
} while ($response === null && $retry <= 5);

With this client, you can achieve similar with the following code:

$response = (new Client)->retry(5)->get('http://foo.com');

If you need more granular control and want to tap into the retry routine, the package has an onRetry method:

$response = (new Client)->onRetry(function () {
    // Do stuff
})->get('http://foo.com');

You can learn more about this package, get full installation instructions, and view the source code on GitHub at gocanto/http-client.

Read More

Laravel REST API Response Builder

 

REST API Response Builder for Laravel is a package by Marcin Orlowski for building JSON API responses. According to the author, the package helps you with things like data conversion and localization:

ResponseBuilder is written for REST API developers by REST API developer and is based on my long-lasting experience on both “sides” (API dev and API consumer) of a variety of REST APIs. Lightweight, with simple to use public methods, covering multiple potential use-cases, on-the-fly data conversion, localization support, automatic error message building, support for chained APIs, and (hopefully) exhaustive documentation.

The simplest example provided by this package is returning the following from a controller:

return ResponseBuilder::success();

The resulting client JSON will look like the following:

{
  “success”: true,
  “code”: 0,
  “locale”: “en”,
  “message”: “OK”,
  “data”: null
}

If you want to build message codes for common errors in your API, you can do the following:

return ResponseBuilder::error(MyErrorCodes::SOME_CODE);

Which results in the following message if you passed the code 205:

{
   “success”: false,
   “code”: 250,
   “locale”: “en”,
   “message”: “Your error message for code 250”,
   “data”: null
}

Check out the detailed documentation for more examples of what this package provides. You can learn more about this package, get full installation instructions, and view the source code on GitHub at MarcinOrlowski/laravel-api-response-builder.

Read More

Laravel Validator Object-Oriented Wrapper

 

The Laravel Validator object-oriented wrapper package by Krzysztof Rewak provides a map of all string rules into chained methods. The builder helps you write object-oriented style rules that translate back into their string counterparts:

$validator = new ValidationBuilder();
$validator->validate("email", function (Field $field): void {
    $field->string()->required()->email(["rfc"])
});

$validator->getRules();
// ["email" => "string|required|email:rfc]

Here’s an example of nested validation rules:

$validator = new ValidationBuilder();
$validator->validateEach("tags", function (Field $field): void {
    $field->array();
});
$validator->validateInEach("id", "tags", function (Field $field): void {
    $field->required()->exists("tags", "id");
});

$validator->getRules();
// ["tags.*:" => "array", "tags.*.id:" => "required|exists:tags,id"]

And finally, you can also use the builder in form requests:

/**
 * @return array
 */
public function rules(): array
{
    $this->builder->validate("email", function (Field $field): void {
        $field->required()->string()->email()->unique("users", "email");
    });
    $this->builder->validate("password", function (Field $field): void {
        $field->required()->string()->min(6)->confirmed();
    });

    return $this->builder->getRules();
}

You can learn more about this package, get full installation instructions, and view the source code on GitHub at krzysztofrewak/laravel-oop-validator.

This package was submitted to our Laravel News Links section. Links is a place the community can post packages and tutorials around the Laravel ecosystem.

Read More