- How do I install and configure this package in a Laravel project?
- Run `composer require baks-dev/four-tochki-orders` to install. Use `php bin/console baks:assets:install` for asset setup, but note this requires Symfony’s Console component. Replace Symfony commands with Laravel Artisan wrappers or custom scripts for full compatibility. Doctrine migrations must be adapted for Laravel’s schema builder or run in isolation.
- Does this package work with Laravel’s Eloquent ORM, or is Doctrine required?
- The package relies on Doctrine ORM for 4Tochki-specific models. To integrate with Laravel, isolate Doctrine usage (e.g., only for `FourTochkiOrder` models) or use a bridge like `laravel-doctrine/orm` to hybridize Doctrine and Eloquent. Core Laravel models should remain Eloquent-based to avoid conflicts.
- What Laravel versions and PHP versions are supported?
- The package requires PHP 8.4+, which may force a Laravel upgrade from the current LTS (8.2). Test thoroughly or fork the package to support PHP 8.2 if needed. No official Laravel version compatibility is documented, but Symfony bridge components (e.g., `spatie/laravel-symfony-components`) can help adapt it.
- How does this package handle 4Tochki API failures or retries?
- The package likely includes retry logic for API calls, but documentation is minimal. For Laravel integration, wrap the bundle’s API client in a service using Laravel’s HTTP client or Guzzle, then implement custom retry logic with Laravel’s queue system (e.g., `shouldQueue()`). Test edge cases like rate limits or timeouts.
- Can I use this package for non-Russian/Ukrainian markets?
- The package is tailored for 4Tochki’s Russian/Ukrainian e-commerce ecosystem. While the core API integration logic may work globally, localization (e.g., error messages, logs) is likely Russian-only. Add translation layers or modify the bundle’s output handling for non-Russian teams.
- How do I handle webhooks from 4Tochki in Laravel?
- The package may include Symfony event listeners for webhooks. Replace these with Laravel’s event system or route webhooks to a Laravel controller using middleware for HMAC validation. Use Laravel’s signed events or custom validation to ensure idempotency and security.
- Are there alternatives to this package for 4Tochki integration?
- For lightweight 4Tochki API integration, consider building a custom Laravel service using Guzzle or Laravel’s HTTP client. Packages like `spatie/api-macros` can help abstract API calls. However, this package offers pre-built models, migrations, and payment handling, saving development time for full 4Tochki marketplace support.
- How do I test this package in a Laravel project?
- Run tests with `php bin/phpunit --group=four-tochki-orders`, but note the limited test coverage. Mock the 4Tochki API in Laravel’s testing environment using factories or HTTP client interceptors. Test Doctrine migrations separately or adapt them for Laravel’s schema builder.
- Does this package support sandbox/testing environments for 4Tochki?
- The package likely supports environment-specific configurations, but documentation is unclear. Override Symfony’s config files or extend Laravel’s `.env` to manage sandbox/production API keys. Use Laravel’s config caching to avoid runtime conflicts.
- What license restrictions apply when using this package in Laravel?
- The package is MIT-licensed, but check for third-party dependencies with stricter licenses (e.g., AGPL) in its `composer.json`. Ensure compliance with Laravel’s MIT license. If dependencies conflict, isolate them or replace them with MIT-compatible alternatives.