Download the PHP package cboxdk/laravel-geo without Composer
On this page you can find all versions of the php package cboxdk/laravel-geo. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download cboxdk/laravel-geo
More information about cboxdk/laravel-geo
Files in cboxdk/laravel-geo
Package laravel-geo
Short Description Cbox Geo — a canonical ISO 3166 country/subdivision and ISO 4217 currency reference for Laravel: data-driven jurisdiction lookups and structured addresses bound to stable codes, carrying the tax-relevant attributes downstream billing and tax engines need.
License MIT
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 laravel-geo
Cbox Geo
cboxdk/laravel-geo — a canonical geography reference for Laravel: countries,
subdivisions and currencies bound to stable ISO codes, resolved deny-by-default,
and carrying the tax-relevant attributes that billing and tax engines build on.
A dependency-light framework library — every capability sits behind a contract you
bind, mock or replace.
This is the shared jurisdiction primitive for the Cbox portfolio. Identity (org addresses), billing (invoice address, seller entities) and the tax engine all bind to the same jurisdiction keys, so nothing downstream matches on free text.
Why it exists
A tax or billing engine must never fuzzy-match a country name or guess a rate from
a ZIP. Everything has to bind to a stable, validated jurisdiction key. This package
provides that key — ISO 3166-1 alpha-2 countries, ISO 3166-2 subdivisions, ISO 4217
currencies — sourced from the vetted commerceguys/addressing dataset, with
one layer added on top: the tax profile of each jurisdiction.
The tax profile
Each modelled jurisdiction carries structural, slow-moving facts — not rates (those live in the tax engine's data feeds):
| attribute | meaning |
|---|---|
regime |
vat · gst · sales_tax · none (unmodelled → deny-by-default) |
regimeModule |
stable key a tax engine maps to a regime (eu-vat, us-sales-tax, …) |
isEuMember |
drives EU reverse-charge / OSS routing |
isSubFederal |
tax is set below the national level — a subdivision is required (US, CA) |
requiresRooftop |
rate resolution needs address-level geocoding (US only) |
Sub-federal is deliberately split from rooftop: Canada stacks at province level (a subdivision is enough), while the US stacks below the state and needs rooftop geocoding. National VAT/GST regimes (EU, UK, CH, NO, AU, NZ, MX) need neither.
Design
- Contracts-first. Depend on
Contracts\JurisdictionRepository; the default binding wraps the ISO dataset. Swap or persist the data without touching callers. - No forced migration. The reference data ships inside the library; persisting jurisdictions for FK integrity is an optional host concern.
- Deny-by-default. An unknown country, an unknown subdivision, or a subdivision
that does not belong to its country all resolve to
null.
Requirements
PHP ^8.4; Laravel ^12 || ^13. See composer.json.
Development
License
MIT.
All versions of laravel-geo with dependencies
commerceguys/addressing Version ^2.2
illuminate/contracts Version ^12.0 || ^13.0
illuminate/support Version ^12.0 || ^13.0