Kako pomoću SOAP protokola slati/primati XML u PHP-u

Iako sam do sada radio isključivo s REST API-jem koristeći JSON u ovom ću blog postu pokazati kako pomoću SOAP protokola slati/primati XML u PHP-u.

Nekoliko stvari će biti pojašnjeno:
– kako treba izgledati XML kojeg šaljem kako bi dobio očekivani rezultat
– kako raspakirati dobiveni rezultat i od njega napraviti niz (array) podataka
– od čega se sastoji __doRequest metoda

XAMPP

S obzirom da ću sve raditi i testirati na lokalnom računalu potreban mi je XAMPP, jedno od popularnijih PHP razvojnih okruženja.

Ako lokalno želim koristiti SOAP protokol moram aktivirati SoapClient jer ću inače dobiti sljedeću grešku:

Aktivacija se vrši unutar Apache modula – ConfigPHP (php.ini).

SOAP XAMPP

Potrebno je pronaći ;extension=php_soap.dll i maknuti ; te nakon toga restartati Apache modul.

SOAP XAMPP

Postman

Prije nego krenem s izradom primjera u PHP-u moram se uvjeriti da API radi, a to ću napraviti kroz Postman.

Kod slanja zahtjeva na API moram pod Headers postaviti Content-Type: text/xml dok u Body ide XML u raw obliku.

Na prvom API-ju dobijem popis stanica.

SOAP XML Postman

Na drugom API-ju, nakon što pošaljem ID dvije stanice i datum, dobijem popis aktivnih stanica za odabrani datum.

SOAP XML Postman

PHP demo aplikacija

U službenoj dokumentaciji na adresi https://www.php.net/manual/en/class.soapclient.php saznao sam koje parametre trebam poslati kako bi dobio željeni rezultat.

__doRequest metoda me u ovom slučaju najviše zanima.

Iz priložene dokumentacije vidim da mi je potrebno četiri tj. pet parametara.

getStanice

string $request je zapravo XML koji sam u Postmanu slao kroz Body.

string $location je URL API-ja.

string $action je potrebno pronaći u dokumentaciji API-ja.

int $version označava verziju XML-a. U ovom slučaju to je 1.

Sve zajedno to izgleda ovako

Nakon što sam dobio rezultat $result trebam iz njega izvući nazive stanica tj. njihove ID-eve kako bi mogao kreirati select polja. Ovdje koristim getElementsByTagName() metodu.

[nodeValue]

print_r($popisStanica); daje sljedeći rezultat u kojemu gledam [nodeValue] unutar kojega se nalazi string sa svim podacima od pojedine stanice. Npr. [nodeValue] => idNAZIVgps1GPS2granicaZEMLJAIDnazivzemljeOZNAKA.

Od toga sada mogu kreirati dva select polja + polje za odabir datuma.

Krajnji rezultat su dva padajuća izbornika sa popisom stanica.

SOAP protokol

getLinije

string $request je zapravo XML koji sam u Postmanu slao kroz Body.

Parametre StanicaOd, StanicaDo i Datum dohvaćam dinamički putem forme kroz funkciju display().

string $location je URL API-ja.

string $action je potrebno pronaći u dokumentaciji API-ja.

int $version označava verziju XML-a. U ovom slučaju to je 1.

Sve zajedno to izgleda ovako

Nakon što sam dobio rezultat $result trebam iz njega izvući nazive stanica tj. njihove ID-eve, termine polaska, dolaska i ukupno trajanje putovanja kako bi mogao kreirati tablicu. Ovdje također koristim getElementsByTagName() metodu.

[nodeValue]

Krajnji rezultat izgleda ovako:

SOAP post

Prikaz vremena polaska, dolaska i trajanje mogu se pomoću jedne funkcije ljepše formatirati.

Krajnji rezultat sada izgleda ovako:

SOAP post

Zaključak

Cilj ovog blog posta bio je pokazati kako napraviti demo PHP aplikaciju pomoću koje se može primiti/poslati XML putem SOAP protokola.