PHPで名前空間を活用した複数APIの効率的な統合方法

<?php
namespace MyApp\Services;

class ApiService {
    public function getData() {
        // APIからデータを取得する処理
    }
}

// 名前空間なしではクラス名の衝突が発生
$client1 = new ApiClient(); // API 1 のクライアント
$client2 = new ApiClient(); // API 2 のクライアント

use Api1\Client as Client1;
use Api2\Client as Client2;

$client1 = new Client1();
$client2 = new Client2();

<?php
namespace MyApp\Controllers;

class UserController {
    public function index() {
        // ユーザーの処理を行うメソッド
    }
}

$controller = new \MyApp\Controllers\UserController();
$controller->index();

use MyApp\Controllers\UserController;

$controller = new UserController();
$controller->index();

use MyApp\Controllers\UserController as UserCtrl;

$controller = new UserCtrl();
$controller->index();

namespace MyApp\Services\API;

class ApiService {
    public function fetch() {
        // API呼び出しの処理
    }
}

namespace Api1\Client;

class ApiClient {
    public function fetchData() {
        // API1からデータを取得
    }
}

namespace Api2\Client;

class ApiClient {
    public function fetchData() {
        // API2からデータを取得
    }
}

use Api1\Client\ApiClient as ApiClient1;
use Api2\Client\ApiClient as ApiClient2;

$client1 = new ApiClient1();
$data1 = $client1->fetchData();

$client2 = new ApiClient2();
$data2 = $client2->fetchData();

namespace ApiIntegration\REST;

class RestClient {
    public function fetchData() {
        // REST APIを使ってデータを取得
        $response = file_get_contents('https://example.com/api/resource');
        return json_decode($response, true);
    }
}

namespace ApiIntegration\SOAP;

class SoapClient {
    public function fetchData() {
        // SOAP APIを使ってデータを取得
        $client = new \SoapClient('https://example.com/soap?wsdl');
        return $client->getData();
    }
}

namespace External\SocialMedia;

class SocialMediaClient {
    public function getCampaignData() {
        // 外部REST APIからマーケティングデータを取得
        $response = file_get_contents('https://api.socialmedia.com/campaigns');
        return json_decode($response, true);
    }
}

namespace Internal\CRM;

class CRMClient {
    public function saveCustomerData($data) {
        // SOAP APIを使用して内部システムにデータを保存
        $client = new \SoapClient('https://crm.internal.com/api?wsdl');
        return $client->saveData($data);
    }
}

// 統合プロセス
use External\SocialMedia\SocialMediaClient;
use Internal\CRM\CRMClient;

$socialClient = new SocialMediaClient();
$crmClient = new CRMClient();

$data = $socialClient->getCampaignData();
$crmClient->saveCustomerData($data);

namespace PaymentGateway;

class PaymentClient {
    public function processPayment($orderData) {
        // 決済APIを使用した支払い処理
    }
}

namespace ShippingService;

class ShippingClient {
    public function createShipment($orderData) {
        // 配送APIを使用して出荷を作成
    }
}

namespace CRMService;

class CRMClient {
    public function updateCustomer($customerData) {
        // 顧客管理APIを使用してデータを更新
    }
}

// 統合プロセス
use PaymentGateway\PaymentClient;
use ShippingService\ShippingClient;
use CRMService\CRMClient;

$paymentClient = new PaymentClient();
$shippingClient = new ShippingClient();
$crmClient = new CRMClient();

$orderData = []; // 注文データの取得
$paymentClient->processPayment($orderData);
$shippingClient->createShipment($orderData);
$crmClient->updateCustomer($orderData['customer']);

namespace App\ApiClients\Payment;

class PaymentClient {
    public function processPayment($data) {
        // 決済APIを使った支払い処理
    }
}

namespace App\ApiClients\Shipping;

class ShippingClient {
    public function createShipment($order) {
        // 配送APIを使った出荷手続き
    }
}

namespace App\ApiClients\Customer;

class CustomerClient {
    public function updateCustomerData($customer) {
        // 顧客管理APIを使った顧客データ更新
    }
}

use App\ApiClients\Payment\PaymentClient;
use App\ApiClients\Shipping\ShippingClient;
use App\ApiClients\Customer\CustomerClient;

$paymentClient = new PaymentClient();
$shippingClient = new ShippingClient();
$customerClient = new CustomerClient();

$order = []; // 注文情報
$paymentClient->processPayment($order);
$shippingClient->createShipment($order);
$customerClient->updateCustomerData($order['customer']);

namespace App\ApiClients\Payment\v1;

class PaymentClientV1 {
    public function processPayment($data) {
        // 古い決済APIを使った処理
    }
}

namespace App\ApiClients\Payment\v2;

class PaymentClientV2 {
    public function processPayment($data) {
        // 新しい決済APIを使った処理
    }
}

/project-root
    /src
        /ApiClients
            /Payment
                PaymentClient.php
            /Shipping
                ShippingClient.php
            /Customer
                CustomerClient.php
    /public
        index.php

namespace App\ApiClients\Payment;

class PaymentClient {
    public function processPayment($order) {
        // 決済APIを呼び出して支払い処理を行う
        echo "Processing payment for order ID: " . $order['id'] . "\n";
        // 実際にはAPIエンドポイントへのHTTPリクエストがここで行われます
        return true;
    }
}

namespace App\ApiClients\Shipping;

class ShippingClient {
    public function createShipment($order) {
        // 配送APIを呼び出して出荷を作成する
        echo "Creating shipment for order ID: " . $order['id'] . "\n";
        // 実際には配送APIに注文情報を送信する処理がここで行われます
        return true;
    }
}

namespace App\ApiClients\Customer;

class CustomerClient {
    public function updateCustomerData($customer) {
        // 顧客管理APIを呼び出して顧客情報を更新する
        echo "Updating customer data for customer ID: " . $customer['id'] . "\n";
        // 実際には顧客管理APIにデータを送信する処理がここで行われます
        return true;
    }
}

require_once '../src/ApiClients/Payment/PaymentClient.php';
require_once '../src/ApiClients/Shipping/ShippingClient.php';
require_once '../src/ApiClients/Customer/CustomerClient.php';

use App\ApiClients\Payment\PaymentClient;
use App\ApiClients\Shipping\ShippingClient;
use App\ApiClients\Customer\CustomerClient;

$order = [
    'id' => 123,
    'customer' => ['id' => 456, 'name' => 'John Doe', 'email' => 'john@example.com'],
    'total' => 99.99
];

// 決済APIを呼び出して支払いを処理
$paymentClient = new PaymentClient();
if ($paymentClient->processPayment($order)) {
    echo "Payment successful!\n";

    // 支払いが成功したら、配送APIで出荷を作成
    $shippingClient = new ShippingClient();
    if ($shippingClient->createShipment($order)) {
        echo "Shipment created successfully!\n";
    }

    // 顧客情報を顧客管理APIに更新
    $customerClient = new CustomerClient();
    if ($customerClient->updateCustomerData($order['customer'])) {
        echo "Customer data updated successfully!\n";
    }
}

namespace App\ApiClients\Payment;

class PaymentClient {
    public function processPayment($order) {
        try {
            // 決済APIの呼び出し
            $response = file_get_contents('https://payment.example.com/api/pay', false, $this->getContext($order));
            if ($response === false) {
                throw new \Exception('Payment API request failed.');
            }

            $data = json_decode($response, true);
            if ($data['status'] !== 'success') {
                throw new \Exception('Payment failed: ' . $data['message']);
            }

            return true;
        } catch (\Exception $e) {
            // 例外発生時の処理
            echo 'Error: ' . $e->getMessage() . "\n";
            return false;
        }
    }

    private function getContext($order) {
        // APIリクエスト用のコンテキスト設定
    }
}

namespace App\ApiClients\Shipping;

class ShippingClient {
    public function createShipment($order) {
        try {
            // 配送APIの呼び出し
            $response = file_get_contents('https://shipping.example.com/api/ship', false, $this->getContext($order));
            if ($response === false) {
                throw new \Exception('Shipping API request failed.');
            }

            $data = json_decode($response, true);
            if ($data['status'] !== 'success') {
                throw new \Exception('Shipping failed: ' . $data['message']);
            }

            return true;
        } catch (\Exception $e) {
            // 例外発生時の処理
            echo 'Error: ' . $e->getMessage() . "\n";
            return false;
        }
    }

    private function getContext($order) {
        // APIリクエスト用のコンテキスト設定
    }
}

namespace App\ApiClients\Customer;

class CustomerClient {
    public function updateCustomerData($customer) {
        try {
            // 顧客管理APIの呼び出し
            $response = file_get_contents('https://crm.example.com/api/updateCustomer', false, $this->getContext($customer));
            if ($response === false) {
                throw new \Exception('Customer API request failed.');
            }

            $data = json_decode($response, true);
            if ($data['status'] !== 'success') {
                throw new \Exception('Customer update failed: ' . $data['message']);
            }

            return true;
        } catch (\Exception $e) {
            // 例外発生時の処理
            echo 'Error: ' . $e->getMessage() . "\n";
            return false;
        }
    }

    private function getContext($customer) {
        // APIリクエスト用のコンテキスト設定
    }
}

namespace App\ApiClients;

class BaseApiClient {
    protected function handleError($response) {
        if ($response === false) {
            throw new \Exception('API request failed.');
        }

        $data = json_decode($response, true);
        if (!isset($data['status']) || $data['status'] !== 'success') {
            throw new \Exception('API Error: ' . ($data['message'] ?? 'Unknown error.'));
        }

        return $data;
    }
}

namespace App\ApiClients\Payment;

use App\ApiClients\BaseApiClient;

class PaymentClient extends BaseApiClient {
    public function processPayment($order) {
        try {
            $response = file_get_contents('https://payment.example.com/api/pay', false, $this->getContext($order));
            $this->handleError($response);
            return true;
        } catch (\Exception $e) {
            echo 'Error: ' . $e->getMessage() . "\n";
            return false;
        }
    }

    private function getContext($order) {
        // APIリクエスト用のコンテキスト設定
    }
}

catch (\Exception $e) {
    error_log($e->getMessage());
    echo 'Error: ' . $e->getMessage() . "\n";
    return false;
}

namespace App\ApiClients\Payment;
namespace App\ApiClients\Shipping;
namespace App\ApiClients\Customer;

/src
    /ApiClients
        /Payment
            PaymentClient.php
        /Shipping
            ShippingClient.php
        /Customer
            CustomerClient.php

{
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    }
}

composer dump-autoload

namespace App\ApiClients;

class BaseApiClient {
    protected function handleError($response) {
        // エラーハンドリングの共通ロジック
    }
}

try {
    // API呼び出し
} catch (\Exception $e) {
    // エラー処理
    error_log($e->getMessage());
}

namespace App\ApiClients\Payment\v1;
namespace App\ApiClients\Payment\v2;

/**
 * PaymentClientクラス
 *
 * このクラスは決済APIへのリクエストを処理します。
 */
class PaymentClient {
    // クラスのコード
}