omroepgelderland/regioexchange-api-php

PHP wrapper for the RegioExchange public API

0.1.0 2026-08-07 13:53 UTC

Requires

• php: >=8.1 <8.6
• ext-date: *
• ext-json: *
• ext-mysqli: *
• ext-pcre: *
• guzzlehttp/guzzle: ^7.0
• league/oauth2-client: ^2.8

Requires (Dev)

• omroepgelderland/phpstdlib: ^2.3
• php-parallel-lint/php-parallel-lint: ^1.4
• phpstan/phpstan: ^2.2
• phpunit/phpunit: ^10.5
• slevomat/coding-standard: ^8.31
• squizlabs/php_codesniffer: ^4.0

MIT

• Remy Glaser

Published on Packagist.org on 2026-08-07 13:56 UTC

README

PHP wrapper for the RegioExchange public API.

Supported operations:

• Uploading news articles
• Deleting news articles
• Retrieve change feeds
• Retrieve parsed news articles
• Retrieve processing status

Not yet supported:

• Uploading large files through the uploadUrl returned by the traceable request response.

Integration Test

The live put integration test uses the real acceptance API to upload a file.

Integration tests are skipped if the required environment variables are not present.

Required environment variables:

• api_url
• access_token_url
• client_id
• client_secret
• channel_id
• source_id
• category_id
• origin_id_prefix

The test writes the OAuth access token cache outside the repository in the user cache directory:

• $XDG_CACHE_HOME/regioexchange-api-php/acceptance-access-token, or
• ~/.cache/regioexchange-api-php/acceptance-access-token

The test also writes non-secret fixture metadata for later integration tests in the same user cache directory:

• $XDG_CACHE_HOME/regioexchange-api-php/acceptance-put-fixture.json, or
• ~/.cache/regioexchange-api-php/acceptance-put-fixture.json

Run the integration suite with:

export api_url=""
export access_token_url=""
export client_id=""
export client_secret=""
export channel_id=""
export source_id=""
export category_id=""
export origin_id_prefix=""

export XDEBUG_CONFIG="idekey=xdebug_vscode" # optional for vscode debug

vendor/bin/phpunit --testsuite integration