1. Library Features
2. Requirements
3. Installation
4. Usage
5. Resources

بسم الله الرحمن الرحيم

ar-php extension is a wrapper extension to the great library Ar-PHP which is developed by Khaled Al-Sham'aa

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)

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 is has been tested up to version 1.1.16.

Installation ¶

1) download and extract the extension into extensions folder: protected/extensions/ar-php

2) download the library from here (tested on version 3.6.0 of this library).

3) extract the library into Your-Application-Folder/vendor , example:

webroot/my-yii-project-folder/protected/vendor/I18N

4) configure component by updating config/main.php as follow:

'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:

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

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

to generate the same example using ar-php extension use:

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

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

or simply:

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.

Resources ¶

• code: github
• official Library: Ar-PHP