bitandblack/hyphenizer-sdk-php

0.1.0 2026-02-25 14:10 UTC

Requires

• php: >=8.2
• bitandblack/composer-helper: ^2.0
• cuyz/valinor: ^2.0
• fig/http-message-util: ^1.0
• league/flysystem: ^3.0
• php-http/client-common: ^2.0
• php-http/discovery: ^1.0
• psr/http-client-implementation: *
• psr/http-factory-implementation: *
• psr/log: ^3.0

Requires (Dev)

• nyholm/psr7: ^1.0
• phpstan/phpstan: ^2.0
• phpunit/phpunit: ^13.0
• rector/rector: ^2.0
• symfony/http-client: ^7.0 || ^8.0
• symfony/var-dumper: ^7.0 || ^8.0
• symplify/easy-coding-standard: ^13.0

MIT

• Tobias Köngeter

README

Bit&Black Hyphenizer SDK for PHP

Use the Bit&Black Hyphenizer API in PHP to supercharge your typography.

Installation

This library is made for the use with Composer. Add it to your project by running $ composer require bitandblack/hyphenizer-sdk-php.

Usage

First of all, make sure you have an API token to access the Hyphenizer API. You can create on under www.hyphenizer.com.

Creating and using the client

To communicate with the Hyphenizer API, the HyphenizerClient class can be used:

<?php

use BitAndBlack\Hyphenizer\Sdk\HyphenizerClient;

$hyphenizerClient = new HyphenizerClient('your_token');

There are two methods to call the API and get its response: getSingleWordRequest and getMultipleWordsRequest. They provide detailed information about the requested words:

<?php

$wordsToHyphenated = [
    'Bodensee',
    'Bodenseefelchen',
];

$wordsHyphenated = $hyphenizerClient->getMultipleWordsRequest($wordsToHyphenated);

/**
 * This will dump:
 *
 * object(BitAndBlack\Hyphenizer\Sdk\Api\WordsResponse) {
 *     ["status":"BitAndBlack\Hyphenizer\Sdk\Api\WordsResponse"] => int(200)
 *     ["messages":"BitAndBlack\Hyphenizer\Sdk\Api\WordsResponse"] => array(0) {}
 *     ["payload":"BitAndBlack\Hyphenizer\Sdk\Api\WordsResponse"] => object(BitAndBlack\Hyphenizer\Sdk\Api\WordsPayload) {
 *         ["words":"BitAndBlack\Hyphenizer\Sdk\Api\WordsPayload"] => array(2) {
 *             ["Bodensee"] => array(1) {
 *                 [0] => object(BitAndBlack\Hyphenizer\Sdk\Api\Word) {
 *                     ["hyphenation":"BitAndBlack\Hyphenizer\Sdk\Api\Word"] => string(9) "Boden|see"
 *                     ["score":"BitAndBlack\Hyphenizer\Sdk\Api\Word"] => int(100)
 *                     ["approved":"BitAndBlack\Hyphenizer\Sdk\Api\Word"] => bool(true)
 *                     ["hasTypo":"BitAndBlack\Hyphenizer\Sdk\Api\Word"] => bool(false)
 *                 }
 *             }
 *             ["Bodenseefelchen"] => array(1) {
 *                 [0] => object(BitAndBlack\Hyphenizer\Sdk\Api\Word) {
 *                     ["hyphenation":"BitAndBlack\Hyphenizer\Sdk\Api\Word"] => string(16) "Bodensee|felchen"
 *                     ["score":"BitAndBlack\Hyphenizer\Sdk\Api\Word"] => int(100)
 *                     ["approved":"BitAndBlack\Hyphenizer\Sdk\Api\Word"] => bool(true)
 *                     ["hasTypo":"BitAndBlack\Hyphenizer\Sdk\Api\Word"] => bool(false)
 *                 }
 *             }
 *         }
 *     }
 * }
 */
var_dump($wordsHyphenated);

If you are satisfied with receiving a simple list of the hyphenated words, you can also use methods getSingleWordHyphenated and getWordsHyphenated:

<?php

$wordsToHyphenated = [
    'Bodensee',
    'Bodenseefelchen',
];

$wordsHyphenated = $hyphenizerClient->getWordsHyphenated($wordsToHyphenated);

/**
 * This will dump: 
 * 
 * array(2) {
 *     ["Bodensee"] => string(9) "Boden|see"
 *     ["Bodenseefelchen"] => string(16) "Bodensee|felchen"
 * }
 */
var_dump($wordsHyphenated);

Using the hyphenation library

To store and manage the words and their hyphenations, you can make use of the HyphenationLibrary class.

The Hyphenation Library makes use of us the league/flysystem library, so you can decide where you want to store the words. Per default, it makes use of the LocalFilesystemAdapter:

<?php

use BitAndBlack\Hyphenizer\Sdk\HyphenationLibrary;

$hyphenationLibrary = new HyphenationLibrary(
    // Optional: new MyCustomFileSystemAdapter()
);

Those methods will help you to maintain you library:

• addWords: Adds one or more unhyphenated words to the library.
• getHyphenationWords: Returns a list of all existing words and their hyphenation.
• setHyphenationWords: Resets the library of hyphenated words. This overrides the existing library entirely.

Before reading or writing the list of words, the Hyphenation Library will call a callback, that you can use the encode/decode or compress/uncompress the list:

• setCallbackFileReadAfter: Defines the callback that gets used after reading the list. For example:

  <?php
  
  $hyphenationLibrary->setCallbackFileReadAfter(
      static fn (string $content): string => base64_decode($content);
  );

• setCallbackFileWriteBefore: Defines the callback that gets used before writing the list. For example:

  <?php
  
  $hyphenationLibrary->setCallbackFileWriteBefore(
      static fn (string $content): string => base64_encode($content);
  );

Help

If you have any questions, feel free to contact us under [e-mail].

Further information about Bit&Black can be found under www.bitandblack.com.