Signatur
Beschreibung
Soap\Url ist eine interne PHP-Klasse, die im Rahmen der SOAP-Erweiterung eine URL als typisiertes Objekt kapselt. Sie wird typischerweise verwendet, um SOAP-Endpunkte, Namespace-URIs oder ähnliche adressbasierte Informationen strukturiert zu speichern und weiterzugeben.
Die Klasse ermöglicht eine saubere objektorientierte Handhabung von URLs im SOAP-Kontext, anstatt rohe Strings zu übergeben. So wird die Typsicherheit erhöht und die Schnittstelle der SOAP-API konsistenter gestaltet.
Objekte dieser Klasse werden häufig intern von der SOAP-Erweiterung erzeugt und verarbeitet – etwa beim Auflösen von WSDL-Dokumenten oder beim Aufbau von Anfragen. Entwickler können die Klasse aber auch direkt instanziieren, um eigene URL-Werte zu übergeben.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $url Pflicht | string | Die vollständige URL-Zeichenkette (z. B. 'https://example.com/soap/endpoint'), die das Objekt repräsentieren soll. |
Beispiele
Einfaches Erstellen eines Soap\Url-Objekts
<?php
$url = new Soap\Url('https://example.com/soap/service');
var_dump($url);Verwendung im SOAP-Client-Kontext
<?php
// Beispielhafte Verwendung im erweiterten SOAP-Kontext
$endpointUrl = new Soap\Url('https://api.example.com/soap/v1');
// Der Wert kann z.B. an interne SOAP-APIs übergeben werden
echo $endpointUrl->url;// Wichtig · Fallstricke
Hinweis: Soap\Url ist eine vergleichsweise neue und interne Klasse der SOAP-Erweiterung (eingeführt in PHP 8.4). Die öffentliche API dieser Klasse – insbesondere verfügbare Eigenschaften und Methoden – kann sich in zukünftigen PHP-Versionen noch ändern, da sie als Teil laufender Refaktorierungsarbeiten an der SOAP-Erweiterung eingeführt wurde.
Es empfiehlt sich, URLs stets zu validieren, bevor sie an SOAP-Endpunkte übergeben werden, da ungültige URLs zu schwer nachvollziehbaren Laufzeitfehlern führen können. Verwende dazu z.B. filter_var($url, FILTER_VALIDATE_URL).