wNet::getUrlHead

Führt eine HEAD-Anfrage aus und liefert die Header-Daten
(verfügbar ab CMS-Version 020.002.036.000)

Funktionsaufruf

String getUrlHead(String url, Array options)

Parameter

url

Anzufragende URL (z.B. http://domain.dd)

options

User-Agent: Client-Bezeichnung
Cookie: Cookie-String
max-redirects: Maximale Anzahl der zu berücksichtigenden Weiterleitungen. Ist kein Wert angegeben, werden fünf Weiterleitungen berücksichtigt.
httpAuthUser: Benutzername für eine HTTP-Authentifizierung
httpAuthPassword: Passwort für eine HTTP-Authentifizierung

Beispiel: Führt eine HEAD-Anfrage aus und liefert die Header-Daten

Quelltext

<?php

// Falls Optionen (z.B. htaccess-Logindaten) mitgegeben werden sollen:
$options = array();
$options['httpAuthUser']     = '';
$options['httpAuthPassword'] = '';

$url = 'http://www.weblication.de';

var_dump(wNet::getUrlHead($url, $options));

?>

Hinweis
Beim Einsatz von Framework-Funktionen in eigenen Skripten beachten Sie bitte den Artikel "So verwenden Sie das PHP-Framework in eigenen Scripten".
Wenn Sie eine Funktion innerhalb einer Weblication® Seite z.B. über das PHP-Quelltext Element oder in einem XSL-Template über wsl:php einbinden, muss das Framework über die grid.php nicht mehr referenziert werden.

FAQs

Wofür ist wNet::getUrlHead gedacht?: wNet::getUrlHead führt eine HEAD-Anfrage an eine angegebene URL aus und liefert die dabei erhaltenen Header-Daten. Die Funktion ist ab der CMS-Version **020.002.036.000** verfügbar.
Wie lautet die Signatur von wNet::getUrlHead?: Die Funktion hat den Aufruf: <code class="codeInline">String getUrlHead(String url, Array options)</code>.
Welche Parameter benötigt wNet::getUrlHead?: <code class="codeInline">url</code>: Die anzufragende URL (z.B. <code class="codeInline">http://domain.dd</code>). <code class="codeInline">options</code>: Optionen zur Anfrage, insbesondere z.B. **User-Agent**, **Cookie** sowie Authentifizierungs- und Redirect-Einstellungen.
Wie kann ich die Anzahl der Weiterleitungen (Redirects) steuern?: Mit der Option <code class="codeInline">max-redirects</code> kannst du die maximale Anzahl der zu berücksichtigenden Weiterleitungen festlegen. Wenn kein Wert angegeben ist, werden standardmäßig **fünf** Weiterleitungen berücksichtigt.
Wie setze ich eine HTTP-Authentifizierung für die HEAD-Anfrage?: Über <code class="codeInline">httpAuthUser</code> und <code class="codeInline">httpAuthPassword</code> kannst du einen Benutzernamen und ein Passwort für eine HTTP-Authentifizierung angeben.
Wie kann ich Cookie-Daten für die Anfrage mitgeben?: Du kannst in <code class="codeInline">options</code> einen **Cookie-String** übergeben (Option: <code class="codeInline">Cookie</code>). Dieser wird dann für die HEAD-Anfrage verwendet.
Kann ich einen User-Agent für die Anfrage angeben?: Ja. In <code class="codeInline">options</code> kannst du die Client-Bezeichnung bzw. den **User-Agent** für die Anfrage angeben.
Wie sieht ein Beispiel für den Funktionsaufruf aus?: Beispiel (vereinfacht): <pre><code class="codeBlock" style="color: #000000">php $options = array(); $options['httpAuthUser'] = ''; $options['httpAuthPassword'] = ''; $url = 'http://www.weblication.de'; var_dump(wNet::getUrlHead($url, $options)); </code></pre>
Ab welcher CMS-Version ist wNet::getUrlHead verfügbar?: wNet::getUrlHead ist ab der CMS-Version **020.002.036.000** verfügbar.