PHP ile SOAP iletişimi

Adı : PHP ile SOAP iletişimi

SOAP (Simple Object Access Protocol), Web servislerinde kullanılan bir protokol olup, XML tabanlıdır ve farklı platformlardan gelen uygulamalar arasında veri değişimini sağlar. PHP, SOAP protokolü ile iletişim kurmak için özel kütüphaneler içerir.
Bu yazıda, PHP ile SOAP iletişimine birçok farklı örnek vereceğiz.
SOAP Web Servisi Çağırma
SOAP web servislerini çağırmak için, öncelikle kullanacağımız servisin WSDL (Web Services Description Language) dosyasına ihtiyacımız vardır. Bu dosya, web servisinin nasıl kullanılacağına ilişkin bilgiler içerir. Bu dosya indirildikten sonra, PHP’nin SOAP kütüphanesiyle ilgili sınıflarını kullanarak web servisine istek göndermek mümkündür.
Aşağıdaki örnek, bir SOAP web servisinin kullanımını göstermektedir:
```php
// WSDL URL
$wsdl = http://localhost:8080/soap.wsdl;
// Create client object
$client = new SoapClient($wsdl);
// Call web service method
$result = $client->getWeather(Ankara);
// Show result
echo $result;
```
Bu örnek, SOAP web servisinin WSDL dosyasını indirir ve web servisine bir istek gönderir. getWeather() metodu, parametre olarak şehir adını alır ve hava durumu bilgisini döndürür. Sonuç, ekrana yazdırılır.
SOAP Web Servisi Oluşturma
SOAP web servisleri oluşturmak, PHP tarafında oldukça kolaydır. Öncelikle, SOAP kütüphanesi tarafından sağlanan bir sınıf olan SoapServer sınıfını kullanarak bir sunucu nesnesi oluşturulur. Daha sonra, sunucunun kullanacağı PHP işlevleri tanımlanır ve sunucu başlatılır.
Aşağıdaki örnek, bir SOAP web servisi oluşturmayı göstermektedir:
```php
// Define web service
class WeatherService {
function getWeather($city) {
// Get weather information for $city
return Temperature: 22 C, Wind: 5 km/h;
}
}
// WSDL URL
$wsdl = http://localhost:8080/soap.wsdl;
// Create server object
$server = new SoapServer($wsdl);
// Register web service class
$server->setClass(WeatherService);
// Start server
$server->handle();
```
Bu örnek, getWeather() metodunu içeren WeatherService adlı bir sınıf tanımlar. Ardından, SoapServer sınıfı, WSDL dosyasının URL'sini belirterek oluşturulur. WeatherService sınıfı, setClass() metodu kullanılarak sunucuya kaydedilir. Son olarak, handle() metodu çağrılarak sunucu başlatılır.
SOAP İstemci Oturumları
Bir SOAP web servisi çağırıldığında, istemciler otomatik olarak bir oturum oluşturulur. Bu oturum, aynı sunucu üzerindeki bir sonraki istekler sırasında kullanılabilir. Bu, sunucunun her defasında kullanıcı kimlik bilgilerini yeniden kontrol etmek zorunda kalmamasını sağlar.
Aşağıdaki örnek, SOAP istemci oturumlarının nasıl kullanılacağını göstermektedir:
```php
// WSDL URL
$wsdl = http://localhost:8080/soap.wsdl;
// Create client object
$client = new SoapClient($wsdl);
// Create session
$session = $client->startSession(username, password);
// Get product information
$product = $client->getProductInformation($session, Product1);
// End session
$client->endSession($session);
```
Bu örnek, startSession() metodunu kullanarak bir oturum oluşturur. getProductInformation() metodu, bu oturumun varlığını belirten bir parametre alır. Son olarak, endSession() metodu kullanılarak oturum sonlandırılır.
SOAP Güvenliği
SOAP web servisleri, verilerin güvenli bir şekilde taşınmasını sağlamak için SSL (Secure Sockets Layer) kullanır. SSL, verilerin sunucu ve istemci arasında şifrelenerek gönderilmesini sağlar.
Aşağıdaki örnek, SOAP web servislerinde SSL kullanımını göstermektedir:
```php
// WSDL URL
$wsdl = https://localhost:8080/soap.wsdl;
// SSL options
$options = array(
uri => https://localhost:8080,
location => https://localhost:8080,
trace => true,
stream_context => stream_context_create(
array(
ssl => array(
verify_peer => false,
verify_peer_name => false,
)
)
)
);
// Create client object
$client = new SoapClient($wsdl, $options);
// Call web service method
$result = $client->getWeather(Ankara);
// Show result
echo $result;
```
Bu örnek, bir SSL bağlantısı kurarak SOAP web servisine istek göndermektedir. HTTP isteklerinden farklı olarak, SSL bağlantılarında belirtilen konum (location) ve URI üzerinde çalıştırılan protokol HTTPS'dir. Ayrıca, stream_context_create() fonksiyonu, SSL sertifika doğrulamasının devre dışı bırakılmasını sağlar.
SOAP Bileşenleri
SOAP protokolü, Web servisleri için çeşitli bileşenler sağlar. Bunlar, mesajlar, işlevler, bağlantılar ve kaynaklar gibi bileşenleri içerir.
SOAP mesajları, Web servislerinin temel yapı taşıdır. Bunlar, XML formatında gönderilen verileri içerir. Bir SOAP mesajı, başlık (header) ve gövde (body) bölümlerinden oluşur.
SOAP işlevleri, bir web servisinin fonksiyonlarını temsil eder. Bu işlevler, WSDL dosyası tarafından tanımlanır ve istemci tarafından çağrılır.
SOAP bağlantıları, bir istemcinin ve sunucunun arasındaki bağlantıyı sağlar. HTTP, HTTPS ve TCP gibi farklı protokoller, SOAP bağlantıları için kullanılabilir.
SOAP kaynakları, bir web servisinin kaynaklarına erişim sağlar. Kaynaklar, veritabanları, e-posta sunucuları ve dosya sunucuları gibi farklı kaynaklardan oluşabilir.
Sonuç olarak, SOAP kullanarak, Web servislerinin özelliklerinden yararlanarak, farklı platformlardaki uygulamalar arasında veri iletişimi sağlayabiliriz. Bu yazıda, PHP tarafında SOAP kullanımını birçok farklı örneklerle açıklamaya çalıştık.