Signatur
Beschreibung
enchant_dict_add ergänzt das angegebene Wort in der persönlichen Wortliste des Wörterbuchs. Diese persönliche Liste ist benutzerspezifisch und wird dauerhaft gespeichert, sodass das Wort bei zukünftigen Rechtschreibprüfungen als korrekt erkannt wird.
Die Funktion ist besonders nützlich, wenn Benutzer eigene Fachbegriffe, Namen oder Abkürzungen zum Wörterbuch hinzufügen möchten, die von der Standardwortliste nicht abgedeckt werden. Nach dem Hinzufügen liefert enchant_dict_check für dieses Wort true zurück.
Wichtig: Das Wörterbuch-Objekt muss zuvor mit enchant_broker_request_dict oder enchant_broker_request_pwl_dict erstellt worden sein. Ab PHP 8.0 wird statt dem früheren Resource-Typ der Objekttyp EnchantDictionary verwendet.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $dictionary Pflicht | EnchantDictionary | Ein Enchant-Wörterbuch-Objekt, das zuvor über enchant_broker_request_dict oder enchant_broker_request_pwl_dict erzeugt wurde. |
|
| $word Pflicht | string | Das Wort, das der persönlichen Wortliste des Wörterbuchs hinzugefügt werden soll. |
Rückgabewert
Beispiele
Wort zur persönlichen Wortliste hinzufügen
<?php
// Enchant-Broker erstellen
$broker = enchant_broker_init();
// Deutsches Wörterbuch anfordern
$dict = enchant_broker_request_dict($broker, 'de_DE');
$fachbegriff = 'Containerisierung';
// Prüfen, ob das Wort bereits korrekt ist
if (!enchant_dict_check($dict, $fachbegriff)) {
echo "'$fachbegriff' ist unbekannt – wird hinzugefügt.\n";
enchant_dict_add($dict, $fachbegriff);
} else {
echo "'$fachbegriff' ist bereits bekannt.\n";
}
// Erneut prüfen nach dem Hinzufügen
if (enchant_dict_check($dict, $fachbegriff)) {
echo "'$fachbegriff' ist jetzt in der persönlichen Wortliste.\n";
}
enchant_broker_free($broker);Benutzerdefiniertes PWL-Wörterbuch mit eigenem Vokabular füllen
<?php
// Broker initialisieren
$broker = enchant_broker_init();
// Persönliches Wortlisten-Wörterbuch (PWL) anlegen/öffnen
$pwlFile = '/tmp/mein_woerterbuch.pwl';
$dict = enchant_broker_request_pwl_dict($broker, $pwlFile);
$eigeneWoerter = ['Microservice', 'Fullstack', 'DevOps', 'Kubernetes'];
foreach ($eigeneWoerter as $wort) {
enchant_dict_add($dict, $wort);
echo "'$wort' wurde hinzugefügt.\n";
}
enchant_broker_free($broker);// Wichtig · Fallstricke
Vor PHP 8.0 akzeptierte diese Funktion einen Resource-Typ anstelle von EnchantDictionary. Der frühere Funktionsname lautete ebenfalls enchant_dict_add_to_personal und wurde in PHP 8.0 als Alias beibehalten bzw. entfernt.
Die Änderungen an der persönlichen Wortliste werden dauerhaft in der Benutzerkonfiguration gespeichert, sofern das zugrundeliegende Enchant-Backend dies unterstützt. Bei PWL-Wörterbüchern wird das Wort direkt in die entsprechende Datei geschrieben.
Es erfolgt keine Rückgabe oder Fehlerindikation – falls das Wörterbuch ungültig ist, wird ein Fehler ausgelöst.