Signatur
Beschreibung
enchant_dict_add_to_personal ist ein Alias der Funktion enchant_dict_add und fügt ein angegebenes Wort zum persönlichen Wörterbuch des übergebenen EnchantDictionary-Objekts hinzu. Das Wort wird dauerhaft gespeichert, sodass es bei zukünftigen Rechtschreibprüfungen nicht mehr als falsch erkannt wird.
Diese Funktion ist nützlich, wenn Anwendungen Nutzern ermöglichen sollen, eigene Wörter (z. B. Fachbegriffe, Eigennamen oder Jargon) in die persönliche Wörterbuchdatei aufzunehmen, damit die Rechtschreibkorrektur diese nicht fälschlicherweise beanstandet.
Hinweis: Seit PHP 8.0 ist der Parameter ein EnchantDictionary-Objekt. In früheren Versionen (PHP 5 und 7) war es eine Ressource. Die Funktion selbst ist ein direkter Alias von enchant_dict_add, das seit PHP 8.0 empfohlen wird.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $dictionary Pflicht | EnchantDictionary | Ein EnchantDictionary-Objekt, das zuvor mit enchant_broker_request_dict oder enchant_broker_request_pwl_dict erzeugt wurde. |
|
| $word Pflicht | string | Das Wort, das dem persönlichen Wörterbuch hinzugefügt werden soll. |
Rückgabewert
Beispiele
Wort zum persönlichen Wörterbuch hinzufügen
<?php
// Enchant-Broker erstellen
$broker = enchant_broker_init();
// Deutsches Wörterbuch anfordern
$dictionary = enchant_broker_request_dict($broker, 'de_DE');
if ($dictionary) {
$word = 'Testbegriff';
// Prüfen, ob das Wort bereits korrekt erkannt wird
if (!enchant_dict_check($dictionary, $word)) {
echo "'$word' ist unbekannt. Wird zum persönlichen Wörterbuch hinzugefügt.\n";
enchant_dict_add_to_personal($dictionary, $word);
} else {
echo "'$word' ist bereits bekannt.\n";
}
// Erneut prüfen
if (enchant_dict_check($dictionary, $word)) {
echo "'$word' wird jetzt als korrekt erkannt.\n";
}
} else {
echo 'Wörterbuch konnte nicht geladen werden.';
}
enchant_broker_free($broker);
?>Eigene Fachbegriffe zur Whitelist hinzufügen
<?php
$broker = enchant_broker_init();
$dictionary = enchant_broker_request_dict($broker, 'de_DE');
$fachbegriffe = ['PHP', 'JavaScript', 'Laravel', 'Middleware'];
foreach ($fachbegriffe as $term) {
if (!enchant_dict_check($dictionary, $term)) {
enchant_dict_add_to_personal($dictionary, $term);
echo "'$term' wurde zum persönlichen Wörterbuch hinzugefügt.\n";
} else {
echo "'$term' war bereits bekannt.\n";
}
}
enchant_broker_free($broker);
?>// Wichtig · Fallstricke
Deprecation: enchant_dict_add_to_personal ist ein Alias von enchant_dict_add. Seit PHP 8.0 wird empfohlen, stattdessen direkt enchant_dict_add zu verwenden, da Aliasse in zukünftigen PHP-Versionen möglicherweise entfernt werden könnten.
Die gespeicherten Wörter werden in der persönlichen Wörterbuchdatei des Benutzers abgelegt. Der genaue Speicherort hängt von der Enchant-Konfiguration und dem verwendeten Betriebssystem ab. Stellen Sie sicher, dass das Verzeichnis beschreibbar ist.