Weave Code
Ares Bundle Laravel Package
arodax/ares-bundle
A Symfony bundle for querying the Czech ARES business register. Look up company details by IČO, including name, address, legal form, and registration data, with a simple service layer for easy integration into Symfony applications.
This Symfony bundle provides a support for ARES.
Frequently asked questions about Ares Bundle
- Can I install arodax/ares-bundle in a Laravel application?
- Not as a dependency. arodax/ares-bundle is a Symfony bundle: it registers through config/bundles.php and relies on a DependencyInjection extension, a configuration tree, compiler passes and Symfony HttpClient, none of which Laravel loads. The practical path is to reuse its request building, response mapping and error handling as reference code and write a small client behind a Laravel service provider.
- What does arodax/ares-bundle actually do?
- It queries the Czech ARES business register by IČO and returns company details such as name, address, legal form and registration data. The package wraps that lookup in a Symfony service layer so it can be injected wherever it is needed. For a Laravel team the valuable part is the request construction, response parsing and IČO validation logic, not the bundle wiring.
- Which ARES API generation does arodax/ares-bundle target, SOAP or REST?
- That is the first thing to verify in the source before anything else matters. ARES retired its legacy SOAP services in favour of a REST API, so a bundle targeting the old WSDL generation is functionally dead regardless of code quality. Look for SOAP client usage or hardcoded endpoints and compare them against the current ARES REST documentation.
- How do I build a Laravel-native ARES client instead of using the bundle?
- Define a narrow boundary such as CompanyRegistry::findByIc(string $ico): CompanyRecord and put an ARES implementation behind it. Use Laravel's Http facade for transport, add a cache decorator, and bind the interface in a service provider. Budget roughly two to four days and port the DTO shape and error cases from the bundle rather than adopting the bundle itself.
- How do I validate a Czech IČO before querying ARES?
- Czech IČO is an eight-digit number with a modulo-11 checksum, so validation is cheap and should happen before any HTTP call. Rejecting malformed input early avoids pointless requests and preserves ARES rate limits for real lookups. The bundle's validation logic is one of the pieces worth copying into your own code.
- How do I test ARES lookups in Laravel without calling the live registry?
- Use Http::fake() with recorded ARES response fixtures so tests are deterministic and offline. Assert on your own CompanyRecord DTO rather than raw JSON, and add separate cases for invalid IČO, not-found and ARES error responses. Keep one optional integration test tagged as slow against the live API.
- Is arodax/ares-bundle safe to depend on in production?
- Treat it as reference material rather than a dependency. It has no stars, no dependents, single-vendor Bitbucket-only hosting and no evidence of compatibility with current PHP or Symfony majors. Bitbucket hosting also weakens Composer security advisory coverage, so vulnerabilities would not surface in standard audit tooling.
- Does arodax/ares-bundle work with Laravel's HTTP client, retries and timeouts?
- No. It presumes Symfony's HttpClient and event dispatcher, so adopting it means running a second HTTP stack alongside Laravel's Http facade. You would either duplicate timeout, retry and telemetry configuration or rewrite the transport anyway. At that point a thin Laravel-native client is less work and easier to observe.
- How should I cache ARES company lookups in a Laravel app?
- ARES company data changes rarely, so cache responses keyed by IČO with a TTL of hours to days and a negative cache for unknown IČOs. Put the cache in a decorator behind your CompanyRegistry interface so the client stays transport-focused. This also reduces load on a public registry that has its own terms of use and rate limits.
- Can I switch from ARES to VIES or ISIR later without rewriting call sites?
- Yes, and that is the main argument for owning the interface. With CompanyRegistry::findByIc() in place you can add a VIES implementation for VAT validation or an ISIR implementation for insolvency checks without touching call sites. A bundle-shaped integration would have leaked ARES specifics into your application code.
Weaver
How can I help you explore Laravel packages today?