PHP로 SOAP 및 RESTful 웹 서비스 구현하기

목차
1. 웹 서비스란 무엇인가?
   - 웹 서비스의 개념
   - SOAP와 REST의 차이점
2. SOAP 서비스 구현
   - SOAP 서버 설정
   - SOAP 클라이언트 설정
3. RESTful API 설계 및 구현
   - RESTful API의 개념
   - PHP로 RESTful API 구현
4. 코드 예제
5. 결론 및 추가 학습 자료

---

1. 웹 서비스란 무엇인가?

웹 서비스의 개념

웹 서비스(Web Service)는 네트워크를 통해 애플리케이션 간의 상호 작용을 가능하게 하는 소프트웨어 시스템입니다. 웹 서비스는 서로 다른 플랫폼과 기술 스택을 사용하는 시스템 간의 통신을 표준화된 방식으로 처리할 수 있습니다. 웹 서비스는 주로 SOAP(Simple Object Access Protocol)과 REST(Representational State Transfer) 두 가지 방식으로 구현됩니다.

SOAP와 REST의 차이점

- SOAP:
  - XML을 기반으로 하는 프로토콜로, 메시지를 교환하는 표준을 엄격하게 준수합니다.
  - 상태를 유지하지 않으며, WSDL(Web Services Description Language)을 사용하여 서비스 인터페이스를 정의합니다.
  - 더 복잡하지만 보안 및 트랜잭션 처리에 강력합니다.

- REST:
  - HTTP 프로토콜을 활용하는 아키텍처 스타일로, 리소스를 URI로 식별하고 HTTP 메서드(GET, POST, PUT, DELETE)를 사용합니다.
  - 간단하고 직관적이며, 다양한 데이터 형식(JSON, XML 등)을 지원합니다.
  - 클라이언트와 서버 간의 통신을 상태 비저장 방식으로 처리합니다.

---

2. SOAP 서비스 구현

SOAP 서버 설정

PHP에서 SOAP 서비스를 구현하려면 'SoapServer' 클래스를 사용합니다. SOAP 서버는 클라이언트의 요청을 받아들이고, 정의된 메서드를 실행하여 결과를 반환합니다.

<?php
class CalculatorService {
    public function add($a, $b) {
        return $a + $b;
    }

    public function subtract($a, $b) {
        return $a - $b;
    }
}

$options = array('uri' => 'http://localhost/soap');
$server = new SoapServer(null, $options);
$server->setClass('CalculatorService');
$server->handle();
?>

이 예제에서 'SoapServer'는 'CalculatorService' 클래스를 사용하여 SOAP 요청을 처리합니다. 'setClass' 메서드는 요청된 메서드를 실행할 클래스를 지정하며, 'handle' 메서드는 SOAP 요청을 받아들이고 처리합니다.

SOAP 클라이언트 설정

SOAP 클라이언트는 'SoapClient' 클래스를 사용하여 구현합니다. 클라이언트는 서버의 WSDL 파일이나 직접 URI를 사용하여 SOAP 서비스를 호출할 수 있습니다.

<?php
$options = array('location' => 'http://localhost/soap-server.php', 'uri' => 'http://localhost/soap');
$client = new SoapClient(null, $options);

$result = $client->add(5, 3);
echo "Result of addition: " . $result . "\n";

$result = $client->subtract(10, 7);
echo "Result of subtraction: " . $result . "\n";
?>

이 예제에서 'SoapClient'는 SOAP 서버에 요청을 보내고, 'add' 및 'subtract' 메서드를 호출하여 결과를 출력합니다.

---

3. RESTful API 설계 및 구현

RESTful API의 개념

RESTful API는 웹 서비스의 아키텍처 스타일로, 리소스를 URI로 식별하고 HTTP 메서드를 사용하여 클라이언트와 서버 간의 통신을 처리합니다. REST는 상태 비저장 방식으로 동작하며, 서버는 클라이언트의 상태를 유지하지 않습니다.

PHP로 RESTful API 구현

PHP에서 RESTful API를 구현하려면 HTTP 메서드를 처리하고, JSON 형식으로 데이터를 반환하는 방식이 일반적입니다. 다음은 간단한 RESTful API의 예제입니다:

<?php
header('Content-Type: application/json');

$requestMethod = $_SERVER["REQUEST_METHOD"];
$data = json_decode(file_get_contents("php://input"), true);

switch($requestMethod) {
    case 'GET':
        handleGetRequest();
        break;
    case 'POST':
        handlePostRequest($data);
        break;
    case 'PUT':
        handlePutRequest($data);
        break;
    case 'DELETE':
        handleDeleteRequest();
        break;
    default:
        echo json_encode(array("message" => "Invalid Request Method"));
        break;
}

function handleGetRequest() {
    echo json_encode(array("message" => "GET request handled"));
}

function handlePostRequest($data) {
    echo json_encode(array("message" => "POST request handled", "data" => $data));
}

function handlePutRequest($data) {
    echo json_encode(array("message" => "PUT request handled", "data" => $data));
}

function handleDeleteRequest() {
    echo json_encode(array("message" => "DELETE request handled"));
}
?>

이 예제에서는 '$_SERVER["REQUEST_METHOD"]'를 사용하여 HTTP 메서드를 확인하고, 각 메서드에 따라 다른 함수를 호출합니다. 각 함수는 요청에 대해 적절한 응답을 JSON 형식으로 반환합니다.

---

4. 코드 예제

다음은 SOAP 및 RESTful API를 구현하고 사용하는 예제입니다.

1. SOAP 서비스 구현:

<?php
class MathService {
    public function multiply($a, $b) {
        return $a * $b;
    }

    public function divide($a, $b) {
        if ($b == 0) {
            throw new Exception("Division by zero.");
        }
        return $a / $b;
    }
}

$options = array('uri' => 'http://localhost/soap');
$server = new SoapServer(null, $options);
$server->setClass('MathService');
$server->handle();
?>

2. SOAP 클라이언트 구현:

<?php
$options = array('location' => 'http://localhost/soap-server.php', 'uri' => 'http://localhost/soap');
$client = new SoapClient(null, $options);

try {
    $result = $client->multiply(6, 4);
    echo "Result of multiplication: " . $result . "\n";

    $result = $client->divide(20, 4);
    echo "Result of division: " . $result . "\n";
} catch (Exception $e) {
    echo "Error: " . $e->getMessage();
}
?>

3. RESTful API 구현:

<?php
header('Content-Type: application/json');

$requestMethod = $_SERVER["REQUEST_METHOD"];
$data = json_decode(file_get_contents("php://input"), true);

switch($requestMethod) {
    case 'GET':
        getProducts();
        break;
    case 'POST':
        addProduct($data);
        break;
    case 'PUT':
        updateProduct($data);
        break;
    case 'DELETE':
        deleteProduct();
        break;
    default:
        echo json_encode(array("message" => "Invalid Request Method"));
        break;
}

function getProducts() {
    $products = array(
        array("id" => 1, "name" => "Laptop", "price" => 999.99),
        array("id" => 2, "name" => "Mouse", "price" => 49.99)
    );
    echo json_encode($products);
}

function addProduct($data) {
    echo json_encode(array("message" => "Product added", "data" => $data));
}

function updateProduct($data) {
    echo json_encode(array("message" => "Product updated", "data" => $data));
}

function deleteProduct() {
    echo json_encode(array("message" => "Product deleted"));
}
?>

코드 분석:
- 첫 번째 예제는 SOAP 서버를 설정하여 'multiply' 및 'divide' 메서드를 제공하는 'MathService' 클래스를 구현합니다.
- 두 번째 예제는 SOAP 클라이언트를 사용하여 'multiply'와 'divide' 메서드를 호출하고, 결과를 출력합니다.
- 세 번째 예제는 간단한 RESTful API를 구현하여 제품 데이터를 처리합니다. GET, POST, PUT, DELETE 요청에 따라 다른 동작을 수행하고, JSON 형식으로 응답을 반환합니다.

---

5. 결론 및 추가 학습 자료

이번 글에서는 PHP로 SOAP 및 RESTful 웹 서비스를 구현하는 방법에 대해 알아보았습니다. SOAP는 표준화된 프로토콜로, 복잡한 트랜잭션이나 보안이 중요한 상황에서 유용하며, REST는 더 간단하고 유연한 방식으로 웹 서비스를 제공하는 데 적합합니다. 두 방식 모두 PHP에서 쉽게 구현할 수 있으며, 각각의 장단점을 이해하고 프로젝트 요구 사항에 맞게 선택하는 것이 중요합니다.

추가 학습 자료:
- [PHP 공식 문서 - SOAP](https://www.php.net/manual/en/book.soap.php) PHP에서 SOAP 서비스를 구현하고 사용하는 방법에 대한 공식 문서입니다.
- [REST API Tutorial](https://restfulapi.net/) RESTful API 설계 원칙과 모범 사례에 대한 가이드입니다.
- [Laravel RESTful API Development](https://laravel.com/docs/8.x/controllers#resource-controllers) Laravel을 사용하여 RESTful API를 개발하는 방법을 다룹니다.

---

이제 PHP로 SOAP 및 RESTful 웹 서비스를 구현하여 애플리케이션 간의 통신을 효과적으로 처리할 수 있습니다. 지속적인 학습과 실습을 통해 웹 서비스 개발 능력을 더욱 강화해보세요!