- What is datomatic/laravel-carta-del-docente used for?
- It is a Laravel package that wraps the SOAP API of Carta del Docente, the Italian Teacher's Card scheme. It lets your PHP application check card balances, browse the list of authorized merchants, and manage purchases through a fluent, framework-native interface. Instead of hand-building SOAP envelopes, you call the package from your Laravel services and controllers.
- How do I install datomatic/laravel-carta-del-docente?
- Install it with Composer using composer require datomatic/laravel-carta-del-docente. Laravel's package auto-discovery should register the service provider, but confirm this in your composer.json and, if the package ships a publishable config file, publish it with the vendor:publish command. Before committing, read the require block to verify the Laravel and PHP constraints match your application.
- Does this package support Laravel 13?
- Yes. The 1.3.1 release declares compatibility with Laravel 13, which is the main signal in this version. Note that this is a declared constraint, not a guarantee that the maintainer runs Laravel 13 in the full CI test matrix. Verify the composer.json require block and the CI configuration rather than relying on the release note alone.
- Will it still work on Laravel 11 or 12?
- That is the key risk to check. A release that adds support for a new Laravel major often drops or narrows older constraints, so 1.3.1 may no longer resolve on Laravel 11 or 12. Composer will either refuse to install the package alongside your current framework or silently pin you to an older package version, so read the require block before upgrading.
- What PHP version does this package require?
- Laravel 13 support almost certainly implies a raised minimum PHP version, with 8.4 or newer as the likely floor. That is often the real blocker in mixed fleets, more so than the Laravel constraint itself. Confirm the exact PHP requirement in composer.json and check it against every service where you plan to adopt the package.
- What credentials do I need for the Carta del Docente API?
- You need the API credentials issued for the Carta del Docente SOAP service, which your application supplies to the package. Store them in your .env file and read them through config, never hard-code them or commit them to the repository. Use separate credentials per environment so test traffic cannot touch production data.
- Do I need the PHP SOAP extension to use this package?
- Because the package is a SOAP wrapper, your runtime needs PHP's ext-soap enabled, along with the WSDL or endpoint details it expects. Check your Docker image or server build for the extension before debugging package-level errors. Missing extensions are a common cause of failures that look like configuration problems.
- How should I test code that uses this package?
- Avoid calling the live Carta del Docente service from your test suite or CI pipeline. Wrap the package behind your own interface and swap in a fake or stub implementation in tests, or mock the underlying SOAP client if the package supports it. Keep a small set of opt-in integration tests against a sandbox or test account for release checks.
- Is this package safe to use in production?
- There is no long assessment history on record, so treat it as eligible for evaluation rather than approved. Adopt it first on a single non-critical Laravel 13 service, inspect its transitive dependencies for unmaintained packages, and confirm whether it documents a security disclosure process. The lack of a baseline for its security posture and release cadence is itself the largest risk.
- Who maintains this package and how active is it?
- The package is published by the datomatic vendor on GitHub, and the Laravel 13 constraint in release 1.3.1 shows the maintainer is tracking upstream framework releases. What is not clear from the release alone is whether one contributor or a team is behind it, and what the release cadence has been over the last twelve months. Review the commit history, open issues, and tagged releases before you depend on it.