[[Vorlage(Getestet,  bionic, focal, jammy)]]

{{{#!vorlage Wissen
[:Pakete installieren: Installation von Programmen]
[:Terminal: Ein Terminal öffnen]
[:mit Root-Rechten arbeiten:]
[:Editor:Einen Editor öffnen]
[:PHP:PHP installieren und konfigurieren]
}}}

[[Inhaltsverzeichnis()]]
Die [https://www.php.net/manual/de/book.intl.php "intl"-Erweiterung] {en} von [:PHP:] ermöglicht es Entwicklern, Aufgabenstellungen, deren Ausgabe sich in verschiedenen Sprachen, oder genauer gesagt in [wikipedia:Gebietsschema:Gebietsschemas], unterscheidet,  zu automatisieren. Mit ihr kann man zum Beispiel die in der deutschen Sprache üblichen Formatierungen für Datums- und Zeitangaben, Dezimalzahlen und Währungsangaben korrekt ausgeben lassen.  (Siehe auch: [wikipedia:i18n:].)
= Installation =
Die Installation der "intl"-Erweiterung erfolgt mit folgendem Paket[1]:

{{{#!vorlage Paketinstallation
php-intl, universe
}}}
Bei einer serverseitigen Anwendung muss nun der Server neu geladen werden. Bei [:Apache:] zum Beispiel so:
{{{#!vorlage Befehl
sudo systemctl reload apache2
}}}
= Anwendung =

PHP unterstützt alle Gebietsschemas, deren [:Spracheinstellungen:Sprachpakete] unter Ubuntu zuvor installiert worden sind. Die Anwendung in PHP funktioniert nur, wenn man den __exakten__ Sprachpaketnamen verwendet, den auch Ubuntu verwendet. Die im System installierten Sprachpakete und ihre Bezeichnungen erfährt man durch die Eingabe im Terminal[2] von:

{{{#!vorlage Befehl
locale -a
}}}

Für das Gebietsschema Deutschland lautet die Bezeichnung dann zum Beispiel:
{{{
de_DE.utf-8
}}}
== In einem Skript ==
In einer beliebigen PHP-Datei kann man nun den gewünschten Sprachpaketnamen verwenden, zum Beispiel so[3]:
{{{#!code php
<?php
setlocale (LC_ALL,'de_DE.utf-8');
}}}
== Systemweit ==
Möchte man ein Gebietsschema als Standard für die gesamte PHP-Installation festlegen, so kann man dies in der [https://www.php.net/manual/de/configuration.file.php PHP-Konfigurationsdatei]  {de} festlegen. 
Hierfür im PHP-Konfigurationsverzeichnis (siehe: [:PHP/#Konfiguration:]) eine neue Datei anlegen, zum Beispiel[3]:
{{{#!vorlage Befehl
sudo touch /etc/php/PHP.VERSION/apache2/conf.d/99-myintl.ini
}}}
Dort folgendes mit einem Editor[4] eingeben:
{{{#!code ini
[intl]
intl.default_locale = GEWÜNSCHTES_GEBIETSSCHEMA
}}}

Für Deutschland sähe der entsprechende Eintrag also so aus:

{{{#!code ini
[intl]
intl.default_locale = de_DE.utf-8
}}}


Damit diese Änderungen serverseitig wirksam werden, müssen sie dem Webserver mittels dem jeweiligen `reload`-Befehl bekannt gemacht werden.

= Problembehebung =
== Fehlerdiagnose =
PHP gibt keine Fehlermeldungen aus, wenn die Festsetzung des Gebietsschemas fehl schlug. Man kann aber jederzeit in einem Skript überprüfen, ob das Definieren eines Gebietsschemas erfolgreich war. Folgende Funktion gibt das gesetzte Gebietsschema als [https://www.php.net/language.types.string String] {de} aus:
{{{#!code php
<?php
echo locale_get_default();
}}}

Man kann sich auch direkt bei der oben genannten Funktion `setlocale()` den Rückgabewert ausgeben lassen: 
{{{#!code php
<?php
var_dump(setlocale (LC_ALL,'de_DE.utf-8'));
}}}

Bei Erfolg wird hier die Bezeichnung des neu gesetzten Gebietsschemas als String ausgegeben. Schlug die Funktion fehl, wird "False" ausgegeben. 
== Fehlerursachen ==
Die häufigsten beiden Fehlerursachen sind:
 1. Das angegebene Gebietsschema ist nicht in der Ubuntuinstallation installiert.
 1. Das Gebietsschema wurde nicht exakt so angegeben, wie es in der Ubuntuinstallation bezeichnet wird.

So reicht es zum Beispiel __nicht__ `de_DE` anzugeben, wenn das Gebietsschema in Ubuntu eigentlich `de_DE.utf-8` lautet. Wie weiter oben unter [#Anwendung „Anwendung“] beschrieben, gibt der Befehl `locale -a` im Terminal alle Bezeichnungen der installierten Sprachpakte aus. Des weiteren ist zu beachten, dass dass die Angabe [wikipedia:Case sensitivity:case sensitive] ist, das heißt, dass auf Groß- und Kleinschreibung geachtet werden muss.
 
= Links =
 * [https://www.php.net/manual/de/book.intl.php Projektseite] {en}
 * [https://www.php.net/manual/de/book.gettext.php PHP Gettext Funktion] {de} - Implementierung der [http://www.gnu.org/software/gettext GNU gettext Software] {en} in PHP
 * [https://www.php.net/manual/en/class.resourcebundle.php PHP ResourceBundle class] {en} - Implementierung des [http://site.icu-project.org ICU Projektes] {en} in PHP

# tag: PHP, Server, Internet, Netzwerk, LAMP, Programmierung, Locales