PHP download

Download the PHP package apitte/negotiation without Composer

On this page you can find all versions of the php package apitte/negotiation. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

Table of contents
Download apitte/negotiation
More information about apitte/negotiation
Files in apitte/negotiation

Vendor apitte
Package negotiation
Short Description Content-Negotiation support for Apitte stack
License MIT
Homepage https://github.com/apitte/negotiation

Keywords negotiation content-negotiation apitte view-resolver

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:

If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.

Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
To use Composer is sometimes complicated. Especially for beginners.
Composer needs much resources. Sometimes they are not available on a simple webspace.
If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.

Please rate this library. Is it a good library?

Example code of apitte/negotiation

Informations about the package negotiation

Website 🚀 contributte.org | Contact 👨🏻‍💻 f3l1x.io | Twitter 🐦 @contributte

Disclaimer

:warning:	This project is no longer being maintained. Please use contributte/apitte.
Composer	`apitte/negotiation`
Version
PHP
License

Usage

To install the latest version of apitte/negotiation use Composer.

Documentation

Content negotiation for Apitte.

Transform response entity into response with unified format in dependence on Accept header and uri path suffix /api/v1/users(.json|.xml)

Setup

First of all, setup core package and enable CoreDecoratorPlugin.

Install and register negotiation plugin

Response

Instead of writing data into response body use $response->withEntity($entity) so transformers could handle transformation for you.

Entities

Value objects which are used to create response

ArrayEntity - create from array
ObjectEntity - create from stdClass
ScalarEntity - create from raw data

Error handling

Negotiations are implemented through an IErrorDecorator, which have higher priority than internal ErrorHandler so response is created from exception in an ITransformer and ErrorHandler only log that exception (if you use PsrLogErrorHandler)

Negotiators

Handle request and based on path suffix or request headers call appropriate transformer.

SuffixNegotiator

used for request with path suffix like /api/v1/users.json -> transformer for json suffix is used

DefaultNegotiator

called when none other transform
require annotation @Negotiation(default = true, suffix = "json") defined on endpoint - transformer for given suffix is looked for

FallbackNegotiator

used last if no other negotiator transformed response
uses json transformer by default

Transformers

Transformers convert entities and exceptions into response.

JsonTransformer

transform into json

JsonUnifyTransformer

transform into json with unified format

CsvTransformer

transform into csv
known limitation: data need to be a flat structure

Implementing transformer

register transformer for suffix xml, used for uris like /api/v1/users.xml
if fallback: true is defined and none of transformers matched then use that transformer

Version

State	Version	Branch	Nette	PHP
stable	`^0.8`	`master`	3.0+	`>=7.3`
stable	`^0.5`	`master`	2.4	`>=7.1`

Development

This package was maintained by these authors.

Consider to support contributte development team. Also thank you for being used this package.

All versions of negotiation with dependencies

PHP Build Version

Package Version

Version v0.8.0 Release 07. Sep 2021
create-project require 0 people chose require and
0 people chose create-project.

Download

Download latest version of negotiation from vendor apitte

Requires php Version >=7.3
apitte/core Version ~0.7 || ~0.8

Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package apitte/negotiation contains the following files

Loading the files please wait ...