ZF Zend Framework

Behind the Site

Programmer's Reference Guide

Einführung in Zend_Currency
Zend_Currency
Zend Framework's Referenzhandbuch

Zend_Currency verwenden

Generelle Verwendung

Der einfachste Anwendungsfall in einer Anwendung ist die Verwendung des Gebietsschemas des Clients. Wenn man eine Instanz von Zend_Currency erstellt ohne eine Option anzugeben, wird das Gebietsschema des Clients verwendet um die richtige Währung zu setzen.

Beispiel #1 Erstellung einer Währung mit Client Einstellungen

Angenommen unser Client hat "en_US" als gewünschte Sprache in seinem Browser gesetzt. In diesem Fall wird Zend_Currency die Währung welche zu verwenden automatisch erkannt.

  1. $currency = new Zend_Currency();
  2.  
  3. // Siehe die Standardwerte welche vom Client abhängen
  4. // var_dump($currency);

Das erstellte Objekt würde jetzt die Währung "US Dollar" enthalten da dies die aktuell zugeordnete Währung für US (Vereinigte Staaten) ist. Es wurden auch andere Optionen gesetzt wie "$" für das Währungszeichen oder "USD" für die Abkürzung.

Hinweis: Die automatische Erkennung des Gebietsschemas funktioniert nicht immer
 Es ist zu beachten das die automatische Erkennung des Gebietsschemas nicht immer richtig funktioniert. Der Grund für dieses Verhalten liegt darin das Zend_Currency ein Gebietsschema benötigt welches eine Region enthält. Wenn der Client nur "en" als Gebietsschema setzt würde Zend_Currency nicht mehr wissen welches der mehr als 30 Länder gemeint ist. In diesem Fall wird eine Exception geworfen.
Ein Client könnte die Einstellungen des Gebietsschemas in seinem Browser auch unterdrücken. Das würde zum Problem führen dass die Einstellungen der eigenen Umgebung als Fallback verwendet werden und dies könnte auch zu einer Exception führen.

Erstellung einer Währung basierend auf einem Gebietsschema

Um diese Probleme mit dem Client zu vermeiden kann man das gewünschte Gebietsschema einfach manuell setzen.

  1. $currency = new Zend_Currency('en_US');
  2.  
  3. // Man könnte auch die 'locale' Option verwenden
  4. // $currency = new Zend_Currency(array('locale' => 'en_US'));
  5.  
  6. // Siehe die aktuellen Einstellungen welche auf 'en_US' fixiert sind
  7. // var_dump($currency);

Wie in unserem ersten Beispiel ist die verwendete Währung "US Dollar". Aber jetzt sind wir nicht mehr von den Einstellungen des Clients abhängig.

Zend_Currency unterstützt auch die Verwendung eines Anwendungsweiten Gebietsschemas. Man kann eine Instanz von Zend_Locale wie anbei gezeigt in der Registry setzen. Mit dieser Schreibweise vermeidet man das manuelle Setzen des Gebietsschemas für jede Instanz, wenn man das selbe Gebietsschema in der gesamten Anwendung verwenden will.

  1. // In der Bootstrap Datei
  2. $locale = new Zend_Locale('de_AT');
  3. Zend_Registry::set('Zend_Locale', $locale);
  4.  
  5. // Irgendwo in der Anwendung
  6. $currency = new Zend_Currency();

Erstellung einer Währung basierend auf einem Land

Zend_Currency ist auch in der Lage basierend auf einem angegebenen Land zu arbeiten indem intern Zend_Locale verwendet wird.

  1. $currency = new Zend_Currency('US');
  2.  
  3. // See the actual settings which are fixed to 'en_US'
  4. // var_dump($currency);

Hinweis: Uppercase territories
 When you know that you are using a territory, then you should uppercase it. Otherwise you could get an in your eyes false locale in return. For example, when you give "om" then you could expect "ar_OM" to be returned. But in fact it returns "om", as it's also a language.
Therefor always uppercase the input when you know that a territory is meant.

Einführung in Zend_Currency
Zend_Currency
Zend Framework's Referenzhandbuch

+ Add A Comment

Please do not report issues via comments; use the ZF Issue Tracker.

If you have a JIRA/Crowd account, we suggest you login first before commenting.

  • BBCode is allowed in the comment markup

    • Select a Version

    Languages Available

    Components

    Search the Manual

    • Navigation