wValues::getValue

Ermittelt einen Wert

Funktionsaufruf

String getValue(String key, String project = '', String path = '')

Parameter

Parameter	Beschreibung
key	Schlüssel des Wertes
project	Projektpfad der Werte
path	Pfad der Werte

Beispiel: Ermittelt einen Wert

Quelltext

<?php

  /*
    Beispiel-wValues-Datei-Inhalt:
<wValues version="5.0">
  <headline text="Geo-Koordinaten über PLZ (Breitengrad,Längengrad)"/>
  <value key="77694">48.5825760,7.8466080</value>
  <value key="77652">48.5005100,7.9419150</value>
</wValues>
  */
  
  $key          = '77694'; // Schlüssel des Wertes
  $project      = '/[IHR-LAYOUT-PROJEKT]'; // Projektpfad der Werte
  $path         = 'coordinates'; // Pfad der Werte ('coordinates' für z.B.: /[IHR-LAYOUT-PROJEKT]/wGlobal/content/values/coordinates.wValues.php)
  $valueDefault = '0,0'; // Standardwert, falls der Wert noch nicht existiert
  
  // Zugriff auf die Koordinaten einer Postleitzahl
  $coordinates = wValues::getValue($key, $project, $path, $valueDefault);
  print 'Ermittelte Koordinaten für PLZ <strong>'.$key.'</strong>: '.$coordinates;

?>

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 wValues::getValue gedacht?: wValues::getValue ermittelt einen Wert anhand eines Schlüssels (key) aus den Werte-Daten.
Wie lautet die Signatur von wValues::getValue?: String getValue(String key, String project = '', String path = '')
Was bedeutet der Parameter "key" bei wValues::getValue?: key ist der Schlüssel des gesuchten Wertes (z. B. ein PLZ-Schlüssel wie „77694“).
Wofür ist der Parameter "project" zuständig?: project ist der Projektpfad der Werte. Er bestimmt, aus welchem Projekt die Werte geladen werden (z. B. „/[IHR-LAYOUT-PROJEKT]“).
Was macht der Parameter "path" bei wValues::getValue?: path ist der Pfad der Werte (z. B. „coordinates“). Damit wird typischerweise z. B. auf „/[IHR-LAYOUT-PROJEKT]/wGlobal/content/values/coordinates…“ verwiesen (je nach konkreter Einbindung).
Wie kann man wValues::getValue in einem Beispiel verwenden?: Im Beispiel wird der Key und der Projektpfad gesetzt, sowie der Pfad „coordinates“. Anschließend wird der ermittelte Wert z. B. als Koordinaten für eine PLZ ausgegeben: $coordinates = wValues::getValue($key, $project, $path, $valueDefault);
Was sollte ich beachten, wenn ich Framework-Funktionen in eigenen Skripten nutze?: Beachten Sie beim Einsatz von Framework-Funktionen in eigenen Skripten den entsprechenden Artikel (Hinweis auf Framework-Einsatz/Best Practices).
Muss das Framework (grid.php) referenziert werden, wenn die Funktion in einer Weblication® eingebunden wird?: Nein. Wenn die Funktion innerhalb einer Weblication®-Seite z. B. über ein PHP-Quelltext-Element oder in einem XSL-Template über wsl:php eingebunden wird, muss das Framework über die grid.php nicht mehr referenziert werden.