# php-stemmer

PHP native implementation of Snowball stemmer
https://snowballstem.org/

Accept only UTF-8

* [Languages](#languages)
* [Installation](#installation)
* [Usage](#usage)

Languages
------------
Available : 
- Catalan (by Orestes Sanchez Benavente orestes@estotienearreglo.es)
- Danish
- Dutch
- English
- Finnish (by [Mikko Saari](https://github.com/msaari/))
- French
- German
- Italian
- Norwegian
- Portuguese
- Romanian
- Russian
- Spanish
- Swedish

Installation
------------

For PHP5, use 1.3
```
composer require wamania/php-stemmer "^1.3"
```

For PHP7 use 2.x (branch 2.x is backward compatible with 1.x)
```
composer require wamania/php-stemmer "^2.0"
```

For PHP^7.3 and PHP^8.0 use 3.x (backward compatible, but phpunit^9 don't work with php < 7.3)
```
composer require wamania/php-stemmer "^3.0"
```

Usage
-----

For 2.x, you should use the factory
```php
use Wamania\Snowball\StemmerFactory;

// use ISO_639 (2 or 3 letters) or language name in english
$stemmer = StemmerFactory::create('fr');
$stemmer = StemmerFactory::create ('spanish');

// then 
$stem = $stemmer->stem('automóvil');
```

Or the manager
```php
use Wamania\Snowball\StemmerManager;

$manager = new StemmerManager();
$stem = $manager->stem('automóvil', 'es');
```

In 1.3, you must instantiate manually

```php
use Wamania\Snowball\French;

$stemmer = new French();
$stem = $stemmer->stem('anticonstitutionnellement');
```