Download the PHP package fisharebest/ext-calendar without Composer
On this page you can find all versions of the php package fisharebest/ext-calendar. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download fisharebest/ext-calendar
More information about fisharebest/ext-calendar
Files in fisharebest/ext-calendar
Package ext-calendar
Short Description Implementation of the Arabic (Hijri), French, Gregorian, Jewish, Julian and Persian (Jalali) calendars. Also provides a replacement for the PHP ext/calendar extension.
License GPL-3.0-or-later
Homepage https://github.com/fisharebest/ext-calendar
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 ext-calendar
PHP calendar functions
This package provides an implementation of the Arabic (Hijri), French Republican, Gregorian, Julian, Jewish and Persian (Jalali) calendars, plus a replacement for PHP‘s ext/calendar extension. It allows you to use the following PHP functions on servers that do not have the ext/calendar extension installed (such as HHVM).
- cal_days_in_month()
- cal_from_jd()
- cal_info()
- cal_to_jd()
- easter_date()
- easter_days()
- FrenchToJD()
- GregorianToJD()
- JDDayOfWeek()
- JDMonthName()
- JDToFrench()
- JDToGregorian()
- jdtojewish()
- JDToJulian()
- jdtounix()
- JewishToJD()
- JulianToJD()
- unixtojd()
How to use it
Add the package as a dependency in your composer.json file:
Now you can use the PHP functions, whether ext/calendar is installed or not.
Since version 2.2, it is no longer necessary to initialise these using Shim::create().
Alternatively, just use the calendar classes directly.
Known restrictions and limitations
When faced with invalid inputs, the shim functions trigger E_USER_WARNING instead of E_WARNING. The text of the error messages is the same.
The functions easterdate() and jdtounixtime() use PHP‘s timezone, instead of the operating system‘s timezone. These may be different.
Compatibility with different versions of PHP
The following PHP bugs are emulated, according to the version of PHP being used.
Thus the package always provides the same behaviour as the native ext/calendar extension.
-
#54254 Jewish month "Adar" - fixed in PHP 5.5.
-
#67960 Constants
CAL_DOW_SHORTandCAL_DOW_LONG- found and fixed by this project - fixed in PHP 5.5.21 and 5.6.5. - #67976 Wrong value in
cal_days_in_month()for French calendar - found by this project.
Development and contributions
Due to the known restrictions above, you may need to run unit tests using TZ=UTC phpunit.
Pull requests are welcome. Please ensure you include unit-tests where applicable.
History
These functions were originally written for the webtrees project. As part of a refactoring process, they were extracted to a standalone library, given version numbers, unit tests, etc.
Future plans
- Support alternate leap-year schemes for the French calendar (true equinox, Romme, 128-year cycle) as well as the 4-year cycle.
- Support other calendars, such as Ethiopian, Hindu, Chinese, etc.
