architectural improvements (#10)

* Request\Common\RequestOptions: add constructor with array options.

* Craftgate\Adapter\BaseAdapter: optimize createHttpHeaders() [array push issues].

* README: updates for RequestOptions inits.

* Simplify autoload stuff [add autoload.php, drop CraftgateBootstrap.php].

* Simplify RequestOptions inits.

* Add Util\Guid [drop insecure uniqid() calls].

* Move Util\AuthSignatureGenerator => Util\Signature, optimize.

* Make-ups.

* Add Util\Util, move & drop RequestQueryParamsBuilder into [also related test updated].

* Move lib/Craftgate => src/ [PSR compliance issue].

* Typo-fix.

* Update whitelist directory.

* Update all currency stuff [ISO-4217 compliance].

* Move Request\Common\RequestOptions => Options.

* Doc-ups.

* Apply DI stuff [also update related var names].

* Make Craftgate resource-friendly [on demand inits by related methods].

* Doc-ups [Accessor => Initializer].

* Options: add __debugInfo() & toArray() methods.

* Options: add BASE_URL constant & use for $baseUrl property [also fixes default (that mentioned on README) base-URL issue].

* Move Craftgate => Client.

* Move Adapter\BaseAdapter => AbstractAdapter [making abstract & dropping unneeded constructors in subs].

* Move Options => ClientOptions [proper naming].

* Doc-up.

* Refactor on HTTP & cURL stuff.

* Typo-fix.

* Fix/optimize Curl tests.

* Fix/optimize Curl tests [rework with try/catch blocks].

* Doc-ups.

* Make-ups on constant names.

* Adapter\PaymentAdapter: update checkout payment URL's.

* Adapter: move AbstractAdapter => BaseAdapter.

* ClientOptions: add SANDBOX_API_URL constant, move BASE_URL => API_URL.

* Move Client,ClientOptions => Craftgate,CraftgateOptions.

* Change Model\Currency::TRY => Model\Currency::TL.

* Move Util\Util => Util\QueryBuilder.

* Adapter\PaymentAdapter: resolve conflicts.

* Changes for "optimizes imports [bb8754d]" on resolve-conflicts branch.

* changes sample config and optimizes imports

* adds php 8.0 to version matrix

* upgrades php unit version

* removes php 8.0 support for builds

* reverts phpunit version

* fixes search members sample request

Co-authored-by: Sabri Onur Tüzün <[email protected]>

Author: krmgns

CraftgateBootstrap.php

@@ -20,43 +20,36 @@ composer require craftgate/craftgate
 ```
 
 ### Manual Installation
-You need to download the latest [release](https://github.com/craftgate/craftgate-php-client/releases) and copy to your project. Then, include the bootstrap file as shown below. This file will autoload all the class files into your project.
+You need to download the latest [release](https://github.com/craftgate/craftgate-php-client/releases) and copy to your project. Then, include the autoload file as shown below. This file will autoload all related classes into your project on-demand.
 
 ```php
-require_once('/path/to/craftgate-php-client/CraftgateBootstrap.php');
+require '/path/to/craftgate-php-client/autoload.php';
 ```
 
 ## Usage
 To access the Craftgate API you'll first need to obtain API credentials (e.g. an API key and a secret key). If you don't already have a Craftgate account, you can signup at [https://craftgate.io/](https://craftgate.io)
 
-Once you've obtained your API credentials, you can start using Craftgate by instantiating a `Craftgate` with your credentials.
+Once you've obtained your API credentials, you can start using Craftgate by instantiating a `Craftgate\Craftgate` with your credentials.
 
 ```php
-
-$options = new RequestOptions();
-$options->setApiKey('<YOUR API KEY>');
-$options->setSecretKey('<YOUR SECRET KEY>');
-
-$craftgate = new Craftgate($options);
-...
-
+$craftgate = new \Craftgate\Craftgate(array(
+    'apiKey' => '<YOUR API KEY>',
+    'secretKey' => '<YOUR SECRET KEY>',
+));
 ```
 
-By default the Craftgate client connects to the production API servers at `https://api.craftgate.io`. For testing purposes, please use the sandbox URL `https://sandbox-api.craftgate.io` using the .
+By default the Craftgate client connects to the production API servers at `https://api.craftgate.io`. For testing purposes, please use the sandbox URL `https://sandbox-api.craftgate.io`.
 
 ```php
-
-$options = new RequestOptions();
-$options->setApiKey('<YOUR API KEY>');
-$options->setSecretKey('<YOUR SECRET KEY>');
-$options->setBaseUrl('https://sandbox-api.craftgate.io');
-
-$craftgate = new Craftgate($options);
-
+$craftgate = new \Craftgate\Craftgate(array(
+    'apiKey' => '<YOUR API KEY>',
+    'secretKey' => '<YOUR SECRET KEY>',
+    'baseUrl' => 'https://sandbox-api.craftgate.io',
+));
 ```
 
 ## Examples
-Included in the project are a number of examples that cover almost all use-cases. Refer to [the `samples/` folder](./samples)] for more info.
+Included in the project are a number of examples that cover almost all use-cases. Refer to [the `samples/` folder](./samples) for more info.
 
 ### Running the Examples
 If you've cloned this repo on your development machine and wish to run the examples you can run an example with the command `./vendor/bin/phpunit`
@@ -67,12 +60,11 @@ Let's quickly review an example where we implement a credit card payment scenari
 > For more examples covering almost all use-cases, check out the [examples in the `samples/` folder](./samples)
 
 ```php
-$options = new RequestOptions();
-$options->setApiKey('<YOUR API KEY>');
-$options->setSecretKey('<YOUR SECRET KEY>');
-$options->setBaseUrl('https://sandbox-api.craftgate.io');
-
-$craftgate = new Craftgate($options);
+$craftgate = new \Craftgate\Craftgate(array(
+    'apiKey' => '<YOUR API KEY>',
+    'secretKey' => '<YOUR SECRET KEY>',
+    'baseUrl' => 'https://sandbox-api.craftgate.io',
+));
 
 $request = array(
     'price' => 100,
@@ -91,17 +83,17 @@ $request = array(
     ),
     'items' => array(
         array(
-            'externalId' => uniqid(),
+            'externalId' => \Craftgate\Util\Guid::generate(),
             'name' => 'Item 1',
             'price' => 30
         ),
         array(
-            'externalId' => uniqid(),
+            'externalId' => \Craftgate\Util\Guid::generate(),
             'name' => 'Item 2',
             'price' => 50
         ),
         array(
-            'externalId' => uniqid(),
+            'externalId' => \Craftgate\Util\Guid::generate(),
             'name' => 'Item 3',
             'price' => 20
         )
@@ -110,18 +102,17 @@ $request = array(
 
 $response = $craftgate->payment()->createPayment($request);
 
-print_r($response);
-
+var_dump($response);
 ```
 
 ### Advanced Usage: Adapters
-In reality, the `Craftgate` class serves as a collection of adapters that integrates with different parts of the API. While the intended usage for most use-cases is to instantiate a `Craftgate` instance (as illustrated in the examples above) and use its adapter accessors (e.g. `payment()`), you can also manually import a certain adapter class and instantiate it.
+In reality, the `Craftgate` class serves as a provider of adapters that integrates with different parts of the API. While the intended usage for most use-cases is to instantiate a `Craftgate` instance (as illustrated in the examples above) and use its adapter initializers (e.g. `payment()`).
 
 **Note:** When instantiating an adapter, you can use the same options as you would when instantiating a `Craftgate`
 
-For all adapters in the `Craftgate`, their purposes, accessors, as well as direct import paths, refer to the list below:
+All adapters in the `Craftgate` have their purposes and initializers that listed below:
 
-| Adapter Name | Purpose | Accessor |
+| Adapter Name | Purpose | Initializer |
 |--------------|---------|----------|
 | `InstallmentAdapter` | Retrieving per-installment pricing information based on installment count or BIN number | `installment()` |
 | `OnboardingAdapter` | Conducting CRUD operations on buyers and sub merchants | `onboarding()` |

README.md

@@ -0,0 +1,15 @@
+<?php
+
+namespace Craftgate;
+
+spl_autoload_register(function ($name) {
+    if (strpos($name, __NAMESPACE__) === 0) {
+        $name = substr($name, strlen(__NAMESPACE__) + 1);
+        $name = strtr($name, '\\', DIRECTORY_SEPARATOR);
+        ($file = realpath(
+            __DIR__ . DIRECTORY_SEPARATOR
+            . 'src' . DIRECTORY_SEPARATOR
+            . $name . '.php'
+        )) && require $file;
+    }
+});

autoload.php

@@ -20,12 +20,11 @@
         "ext-json": "*"
     },
     "require-dev": {
-        "phpunit/phpunit": "~4.0",
-        "satooshi/php-coveralls": "~0.6.1"
+        "phpunit/phpunit": "~4.0"
     },
     "autoload": {
         "psr-4": {
-            "Craftgate\\": "lib/Craftgate/"
+            "Craftgate\\": "src/"
         }
     },
     "autoload-dev": {