https://github.com/still-code/ar-php-laravel
provides a set of tools that enable Arabic website developers to serve professional search, present and process Arabic content in laravel
https://github.com/still-code/ar-php-laravel
ar-php laravel php
Last synced: over 1 year ago
JSON representation
provides a set of tools that enable Arabic website developers to serve professional search, present and process Arabic content in laravel
- Host: GitHub
- URL: https://github.com/still-code/ar-php-laravel
- Owner: still-code
- License: mit
- Created: 2021-04-05T14:00:57.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2024-04-02T18:35:35.000Z (about 2 years ago)
- Last Synced: 2024-04-03T19:35:41.574Z (about 2 years ago)
- Topics: ar-php, laravel, php
- Language: PHP
- Homepage:
- Size: 186 KB
- Stars: 31
- Watchers: 5
- Forks: 13
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
README
# laravel package for the Ar-PHP Project
this is just a wrapper to use with laravel for the Ar-PHP Library, for more details checkout [khaled-alshamaa: ar-php](https://github.com/khaled-alshamaa/ar-php)
## Installation
You can install the package via composer:
```bash
composer require still-code/ar-php-laravel
```
## Available functions
#### Spell Numbers in the Arabic Idiom
``` php
dump(ArPhpLaravel::int2str(123)); // مئة و ثلاثة و عشرون
dump(ArPhpLaravel::str2int('مئة و ثلاثة و عشرون')); // 123
```
#### English-Arabic Transliteration
``` php
dump(ArPhpLaravel::en2ar('google')); // غوغل
dump(ArPhpLaravel::ar2en('خالِد الشَمعَة')); // Khalid Ash-Sham'ah
```
#### Arabic Gender Guesser
Check the Gender
``` php
dump(ArPhpLaravel::isFemale('محمد')); // false
```
get the gender as string
``` php
dump(ArPhpLaravel::guessGender('محمد')); // Male
```
#### Parse any Arabic textual datetime description into timestamp
``` php
dump(ArPhpLaravel::strtotime('الخميس القادم', time(), 'l dS F Y')); // Thursday 13th May 2021
```
#### Arabic Sentiment Analysis
``` php
dump(ArPhpLaravel::arSentiment(TEXT));
```
#### Arabic Text Standardize
``` php
dump(ArPhpLaravel::standard(TEXT));
```
#### Arabic Auto Summarize
``` php
dump(ArPhpLaravel::arSummary(TEXT));
```
#### Convert Money to string
``` php
dump(ArPhpLaravel::money2str(123, 'SAR', 'ar')); // مئة و ثلاثة و عشرون ريالا
dump(ArPhpLaravel::money2str(123, 'SAR', 'en')); // 123 Riyal
dump(ArPhpLaravel::money2str(123, 'EGP', 'ar')); // مئة و ثلاثة و عشرون جنيها
```
#### Spell Numbers in the Arabic Idiom
``` php
dump(ArPhpLaravel::int2indic(123)); // ١٢٣
```
#### Arabic Glyphs to Render Arabic Text
``` php
dump(ArPhpLaravel::utf8Glyphs(1229));
```
#### translate arabic text to english, useful for slug generating
``` php
dump(ArPhpLaravel::translate('اهلا بالكل')); // Ahla Balkl
```
### Search with Eloquent and query Builder
Using search for arabic letters with Eloquent Builder
```php
Model::searchAr('فلسطين','content')->get();
```
you can use the same with Query Builder:
```php
DB::table('table_name')->searchAr('فلسطين','content')->get();
```
you can set the search mode `OR` (default) or `AND`
```php
DB::table('table_name')->searchAr('فلسطين','content','OR')->get();
```
and it will find result for any of the words:
>فلسطينيون فلسطيني فلسطينية فلسطينيتين فلسطينيين فلسطينيان فلسطينيات فلسطينيوا
you can also sort the results by using:
```php
DB::table('table_name')->orderAr('فلسطين','content')->get();
```
## Testing
``` bash
composer test
```
## Changelog
Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.
## Contributing
Please see [CONTRIBUTING](CONTRIBUTING.md) for details.
## Credits
- [Khaled Alshamaa](https://github.com/khaled-alshamaa)
- [All Contributors](../../contributors)
## Todo
- write more tests
- add more functions from the main package
- add helpers for the Facade
## License
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.