Interacting cum TrinityCore utens SOAP (TBD)

2024-07-12

original: SOAP with TrinityCore | TrinityCore MMo Project Wiki

Quomodo cum TC penitus utens SOAP

SOAP stands for Simplex Object Access Protocollum et antiquior forma signorum substructio muneris interretialis accessus protocollo similis QUIETIS. Quamdiu necessariae figurae in loco sunt, pressionibus SOAP imperare potes mittere ad server Core Trinitati.
Viam bonam ad intellegendum SOAP est comparare TEMPORE RELICUM. Articulus sequens optime hoc explicat – https://smartbear.com/blog/soap-vs-rest-whats-the-difference/.
Praecipua differentia inter utrumque est quod SOAP tota in XML nititur ut responsa praebeat et stipendia recipiat. PHP methodos nonnullas praebet ad faciliorem hunc processum faciendam, sed in usu tuo fretus, cum XML familiari esse debes.

Configurationis

worldserver.conf
Fac uncinis in lima configuratione recte positi.


#    SOAP.Enable
#        Description: Enable soap service.
#        Default:     0 - (Disabled)
#                     1 - (Enabled)
SOAP.Enabled = 1
 
#    SOAP.IP
#        Description: Bind SOAP service to IP/hostname.
#        Default:     "127.0.0.1" - (Bind to localhost)
SOAP.IP = "127.0.0.1"
 
#    SOAP.Port
#        Description: TCP port to reach the SOAP service.
#        Default:     7878
SOAP.Port = 7878

Datae certae RBAC figurae accessus, ratio usoris etiam necessaria erit cum permissionibus utendi GM mandatorum. Posset utilem esse rationem ad hoc speciali ratione limitatum accessum creare, potius quam una persona adhibetur.

NOTE: In scribendo tempore TC 335a tantum sustinet HTTP, ut caveas ne hoc modo secreta mittas. Ponitur quod quidquid praemittitur, in claris textibus est, et a quovis legi potest.
Si per SOAP remotius coniungere cogitas, certa connexio curare debes. Accessus potentialis unus est per contrarium SSL procuratorem per apache vel nginx. Sed hoc extra ambitum huius ductoris non continebitur.

HTTP clientis prototyping

Sunt clientes celeriter nexum instituere et mandata consolari examinare;
TABELLARIUS: https://www.postman.com/ (network, desktop agent/client)
insomnia https://insomnia.rest/
Luscinia luscinia: https://nightingale.rest/
Singula varia offerunt omnia, sed tandem idem fere laborant. Gratias Jackpoz ad providendum gradus specificos pro Postman - https://www.postman.com/.
Postmanus venit in duos sapores: interface telae (velut procuratorem qui institui potest ad petitiones locales faciendas) et in applicatione desktop clientis plenae. Praecepta sunt eadem utrobique.
Sub "Opus meum" deprimendo "Import" invenire. Originali textu optionis uteris.
Effingo et crustulum sequentium JSON in archa textu. Fac quaeso ut documentorum update sub item.request.auth.basic ad GM usorem de quo antea.


{
  "info": {
    "name": "TC SOAP",
    "schema": "https://schema.getpostman.com/json/collection/v2.0.0/collection.json"
  },
  "item": [
    {
      "name": "server info",
      "request": {
        "auth": {
          "type": "basic",
          "basic": {
            "username": "CHANGEME",
            "password": "CHANGEME",
            "showPassword": false
          }
        },
        "method": "POST",
        "header": [],
        "body": {
          "mode": "raw",
          "raw": "<?xml version="1.0" encoding="utf-8"?>rn<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="urn:TC">rn<SOAP-ENV:Body>rn<ns1:executeCommand>rn<command>server info</command>rn</ns1:executeCommand>rn</SOAP-ENV:Body>rn</SOAP-ENV:Envelope>",
          "options": {
            "raw": {
              "language": "xml"
            }
          }
        },
        "url": "http://127.0.0.1:7878"
      },
      "response": []
    }
  ]
}

Putas de TC SOAP ut collectionem importare. Click Import.
Haec novam collectionem frequentabunt cum recta HTTP methodi (post) ac details sub LICENTIA et Corpus tabs.
Sub Corpore tab, vide XML payload et servo informationem mandatorum quae tibi prae-populata sunt.
Clicking "Mitte" petitionem subiciet et responsionem XML praebebit.
Ad dextrum latus interface Postman, a</> symbolum codicem PRAECISIO aperiet qui petitionem in linguam electionis tuae convertere potest.
Usus PHP
Ad correspondentiam TrinityCore cum PHP utens, debes efficere ut extensionem PHP-semonis habeas inauguratam. Fac etiam uteris versionem PHP quae adhuc strenue sustinetur. Exempla codicis in PHP7.4 ad PHP8.1 probata sunt.
In omnibus his exemplis, urna:TC URI modulus requiritur quod documentum WSDL non praebemus.
SoapClient-https://www.php.net/manual/en/class.soapclient.php


$command  = 'server info';
 
$opts = [
    'http' => [
        'header' => "Authorization: Basic " . base64_encode("USERNAME:PASSWORD")
    ]];
 
$client = new SoapClient($wsdl = null, [
    'stream_context' => stream_context_create($opts),
    'location' => 'http://127.0.0.1:7878',
    'uri' => 'urn:TC',
]);
 
try {
    $result = $client->executeCommand(new SoapParam($command, 'command'));
} catch (Exception $e) {
    die($e->getMessage());
}
 
echo $result;

Nota nos praeterire HTTP authoritatem fundamentalem capitis cum base64 usoris et tesserae encoded (a colonia separatum). Vel, tu posses omitterestream_contextparametrum, et pro includunt username et password in configuratione SoapClient tuam.


$command  = 'server info';
 
$client = new SoapClient($wsdl = null, [
    'location' => 'http://127.0.0.1:7878',
    'uri' => 'urn:TC',
    'login' => 'USERNAME',
    'password' => 'PASSWORD',
]);
 
try {
    $result = $client->executeCommand(new SoapParam($command, 'command'));
} catch (Exception $e) {
    die($e->getMessage());
}
 
echo $result;

Aut accessus finis est - sed ne seducamini! Basi 64 descriptam, non in se tutiorem facit.

Memento quod SOAP clientem solum defectiones coniungere, vel misconfigurationes agnoscere potest.Non cognoscet, si mandatum invalidum tibi praebuit . Ita est ad te ut eventus ad parse et arbiter an successus intentus fuit vel non. Output erit perinde ac si mandatum in console fecisti.

Postremo, si in extensione SOAP vel clienti inniti velis, formare potes XML payload et parse proveniens XML responsionis tibi. Te adhuc opus estCrispum extensiosed hoc fere in promptu est nisi per defaltam possit.


<?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope
    xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns1="urn:TC">
    <SOAP-ENV:Body>
        <ns1:executeCommand>
            <command>server info</command>
        </ns1:executeCommand>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>


$curl = curl_init();
 
curl_setopt_array($curl, [
    CURLOPT_POSTFIELDS => $payload, // $payload is the XML provided above
    CURLOPT_URL => 'http://127.0.0.1:7878',
    CURLOPT_TIMEOUT => 0,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        "Authorization: Basic " . base64_encode("{$user}:{$pass}"),
        'Content-Type: application/xml',
    ],
]);
 
$response = curl_exec($curl);
curl_close($curl);
echo $response;

Technology sharing