PHPackages masmerise/de-ridder-den-hertog-php-sdk - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. masmerise/de-ridder-den-hertog-php-sdk ActiveLibrary[API Development](/categories/api) masmerise/de-ridder-den-hertog-php-sdk ====================================== An unofficial PHP SDK for accessing De Ridder & Den Hertog's API. 1.1.0(1mo ago)2281MITPHPPHP ~8.5CI passing Since Dec 14Pushed 1mo agoCompare [ Source](https://github.com/masmerise/de-ridder-den-hertog-php-sdk)[ Packagist](https://packagist.org/packages/masmerise/de-ridder-den-hertog-php-sdk)[ Docs](https://github.com/masmerise/de-ridder-den-hertog-php-sdk)[ RSS](/packages/masmerise-de-ridder-den-hertog-php-sdk/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (4)Dependencies (15)Versions (7)Used By (1) [![RenH PHP SDK](https://camo.githubusercontent.com/977daa36ff6eac2e8b30a24e6b67daf03fe4d6dfe55192d9282920df2478f036/68747470733a2f2f6d656469612d30312e696d752e6e6c2f73746f726167652f726964646572656e686572746f672e6e6c2f323136332f72656e682d6b6173736173797374656d656e2d77656567736368616c656e2e6a7067)](https://camo.githubusercontent.com/977daa36ff6eac2e8b30a24e6b67daf03fe4d6dfe55192d9282920df2478f036/68747470733a2f2f6d656469612d30312e696d752e6e6c2f73746f726167652f726964646572656e686572746f672e6e6c2f323136332f72656e682d6b6173736173797374656d656e2d77656567736368616c656e2e6a7067)[![PHP](https://camo.githubusercontent.com/4b0aa075e2e98f282839bf07cbc3199b059e258abca5b928f0e3a982245d472c/68747470733a2f2f7777772e7068702e6e65742f696d616765732f6c6f676f732f7068702d6c6f676f2e737667)](https://camo.githubusercontent.com/4b0aa075e2e98f282839bf07cbc3199b059e258abca5b928f0e3a982245d472c/68747470733a2f2f7777772e7068702e6e65742f696d616765732f6c6f676f732f7068702d6c6f676f2e737667) [![Build Status](https://github.com/masmerise/de-ridder-den-hertog-php-sdk/actions/workflows/test.yml/badge.svg)](https://github.com/masmerise/de-ridder-den-hertog-php-sdk/actions)[![Total Downloads](https://camo.githubusercontent.com/9b8726999bf4250ac44c016075de320118a875c5d8c3ef04d885ad21eb07a5f0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d61736d65726973652f64652d7269646465722d64656e2d686572746f672d7068702d73646b)](https://packagist.org/packages/masmerise/de-ridder-den-hertog-php-sdk)[![Latest Stable Version](https://camo.githubusercontent.com/63ac8f37435407ae8955a24dcfc16d2aabd1fe434bc49c019b2cbc97651adb4a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d61736d65726973652f64652d7269646465722d64656e2d686572746f672d7068702d73646b)](https://packagist.org/packages/masmerise/de-ridder-den-hertog-php-sdk)[![License](https://camo.githubusercontent.com/164040da123b8a97f8d2d2adda46944aba7886384c8b9b1961e100e8e024cda6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6d61736d65726973652f64652d7269646465722d64656e2d686572746f672d7068702d73646b)](https://packagist.org/packages/masmerise/de-ridder-den-hertog-php-sdk) De Ridder & Den Hertog PHP SDK ---------------------------------- [](#de-ridder--den-hertog-php-sdk) This SDK provides convenient, fully-typed access to [De Ridder & Den Hertog's API](/docs/RHAPI.pdf). Installation ------------ [](#installation) You can install the package via [composer](https://getcomposer.org): ``` composer require masmerise/de-ridder-den-hertog-php-sdk ``` ### Adapters [](#adapters) You may also use one of the available adapters instead: - [Laravel](https://github.com/masmerise/de-ridder-den-hertog-for-laravel) Getting started --------------- [](#getting-started) You can always refer to the [documentation](/docs/RHAPI.pdf) to examine the various resources that are available. ### Setup [](#setup) ``` use DeRidderDenHertog\Authentication\ApiGuid; use DeRidderDenHertog\DeRidderDenHertog; $guid = ApiGuid::fromString('{4844a45c-33d1-4937-83f4-366d36449eaf}'); $renh = DeRidderDenHertog::authenticate($guid); ``` ### Data retrieval [](#data-retrieval) ``` use DeRidderDenHertog\Core\Type\Parameter\Filter; $filter = Filter::fromSql('Klantnummer=123456789'); [$customer] = $renh->getCustomers(filter: $filter); ``` ### Resource creation / update [](#resource-creation--update) ``` use DeRidderDenHertog\SetCustomer\Type\Parameter\CustomerData; $data = CustomerData::parameters( city: 'Ghent', emailAddress: 'php.sdk@github.action', houseNumber: '40', name: 'PHP SDK', phone: '0470123456', street: 'Teststraat', zipCode: '9000', ); $customerId = $renh->setCustomer($data); ``` Failures (exception handling) ----------------------------- [](#failures-exception-handling) The SDK uses exceptions as its medium to communicate failures. ``` DeRidderDenHertogException ├── CouldNotAuthenticate (Authentication Errors) ├── UnknownException (Connection Errors) └── ValidationException (Request Errors) ├── CouldNotDeleteCustomer ├── CouldNotGetApiFunctions ├── CouldNotGetCustomers ├── CouldNotGetDayTurnover ├── CouldNotSetCustomer └── ... ``` ``` use DeRidderDenHertog\SetCustomer\Failure\CouldNotSetCustomer; try { $customerId = $renh->setCustomer($data); } catch (CouldNotSetCustomer $ex) { $logger->log($ex->getMessage()); } ``` Timeouts -------- [](#timeouts) The SDK defaults to a 30 second timeout. Implementation progress ----------------------- [](#implementation-progress) ActionDeleteCustomerGetAPIFunctionsGetCustomersGetDayTurnoverSetCustomerWhile the SDK is battle-tested and production-ready, only a handful of API interactions have been implemented thus far. Please bear in mind this is an unofficial SDK, so we have to prioritize available resources at this time. However, always feel free to submit a feature or pull request! Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Security -------- [](#security) If you discover any security related issues, please email instead of using the issue tracker. Credits ------- [](#credits) - [Muhammed Sari](https://github.com/mabdullahsari) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 45 — FairBetter than 92% of packages Maintenance91 Actively maintained with recent releases Popularity12 Limited adoption so far Community10 Small or concentrated contributor base Maturity56 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~35 days Total 4 Last Release 43d ago Major Versions 0.2.0 → 1.0.02026-03-29 ### Community Maintainers ![](https://www.gravatar.com/avatar/79212cff26df3f844929ef901df8761013cda04b8b08cf619189788ece91783c?d=identicon)[masmerise](/maintainers/masmerise) --- Top Contributors [![mabdullahsari](https://avatars.githubusercontent.com/u/24608797?v=4)](https://github.com/mabdullahsari "mabdullahsari (11 commits)") --- Tags apisdkrenhridderhertog ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StyleLaravel Pint Type Coverage Yes ### Embed Badge ![Health badge](/badges/masmerise-de-ridder-den-hertog-php-sdk/health.svg) ``` [![Health](https://phpackages.com/badges/masmerise-de-ridder-den-hertog-php-sdk/health.svg)](https://phpackages.com/packages/masmerise-de-ridder-den-hertog-php-sdk) ``` ### Alternatives [saloonphp/laravel-plugin The official Laravel plugin for Saloon 765.7M125](/packages/saloonphp-laravel-plugin)[ohdearapp/ohdear-php-sdk An SDK to easily work with the Oh Dear API 742.6M13](/packages/ohdearapp-ohdear-php-sdk)[upcloudltd/upcloud-php-api UpCloud PHP API 2422.0k](/packages/upcloudltd-upcloud-php-api) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)