answear/fan-courier-bundle

Symfony bundle for FanCourier API.

2.0.0 2024-09-20 09:38 UTC

Requires

• php: >=8.1
• ext-json: *
• guzzlehttp/guzzle: ^6.0 || ^7.0
• psr/log: ^1.1
• symfony/http-kernel: ^6.1
• symfony/property-info: ^6.1
• symfony/serializer: ^6.1
• webmozart/assert: ^1.3

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.63.2
• matthiasnoback/symfony-config-test: ^5.2
• phpro/grumphp: ^2.7.0
• phpstan/phpstan: ^1.12
• phpstan/phpstan-webmozart-assert: ^1.2.10
• phpunit/phpunit: ^10.5.30
• roave/security-advisories: dev-master
• symfony/phpunit-bridge: 6.4.*

MIT

README

FanCourier integration for Symfony.
Documentation of the API can be found here: https://www.fancourier.ro/wp-content/uploads/2023/07/EN_FANCourier_API-2.0-160523.pdf

Installation

• install with Composer

composer require answear/fan-courier-bundle

Answear\FanCourierBundle\AnswearFanCourier::class => ['all' => true],
should be added automatically to your config/bundles.php file by Symfony Flex.

Setup

# config/packages/answear_fancourier.yaml
answear_fan_courier:
    username: yourUsername
    password: yourPassword
    apiUrl: apiUrl
    logger: customLogger #default: null

Logger service must implement Psr\Log\LoggerInterface interface.

Usage

Get pickup points

namespace App\Service\PickupPointsImporter;

use Answear\FanCourierBundle\Service\PickupPointService;

class FanCourierImport
{
    public function __construct(
        private PickupPointService $pickupPointService,
    ) {
    }

    /**
     * @return PickupPointDTO[]
     */
    public function getPickupPoints(): array
    {
        return $this->pickupPointService->getAll();
    }
}

Above getPickupPoints method will return an array of Answear\FanCourierBundle\DTO\PickupPointDTO objects.

Final notes

Feel free to open pull requests with new features, improvements or bug fixes. The Answear team will be grateful for any comments.