library arphp

muaid/arphp

Yii extension to intigrate the great library ar-PHP in Yii, ar-PHP is a great library to support Arabic in PHP Developed by Khaled Al-Sham'aa

بسم الله الرحمن الرحيم, _(*1)

ar-php extension is a wrapper extension to the great library Ar-PHP which is developed by Khaled Al-Sham'aa, _(*2)

Note: using the library directly as a vendor without using an extension is better but the problem is that we should modify a file in the library to make it work and i preferred not to touch the lib files. (maybe i will make a wiki to explain how), _(*3)

Library Features

• Arabic text auto summarization
• Advanced Arabic search (stem based)
• Render Arabic text (PDF, GD, SWF)
• Present dates in Arabic or Hijri
• Convert Hijri date into Unix timestamp
• Parse Arabic textual datetime into timestamp
• Transliterate English words in Arabic
• Transliterate Arabic words in English
• Spell numbers in Arabic idiom
• Phonetically alike Arabic words
• Arabic character set converter
• Arabic character set auto detection
• Identify Arabic in multi language documents
• Identify names & places in Arabic text
• Guess gender of Arabic names
• Convert keyboard language programmatically
• Calculate the time of Muslim prayer
• Compress string using Huffman-like coding
• Standardize Arabic text
• Arabic stemmer
• Arabic Cities List
• Informations about Arabic countries
• Arabic text normalisation

Requirements

This extension developed using Yii version 1.1.14 RC but it should work in all Yii versions., _(*4)

Installation

1) download and extract the extension into extensions folder: protected/extensions/ar-php, _(*5)

2) download the library from here., _(*6)

3) extract the library into Your-Application-Folder/vendor , example:, _(*7)

[php]
webroot/my-yii-project-folder/protected/vendor/I18N

4) configure the component by updating config/main.php as follow:, _(*8)

[php]
'import'=>array(
    ...
    'ext.ar-php.*'
    ...
),

'components'=>array(
    ...
    'I18N_Arabic'=>array(
        'class'=>'EArPHP',
        'libPath'=>'application.vendor.I18N' // optional since it is the default value
    ),
    ...
),

Usage

I tried to make the usage of the extension as easy as i can, in the official website there is an example of usage and it will not work for our extension but it will help us to compare between them, which is:, _(*9)

[php]
include('I18N/Arabic.php');
$obj = new I18N_Arabic('Numbers');

echo $obj->int2str(1975); // ألف و تسعمئة و خمس و سبعون

to generate the same example using ar-php extension use:, _(*10)

[php]
$obj = Yii::app()->I18N_Arabic->Numbers;

echo $obj->int2str(1975); // ألف و تسعمئة و خمس و سبعون 

or simply:, _(*11)

[php]
echo Yii::app()->I18N_Arabic->Numbers->int2str(1975); // ألف و تسعمئة و خمس و سبعون 

the same concept apply for all other features, and you can follow any feature link above for documentation and usage example., _(*12)

Resources

• code: github
• official Library: Ar-PHP