Download the PHP package opilo/farsi without Composer
On this page you can find all versions of the php package opilo/farsi. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package farsi
Opilo Farsi Tools
This package provides Farsi tools for PHP developers. It also introduce validation facilities specially designed for Laravel developers.
Jalali (Higri Shamsi) Date
The JalaliDate class represents Iranian calendar. It calculates leap years based on data referenced in this wiki page.
According to the tests done in tests/SallarJdatetimeTest.php, for years between 1343 and 1473, the leap years in this calendar perfectly match those of calculated leap years based on the proposed calculation rules.
But it should be considered that Iranian calendar is based on astronomical observations and, unlike the Georgian, it is not a rule-based calendar.
The following code shows how you can convert a DateTime object into a JalaliDate one and then print it according to a desired format.
All you need is using JalaliDate::fromDateTime() method and take a look at JalaliFormatter::$conversionFunctions array to know what to pass to JalaliDate::format() function as format string.
And the output will be: پنجشنبه دوازدهم شهریور ماه سال یک هزار و سیصد و نود و چهار
The following sample code shows how to convert numeric inputs representing a Jalali date into a JalaliDate and then convert it into DateTime.
This may be helpful if you want to validate user's input Jalali date, and then save the appropriate standard timestamp into database.
And the output will be: 2015-09-03
Conveniently, you can also directly convert an string with a known format into a JalaliDate:
The output of the code above, is: جمعه، ۲۰ شهریور ۹۴
Note that if you try to construct an invalid JalaliDate, an InvalidArgumentException will be thrown.
JDateTime class
The JDateTime class is an extension of JalaliDate class with time (hour, minute, second) support.
Number to String Converter
If your application is supposed to print financial documents, you probably love this:
because, this is the output: بیست و یک میلیون و سی و چهار هزار و پانصد و ده
And, here is the second note (نکتهی دوم):
String Cleanser
With StringCleanser class you can deal with Farsi digits while interacting with the users.
StringCleanser::arabicToFarsi() function cleans input Farsi strings out of Arabic characters that commonly presents in standard keywords.
This will (approximately) output:
۱۳۹۴
1394
کیک پی اچ پی چیز خاصی نیستJalali Validator For Laravel 4.2 and Laravel 5
Installation
Step 1: Add the Service Provider
Add the provider class to the array of providers in config/app.php file
Step 2: Define the Error Messages
You need to define error messages for jalali, jalali_after, and jalali_before rules in validation.php in lang folders. Samples to copy & paste are provided under sample-lang directory of this package.
For example, if your project uses Laravel 5 and your Farsi ranslation are under resources/lang/fa directory, copy these lines to resources/lang/fa/validation.php:
Validation Rules
jalali:Y/m/d
Determines if an input is a valid Jalali date with the specified format. The default format is Y/m/d.
jalali_after:1380/1/1,Y/m/d
Determines if an input is a valid Jalali date with the specified format and it is after a given date. The default format is Y/m/d and the default date is today.
jalali_before:1395-01-01,Y-m-d
Determines if an input is a valid Jalali date with the specified format and it is before a given date. The default format is Y/m/d and the default date is today.
jdatetime:"Y/m/d h:i:s"
Determines if an input is a valid Jalali date-time with the specified format. The default format is Y/m/d h:i:s.
jdatetime_after:"1380/1/1 12:00:00","Y/m/d h:i:s"
Determines if an input is a valid Jalali date-time with the specified format and it is after a given date-time. The default format is Y/m/d h:i:s and the default time is now.
jdatetime_before:"1395-01-01 h:i","Y-m-d h:i"
Determines if an input is a valid Jalali date-time with the specified format and it is before a given date-time. The default format is Y/m/d h:i:s and the default time is now.
Examples
Thanks to Laravel 5, you may use the mentioned validation rules inside rule() function of your domain specific Request objects. If that is not an option, you can use the rules, just like any other Laravel rules with codes like the following:
The output of the code above will be:
License
The Opilo Farsi package is open-sourced software licensed under the MIT license
