Common Laravel Package

What's Changed

• Fixed 8.4 deprecation inside AbstractClient by @whjposch in https://github.com/thephpleague/omnipay-common/pull/283

New Contributors

• @whjposch made their first contribution in https://github.com/thephpleague/omnipay-common/pull/283

Full Changelog: https://github.com/thephpleague/omnipay-common/compare/v3.5.0...v3.5.1

What's Changed

• Add support for PHPUnit 10+ to CI process by @leith in https://github.com/thephpleague/omnipay-common/pull/276
• ci: add tests for PHP 8.5 by @Chris53897 in https://github.com/thephpleague/omnipay-common/pull/278
• test: remove deprecated annotation expectException by @Chris53897 in https://github.com/thephpleague/omnipay-common/pull/280
• Remove @doesNotPerformAssertions annotations by @Chris53897 in https://github.com/thephpleague/omnipay-common/pull/279
• Symfony 8 support by @arokettu in https://github.com/thephpleague/omnipay-common/pull/281
• Allow new PSR interfaces by @barryvdh in https://github.com/thephpleague/omnipay-common/pull/282

Full Changelog: https://github.com/thephpleague/omnipay-common/compare/v3.4.0...v3.5.0

What's Changed

• Make typed parameters explicitly nullable (PHP 8.4 compatibility) by @arokettu in https://github.com/thephpleague/omnipay-common/pull/271
• Make typed parameters explicitly nullable (#271 errata) by @arokettu in https://github.com/thephpleague/omnipay-common/pull/272
• Test PHP8.4 by @barryvdh in https://github.com/thephpleague/omnipay-common/pull/273
• Remove unused imported function and interface by @10n in https://github.com/thephpleague/omnipay-common/pull/259
• Fix deprecated issues by @barryvdh in https://github.com/thephpleague/omnipay-common/pull/274

New Contributors

• @10n made their first contribution in https://github.com/thephpleague/omnipay-common/pull/259

Full Changelog: https://github.com/thephpleague/omnipay-common/compare/v3.3.0...v3.4.0

What's Changed

• Feature/add support symfony 7 by @Chris53897 in https://github.com/thephpleague/omnipay-common/pull/264
• chore: bump github actions for "actions/checkout" 2 => 4 by @Chris53897 in https://github.com/thephpleague/omnipay-common/pull/263
• ci: run --prefer-lowest run only for lowest supported PHP version by @Chris53897 in https://github.com/thephpleague/omnipay-common/pull/266
• docs: improve README.md by @Chris53897 in https://github.com/thephpleague/omnipay-common/pull/265

New Contributors

• @Chris53897 made their first contribution in https://github.com/thephpleague/omnipay-common/pull/264

Full Changelog: https://github.com/thephpleague/omnipay-common/compare/v3.2.1...v3.3.0

Support Symfony 6

Officially test and support PHP8. Drop old PHP versions because of PHPUnit 9

Fixes #217

Support Symfony 5

v3.0.0 - 2018-05-14

Omnipay 3.0 focuses on separation of the HTTP Client, to be independent of Guzzle. This release brings compatibility with the latest Symfony 3+4 and Laravel 5. The breaking changes for applications using Omnipay are kept to a minimum.

Upgrading applications from Omnipay 2.x to 3.x

Breaking changes

• The redirect() method no calls exit() after sending the content. This is up to the developer now.
• An HTTP Client is required. Guzzle will be installed when using omnipay/omnipay, but otherwise you need to required your own implementation (see PHP HTTP Clients)

Added

• It is now possible to use setAmountInteger(integer $value) to set the amount in the base units of the currency.
• Support for Money for PHP objects are added, by using setMoney(Money $money) the Amount and Currency are set.

Upgrading Gateways from 2.x to 3.x

The primary difference is the HTTP Client. We are now using HTTPlug (http://httplug.io/) but rely on our own interface.

Breaking changes

• Change typehint from Guzzle ClientInterface to Omnipay\Common\Http\ClientInterface
• $client->get('..')/$client->post('..') etc are removed, you can call $client->request('GET', '').
• No need to call $request->send(), requests are sent directly.
• Instead of $client->createRequest(..) you can create+send the request directly with $client->request(..).
• When sending a JSON body, convert the body to a string with json_encode() and set the correct Content-Type.
• The response is a PSR-7 Response object. You can call $response->getBody()->getContents() to get the body as string.
• $response->json() and $response->xml() are gone, but you can implement the logic directly.
• An HTTP Client is no longer added by default by omnipay/common, but omnipay/omnipay will add Guzzle. Gateways should not rely on Guzzle or other clients directly.
• $body should be a string (eg. http_build_query($data) or json_encode($data) instead of just $data).
• The $headers parameters should be an array (not null, but can be empty)

Examples:

// V2 XML:
 $response = $this->httpClient->post($this->endpoint, null, $data)->send();
 $result = $httpResponse->xml();

// V3 XML:
 $response = $this->httpClient->request('POST', $this->endpoint, [], http_build_query($data));
 $result = simplexml_load_string($httpResponse->getBody()->getContents());

// Example JSON request:

 $response = $this->httpClient->request('POST', $this->endpoint, [
     'Accept' => 'application/json',
     'Content-Type' => 'application/json',
 ], json_encode($data));
 
 $result = json_decode($response->getBody()->getContents(), true);

Testing changes

PHPUnit is upgraded to PHPUnit 6. Common issues:

• setExpectedException() is removed

// PHPUnit 5:
$this->setExpectedException($class, $message);

// PHPUnit 6:
$this->expectException($class);
$this->expectExceptionMessage($message);

• Tests that do not perform any assertions, will be marked as risky. This can be avoided by annotating them with [@doesNotPerformAssertions](https://github.com/doesNotPerformAssertions)

Adds setAmountInteger instead of the Money object. getMoney() is used to private, gateways should use the getAmount or getAmountInteger instead. This is a BC break between the v3-betas, but same as v2.

Uses our own Exceptions instead of the PSR package (with unknown timeline)

Should be a public API freeze hopefully :)

Implement PSR-18 Exceptions

• Remove ResponseParser
• Renamed/removed methods for the Client, just use $client->request('GET', '/path', ...)
• Added ClientInterface

• Allow Symfony HttpFoundation 3.x
• Add new MasterCard "2" series BIN range support
• Improve test coverage

Incorporating outstanding PRs. This includes changed functionality about the use and detection of card brands.

Incorporated outstanding PRs, mostly minor/cosmetic/docblock changes.

Adds notification interfaces

Fix composer issue

Added better documentation

Update composer to include all third party gateways, as well as those supported by the package directly.