- What is ghaninia/shipping used for?
- It is a Laravel package for calculating postage in Iran and supports Sefarshi and Pisthtaz drivers. Use it as a bounded shipping-rate adapter behind an internal interface rather than as core domain logic. It fits checkout or order flows that need Iranian delivery quotes.
- Which Laravel and PHP versions are supported by ghaninia/shipping?
- The provided context does not include a current compatibility matrix, so check composer.json and the README for exact PHP and Laravel constraints. The last release appears to be from 2022, so validate compatibility with your framework version before installing. Pin the package version and test in a sandbox first.
- How do I install ghaninia/shipping in a Laravel app?
- Install it with Composer using composer require ghaninia/shipping and verify that Laravel service-provider auto-discovery works in your app. Check whether the package publishes configuration and run the publish command if documented. Confirm PHP and Laravel constraints and watch for dependency conflicts.
- How do I configure Sefarshi and Pisthtaz drivers in ghaninia/shipping?
- Expect configuration for API credentials and a default driver for Sefarshi or Pisthtaz, but verify the exact keys in the package README or config file. Publish any package config if supported and keep secrets in environment variables rather than committed files. Wrap credential handling in your application so rotation and driver changes do not leak into checkout code.
- Does ghaninia/shipping support both Sefarshi and Pisthtaz postage calculation?
- Yes, the package description states that it supports Sefarshi and Pisthtaz drivers for Iranian postage. The drivers may expose different request and response shapes, so normalize quotes through your own adapter. Validate sample rates and address requirements for both before customer-facing use.
- How can I test ghaninia/shipping without live Iranian postal APIs?
- Do not depend on live postal APIs for CI; wrap the package behind an internal ShippingRateProvider interface and use fake or recorded responses for tests. Run a time-boxed sandbox spike with real credentials to capture contracts, then test your adapter with deterministic fixtures. Also test invalid addresses, timeouts, and fallback-rate behavior.
- Is ghaninia/shipping production-ready and actively maintained?
- Treat it as medium-to-high vendor risk because the last release appears to be from 2022 and the repository has limited stars and evidence of production use. Use a feature flag, shadow-mode comparison against manual rates, observability, and a fallback-rate path before enabling it for customers. Assign an internal owner and budget for patching or forking.
- How does ghaninia/shipping handle API errors, timeouts, and invalid addresses?
- The provided context does not document exact timeout, retry, or validation behavior, so assume external I/O and add timeouts, retries with backoff, circuit breakers, and address validation in your adapter. Return a stable error or fallback rate instead of letting package-specific exceptions reach checkout. Log failures and monitor rate mismatches and API outages.
- What are alternatives to ghaninia/shipping for Laravel shipping rates?
- No specific alternatives are named in the provided context; compare actively maintained Laravel shipping abstractions or direct Sefarshi and Pisthtaz API clients. For Iran-only postage, this package may be a starting point if wrapped behind your own interface. If maintenance risk is unacceptable, extract only the API client logic or build a small internal provider.
- What license does ghaninia/shipping use and can I fork it?
- The provided context does not state the license, so review the repository LICENSE file before commercial use. If the license permits, fork and maintain it internally with pinned dependencies, tests, and a clear upgrade path. Plan for patch ownership because community support is likely limited.