Download the PHP package sylvaincombes/php-lcid without Composer
On this page you can find all versions of the php package sylvaincombes/php-lcid. 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 php-lcid
php-lcid
Php library trying to get a valid Unicode Locale for a given Microsoft LCID.
Installation
Usage
Basic usage
"Advanced" usage
Using custom datas
Why this library
One day at work I needed to consume some api service who exposed some microsoft sharepoint datas. Language information were only given by microsoft LCID, and I needed to have them in an exploitable icu standard locale.
After searching a long time I discovered that this "simple" task was not really easy as I found no exhaustive complete list or existing php project answering my need. Plus I learned that depending on the php-intl extension some locale doesn't match in the end.
So I hacked with some datas sources founded on the web and some other libraries and tools, hoping to never do this very boring task again and maybe helping another dev :)
Fun fact
LCIDs were deprecated with Windows Vista and Microsoft recommends that developers use BCP47 style tags instead (uloc_toLanguageTag).
Contributing
All contributions are very welcome.
Updating datas list
There is a command who build the datas, what it does is :
- Fetching a json from sindresorhus/lcid - this is our starting non editable datas point
- Check if locales are found in symfony/intl locales list
- If yes keep them
- If no trying to find if a locale or language is matching
- If yes adding to the fallback list
- If no remove this entry
- Load the php array in file src/SylvainCombes/Lcid/Resources/datas-manual.php if some lcid codes are not in the datas do it's best with lcid, language, locale fields to add them in the list or in the fallback entries.
So to edit / delete / add some datas not present in the base json, you should edit src/SylvainCombes/Lcid/Resources/datas-manual.php and re-launch the command :
And the datas.json will be updated.
NB : It also mean you can't override datas provided by the base json grabbed from sindresorhus/lcid
Testing
Launching the project tests :
Lint php
You can also "autofix" :
References
ICU Locale
LCID
- sindresorhus/lcid - Based on the mapping used in the Python standard library.
- Locale codes
- Microsoft Locale ID Values
BCP 47
Formats
Libraries used
Required
- thephpleague/json-guard - used to validate custom user json datas against a json schema
Used in dev
- phpunit - used for ... testing
- [symfony/intl]() - used in dev to check if locales in datas sources matches the locales list provided (I found that this locales list was different than using the one provided by the php-intl extension and I tend to think the one in this package is more robust and widely used instead of depending on local installation / configuration of a php extension)
- symfony/console - used in dev for console command building datas
- phpcs + coke + symfony2-coding-standard - pimp my ride
- json schema lint - used to check / test writing the json schema
- regex101 - used to writing / testing the locale regexp
