laposta / laposta-api-php
Laposta api, free api to laposta.nl
Installs: 53 448
Dependents: 1
Suggesters: 0
Security: 0
Stars: 8
Watchers: 4
Forks: 10
Open Issues: 0
Requires
- php: ^8.1
- ext-curl: *
- ext-json: *
- psr/http-client: ^1.0
- psr/http-factory: ^1.1
- psr/http-message: ^2.0
Requires (Dev)
- captainhook/captainhook: ^5.25
- guzzlehttp/guzzle: ^7.4
- phpunit/phpunit: ^10.5
- squizlabs/php_codesniffer: ^3.13
- vlucas/phpdotenv: ^5.6
README
A PHP library for interacting with the Laposta API, compatible with PSR-18 and PSR-17 standards.
Requirements
To use the Laposta API, the following is required:
- PHP >= 8.1
- cURL PHP extension
- JSON PHP extension
Composer Installation
The easiest way to install this library is by requiring it via Composer:
composer require laposta/laposta-api-php
Manual Installation
If you're not using Composer, include the autoloader:
require_once("/path/to/laposta-api-php/standalone/autoload.php");
Quick Example
$laposta = new LapostaApi\Laposta('your_api_key'); $member = $laposta->memberApi()->create($listId, ['email' => 'test@example.com', 'ip' => '123.123.123.123']);
Examples
This project includes a set of real, runnable examples organized by API resource (e.g., list, campaign, member).
Each example demonstrates a specific API operation and can be run via PHP CLI.
See examples/README.md for setup instructions and an overview of the available examples.
Extensibility
This library is built around PHP standards (PSR-18/17) and is designed to be flexible.
You can inject your own HTTP client and factories (e.g. Guzzle, Nyholm, Symfony components) via the constructor:
$laposta = new LapostaApi\Laposta( 'your_api_key', httpClient: new \GuzzleHttp\Client(), // implements PSR-18 requestFactory: ..., responseFactory: ..., streamFactory: ..., uriFactory: ... );
If no client or factories are provided, the library uses its own lightweight implementations by default.
API Documentation
For the full API reference, see https://api.laposta.nl/doc.
Changelog
See CHANGELOG.md for a complete list of changes.
License
This library is open-sourced software licensed under the MIT license.