# metaphone

(PHP 4, PHP 5, PHP 7, PHP 8)

metaphone — Calculate the metaphone key of a string

### 说明

metaphone(string `$string`, int `$max_phonemes` = 0): string

Calculates the metaphone key of `string`.

Similar to soundex() metaphone creates the same key for similar sounding words. It's more accurate than soundex() as it knows the basic rules of English pronunciation. The metaphone generated keys are of variable length.

Metaphone was developed by Lawrence Philips <lphilips at verity dot com>. It is described in ["Practical Algorithms for Programmers", Binstock & Rex, Addison Wesley, 1995].

### 参数

`string`

  The input string.

`max_phonemes`

  This parameter restricts the returned metaphone key to `max_phonemes` characters in length. However, the resulting phonemes are always transcribed completely, so the resulting string length may be slightly longer than `max_phonemes`. The default value of `0` means no restriction.

### 返回值

Returns the metaphone key as a string.

### 更新日志

版本 | 说明
--- | ---
8.0.0 | The function returned `false` on failure.

### 示例

示例 #1 metaphone() basic example

`<?php
var_dump(metaphone('programming'));
var_dump(metaphone('programmer'));
?>`

以上示例会输出：

    string(7) "PRKRMNK"
    string(6) "PRKRMR"

示例 #2 Using the `max_phonemes` parameter

`<?php
var_dump(metaphone('programming', 5));
var_dump(metaphone('programmer', 5));
?>`

以上示例会输出：

    string(5) "PRKRM"
    string(5) "PRKRM"

示例 #3 Using the `max_phonemes` parameter

In this example, metaphone() is advised to produce a string of five characters, but that would require to split the final phoneme (`'x'` is supposed to be transcribed to `'KS'`), so the function returns a string with six characters.

`<?php
var_dump(metaphone('Asterix', 5));
?>`

以上示例会输出：

    string(6) "ASTRKS"

### 参见

- levenshtein() - 计算两个字符串之间的 Levenshtein 距离
- similar_text() - 计算两个字符串的相似度
- soundex() - Calculate the soundex key of a string

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open