friendica-addons/cld
Michael 73c6a0ff0c CLD: Keep the original detected language array 2023-10-11 18:57:04 +00:00
..
README.md Updated CLD installation description 2023-10-07 07:07:00 +02:00
cld.php CLD: Keep the original detected language array 2023-10-11 18:57:04 +00:00

README.md

Compact Language Detector

CLD2 is an advanced language dectection library with a high reliability.

This addon depends on the CLD PHP module which is not included in any Linux distribution. It needs to be built and installed by hand, which is not totally straightforward.

Prerequisite

To be able to build the extension, you need the CLD module and the files for the PHP module development. On Debian you install the packages php-dev, libcld2-dev and libcld2-0. Make sure to have installed the correct PHP version. Means: When you have got both PHP 8.0 and 8.2 on your system, you have to install php8.0-dev as well.

Installation

The original PHP extension is https://github.com/fntlnz/cld2-php-ext. However, it doesn't support PHP8. So https://github.com/hiteule/cld2-php-ext/tree/support-php8 has to be used.

Download the source code:

wget https://github.com/hiteule/cld2-php-ext/archive/refs/heads/support-php8.zip

Unzip it:

unzip support-php8.zip

Change into the folder:

cd cld2-php-ext-support-php8/

Configure for the PHP Api version:

phpize

(if you have got several PHP versions on your system, execute the command with the version that you run Friendica with, e.g. phpize8.0)

Create the Makefile:

./configure --with-cld2=/usr/include/cld2

Have a look at the line checking for PHP includes. When the output (for example /usr/include/php/20220829 doesn't match the API version that you got from phpize, then you have to change all the version codes in your Makefile afterwards)

Create the module:

make -j

Install it:

sudo make install

Change to the folder with the available modules. When you use PHP 8.2 on Debian it is:

cd /etc/php/8.2/mods-available

Create the file cld2.ini with this content:

; configuration for php cld2 module
; priority=20
extension=cld2.so

Enable the module for all versions and all sapi:

phpenmod -v ALL -s ALL cld2

Then restart the apache or fpm (or whatever you use) to load the changed configuration.

Call /admin/phpinfo on your webserver. You then see the PHP Info. Search for "cld2". The module is installed, when you find it here. Only proceed when the module is installed

Now you can enable the addon.