Download the PHP package wnx/php-swiss-cantons without Composer
On this page you can find all versions of the php package wnx/php-swiss-cantons. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download wnx/php-swiss-cantons
More information about wnx/php-swiss-cantons
Files in wnx/php-swiss-cantons
Package php-swiss-cantons
Short Description Search for Swiss Cantons by name or abbreviation.
License MIT
Homepage https://github.com/stefanzweifel/php-swiss-cantons
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-swiss-cantons
🇨🇭 PHP Swiss Cantons
Using Javascript? Check out @stefanzweifel/js-swiss-cantons.
Installation
The easiest way to install the package is by using composer. The package requires PHP 8.2.
Usage
Use the CantonManager Class to interact with this package. Below you find an example how you can use with in the Laravel Framework. Further you find all public API methods for CantonManager and Canton.
CantonManager
Use the CantonManager to find a Canton. It will return a new Instance of Canton or throws an Exception if no Canton could be found for the abbreviation, name or zipcode.
getByAbbreviation()
Find a Canton by its abbreviation. See this list for available abbreviations.
getByName()
Search for a Canton by its name. The name must exactly match one of the translations of the Canton (German, French, Italian, Romansh or English).
getByZipcode()
Returns an array of possible Cantons for a given Zipcode. (Some zipcodes are shared between multiple Cantons).
getByZipcodeAndCity()
Find Canton by a given zipcode and optionally by a city name.
Canton
setLanguage($string = 'en')
Set the language, which should be used to display the name of the canton. The following languages are currently supported.
- German (
de) - French (
fr) - Italian (
it) - Romansh (
rm) - English (
en, default)
The method returns the current instance of Canton for easier method chaining.
getName()
Return the Name for the given Canton. If the method is used without calling the setLanguage() method first, it will return the name in English.
getAbbreviation()
Return the offical abbreviation for the given Canton.
Cantons
This class is used internally but can also be used in your own project if you need a list of all cantons
getAll()
Returns an array containg Wnx\SwissCantons\Canton objects.
getAllAsArray($defaultLanguage = 'en')
Returns a one dimensionl array of all Cantons. The key is the abbreviation. The value will be the translated name of the Canton. The default language is English. Pass one of the valid languages to the method, to localize the names.
Security
If you discover a security vulnerability within this package, please send an e-mail to [email protected]. All security vulnerabilities will be promptly addressed.
Data Sources
Versioning
We use SemVer for versioning. For the versions available, see the tags on this repository.
Credits
License
This project is licensed under the MIT License - see the LICENSE file for details.
