README

Symfony bundle to import NFL data from the FantasyPros public API into your database. Built on top of fantasypros-api-client.

Package contains:

Doctrine entities for FantasyPros resources (players, rankings, consensus rankings, experts, projections, news, injuries)
Converters and batch importers (one API request maps to one bulk upsert)
Symfony Messenger messages and handlers (one message = one API request)
Post-import Symfony events for consumer integration
Sync and prune console commands

The bundle is deliberately rate-limit agnostic: scheduling, request budgets, and quota enforcement are the consumer's responsibility (e.g. via a PSR-18 decorator around the injected HTTP client). This keeps the bundle usable for any FantasyPros subscription tier.

Installation

composer require hans-peter-ording/fantasypros-api-symfony-bundle

// config/bundles.php
return [
    // ...
    HansPeterOrding\FantasyProsApiSymfonyBundle\HpoFantasyProsApiSymfonyBundle::class => ['all' => true],
];

# config/packages/doctrine.yaml
doctrine:
    orm:
        mappings:
            HpoFantasyProsApiSymfonyBundle:
                type: attribute
                dir: '%kernel.project_dir%/vendor/hans-peter-ording/fantasypros-api-symfony-bundle/src/Entity'
                prefix: 'HansPeterOrding\FantasyProsApiSymfonyBundle\Entity'
                alias: 'HpoFantasyProsApiSymfony'

Provide your API key and generate the schema:

# .env.local / your secret store
FANTASYPROS_API_KEY=your-key

php bin/console make:migration   # review, then migrate
php bin/console doctrine:migrations:migrate

Copy and adapt the Messenger transports:

cp vendor/hans-peter-ording/fantasypros-api-symfony-bundle/messenger.yaml.dist \
   config/packages/messenger.yaml

Usage

Dispatch syncs via the console commands (each dispatches one or more async messages; one message equals exactly one API request):

php bin/console fp:sync:players
php bin/console fp:sync:ranking-board 2026 --week=0
php bin/console fp:sync:consensus 2026 DRAFT STD RB
php bin/console fp:sync:consensus-matrix 2026 DRAFT DYNASTY ROOKIES ADP
php bin/console fp:sync:projections 2026 RB --week=1
php bin/console fp:sync:experts 2026
php bin/console fp:sync:news --limit=50
php bin/console fp:sync:injuries 2026 --week=1
php bin/console fp:ranking-snapshots:prune --keep-days=400

fp:sync:consensus-matrix expands each ranking type into the request-minimal slice set (STD for all positions, PPR/HALF only for reception positions - the API returns identical data for the rest). After every import a dedicated event (FpPlayersImportedEvent, FpConsensusRankingImportedEvent, ...) is dispatched carrying the message and an FpImportResult, so the consuming application can chain follow-up work (crosswalk matching, cache invalidation, metrics).

Enforcing a request budget

Replace the HTTP client the bundle's API client uses with your own counting/limiting PSR-18 decorator:

# config/services.yaml (consuming application)
HansPeterOrding\FantasyProsApiClient\ApiClient\FantasyProsApiClientInterface:
    factory: ['@HansPeterOrding\FantasyProsApiClient\ApiClient\FantasyProsApiClientFactory', 'getFantasyProsApiClient']
    arguments:
        $apiKey: '%env(FANTASYPROS_API_KEY)%'
        $client: '@App\Http\BudgetGuardedFantasyProsHttpClient'

When the guard refuses a request (or FantasyPros answers 429), handlers log a warning and rethrow TooManyRequestsException - your Messenger retry strategy decides what happens next.

Documentation

Documentation for FantasyProsApiSymfonyBundle can be found at Read the docs

License

This bundle is released under the MIT license. See the included LICENSE file for more information.

hans-peter-ording / fantasypros-api-symfony-bundle

Maintainers

Package info

Statistics

Security