Download the PHP package akamai-open/edgegrid-client without Composer

akamai-open/edgegrid-client

Akamai EdgeGrid Authentication for PHP

This library requires PHP 8+ and implements the Akamai EdgeGrid Authentication scheme on top of Guzzle as both a drop-in replacement client and middleware.

Installation

To install, use composer:

Alternative installation method

Download the PHAR file from the releases page and include it inside your code:

Use

The Akamai\Open\EdgeGrid\Client extends \GuzzleHttp\Client as a drop-in replacement. It works transparently to sign API requests without changing other ways you use Guzzle.

To use the client, call \Akamai\Open\EdgeGrid\Client->setAuth() or provide an instance of \Akamai\Open\EdgeGrid\Authentication to the constructor prior to making a request to an API.

Authentication

To generate your credentials, see Create authentication credentials.

We recommend using a local .edgerc authentication file. Place your credentials under a heading of [default] at your local home directory or the home directory of a web-server user.

You can call your .edgerc file one of two ways:

• Use the factory method \Akamai\Open\EdgeGrid\Client::createFromEdgeRcFile().

• Specify a credentials section and/or .edgerc location:

Command line interface

This library provides a command line interface (CLI) with a limited set of capabilities that mimic httpie.

Install

Install the CLI with composer vendor/bin/http or execute the PHAR file.

Arguments

You can set authentication and specify an HTTP method (case insensitive), its headers, and any JSON body fields.

Note: Our CLI shows all HTTP and body data. JSON is formated.

Limitations

• You cannot send multipart/mime (file upload) data.
• Client certs are not supported.
• Server certs cannot be verified.
• Output cannot be customized.
• Responses are not syntax highlighted.

Guzzle Middleware

This package provides three different middleware handlers you can add transparently when using the Client, to a standard \GuzzleHttp\Client or as a handler.

• The \Akamai\Open\EdgeGrid\Handler\Authentication for transparent API request signing.
• The \Akamai\Open\EdgeGrid\Handler\Verbose for output (or log) responses.
• The \Akamai\Open\EdgeGrid\Handler\Debug for output (or log) errors.

Transparent Use

Middleware

// Create the Authentication Handler
$auth = \Akamai\Open\EdgeGrid\Handler\Authentication::createFromEdgeRcFile();
// or:
$auth = new \Akamai\Open\EdgeGrid\Handler\Authentication;
$auth->setAuth($client_token, $client_secret, $access_token);

// Create the handler stack
$handlerStack = \GuzzleHttp\HandlerStack::create();

// Add the Auth handler to the stack
$handlerStack->push($auth);

// Add the handler to a regular \GuzzleHttp\Client
$guzzle = new \GuzzleHttp\Client([
    "handler" => $handlerStack
]);

// Create the handler stack
$handlerStack = HandlerStack::create();

// Add the Auth handler to the stack
$handlerStack->push(new \Akamai\Open\EdgeGrid\Handler\Verbose());

// Add the handler to a regular \GuzzleHttp\Client
$guzzle = new \GuzzleHttp\Client([
    "handler" => $handlerStack
]);

// Create the handler stack
$handlerStack = HandlerStack::create();

// Add the Auth handler to the stack
$handlerStack->push(new \Akamai\Open\EdgeGrid\Handler\Debug());

// Add the handler to a regular \GuzzleHttp\Client
$guzzle = new \GuzzleHttp\Client([
    "handler" => $handlerStack
]);

License

Copyright © 2022 Akamai Technologies, Inc. All rights reserved

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.