Cara menggunakan fungsi SOAP dalam PHP

Dengan perkembangan Internet, perkhidmatan Web telah menjadi semakin popular dan telah menjadi cara penting bagi banyak perniagaan dan organisasi untuk bertukar-tukar data. SOAP (Simple Object Access Protocol) ialah protokol komunikasi berasaskan XML yang boleh digunakan dalam perkhidmatan Web. Dalam artikel ini, kami akan memperkenalkan cara menggunakan fungsi SOAP dalam PHP.

1. Pengenalan kepada SOAP
SOAP ialah protokol berasaskan XML yang mentakrifkan satu siri peraturan untuk bertukar maklumat antara perkhidmatan Web. Menurut spesifikasi SOAP, kita boleh menggunakan HTTP, SMTP, TCP dan protokol lain untuk menghantar mesej SOAP. Struktur mesej SOAP adalah seperti berikut:

<?xml version="1.0" encoding="UTF-8">
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <m:hello xmlns:m="http://example.org">
      <m:name>张三</m:name>
    </m:hello>
  </soap:Body>
</soap:Envelope>

Antaranya, elemen <soap:Envelope> digunakan untuk membalut keseluruhan mesej SOAP, dan elemen <soap:Body> digunakan untuk membungkus permintaan operasi tertentu (seperti sebagai kaedah hello). Kita boleh menggunakan elemen ini Tambah parameter khusus supaya pelayan boleh mengendalikan permintaan dengan betul.

2. Fungsi SOAP dalam PHP
PHP menyediakan satu siri fungsi SOAP untuk memudahkan pelaksanaan klien dan pelayan SOAP. Fungsi SOAP yang biasa digunakan adalah seperti berikut:

1. soap_client(): digunakan untuk mencipta klien SOAP.

   $soapClient = soap_client($wsdl, $options);

Perihalan parameter:

• $wsdl: URL fail WSDL (Bahasa Penerangan Perkhidmatan Web) perkhidmatan Web.
• $options (pilihan): tatasusunan bersekutu yang boleh menetapkan beberapa pilihan klien SOAP.

2. soap_call(): digunakan untuk memanggil perkhidmatan web jauh.

   $result = soap_call($soapClient, $method, $params);

Perihalan parameter:

• $soapClient: Pelanggan SOAP yang dibuat melalui fungsi soap_client().
• $method: Nama kaedah jauh yang perlu dipanggil.
• $params (pilihan): Tatasusunan bersekutu yang mengandungi parameter yang dihantar kepada kaedah jauh.

3. soap_fault(): Mengembalikan maklumat ralat yang berlaku semasa panggilan SOAP.

   if (soap_fault($result)) {
     echo "SOAP Fault: " . $result->faultcode . " " . $result->faultstring;
   } else {
     // 处理返回值
   }

Perihalan parameter:

• $result: Nilai pulangan bagi fungsi soap_call().

3. Aplikasi demonstrasi
Kami menggunakan contoh mudah untuk menunjukkan cara menggunakan fungsi SOAP dalam PHP untuk mengakses perkhidmatan web jauh.

Andaikan kita mempunyai perkhidmatan web jauh yang menambah dua nombor dan mengembalikan hasilnya. Kod sebelah pelayan adalah seperti berikut:

// add.php
$server = new soap_server;
$server->configureWSDL('add', 'http://example.org/add');

$server->register(
  'add',
  array('a' => 'xsd:int', 'b' => 'xsd:int'),
  array('result' => 'xsd:int'),
  'http://example.org/add#add'
);

function add($a, $b) {
  return $a + $b;
}

$HTTP_RAW_POST_DATA = isset($HTTP_RAW_POST_DATA) ? $HTTP_RAW_POST_DATA : '';
$server->service($HTTP_RAW_POST_DATA);

Kod di atas menggunakan objek soap_server PHP untuk mencipta perkhidmatan Web bernama add, yang mendedahkan kaedah jauh bernama add Kaedah ini Menerima dua integer hujah dan mengembalikan jumlah mereka. Pelayan mengendalikan permintaan pelanggan melalui kaedah service yang disediakan oleh PHP.

Kod klien adalah seperti berikut:

// client.php
$wsdl = 'http://example.org/add.wsdl';
$soapClient = soap_client($wsdl);

$a = 2;
$b = 3;

$result = soap_call($soapClient, 'add', array('a' => $a, 'b' => $b));

if (soap_fault($result)) {
  echo "SOAP Fault: " . $result->faultcode . " " . $result->faultstring;
} else {
  echo "Result: " . $result;
}

Kod di atas mencipta klien SOAP melalui fungsi soap_client() dan kemudian memanggil kaedah add pelayan. Akhir sekali, gunakan fungsi soap_fault() untuk menentukan sama ada terdapat ralat, dan jika tidak, keluarkan hasil pulangan.

4. Ringkasan
Protokol SOAP ialah protokol standard untuk bertukar-tukar maklumat antara perkhidmatan Web Melalui fungsi SOAP yang disediakan oleh PHP, kami boleh melaksanakan dengan mudah klien dan pelayan perkhidmatan Web. Artikel ini memperkenalkan fungsi SOAP yang biasa digunakan dalam PHP dan menunjukkan cara untuk mengakses perkhidmatan web jauh melalui contoh. Saya percaya bahawa pembaca akan mempunyai pemahaman yang lebih mendalam tentang penggunaan protokol SOAP dan fungsi SOAP dalam PHP selepas mempelajari artikel ini.

Atas ialah kandungan terperinci Cara menggunakan fungsi SOAP dalam PHP. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!