v3.0.1

3.0.1 (2026-06-30)

🐛 Bug Fixes

• encrypt classic Votifier packets with PKCS#1 v1.5 padding (ef4600b)
• include the underlying reason and host when a connection can't be opened (4aee88d), closes #4
• support PHP 7.1 through 8.5 (95bd6dd)
• time out and report when a server sends no response (27bbfb8), closes #5

📚 Documentation

• overhaul the Sphinx documentation (919905f)

v3.0.0

3.0.0 (2020-10-26)

⚠ BREAKING CHANGES

• Namespace changed from D3strukt0r\VotifierClient to D3strukt0r\Votifier\Client. Update every use statement.

• Classes were moved and renamed:

  • ServerType\ClassicVotifier → Server\Votifier
  • ServerType\NuVotifier → Server\NuVotifier
  • ServerType\ServerTypeInterface → Server\ServerInterface
  • VoteType\ClassicVote → Vote\ClassicVote
  • VoteType\VoteInterface → Vote\VoteInterface
  • ServerConnection → Socket (internal), and the Messages class was removed.

• Construction is now a fluent builder (no more positional constructors), and you send on the server object directly — the Vote wrapper class is gone. sendVote() is variadic, so several votes can be sent at once:

  // before (2.x)
  $serverType = new ClassicVotifier('127.0.0.1', null, $publicKey);
  $voteType = new ClassicVote($username, 'Your vote list', $ip);
  (new Vote($voteType, $serverType))->send();
  
  // after (3.0.0)
  use D3strukt0r\Votifier\Client\Server\Votifier;
  use D3strukt0r\Votifier\Client\Vote\ClassicVote;
  
  $server = (new Votifier())->setHost('127.0.0.1')->setPublicKey($publicKey); // ->setPort() optional, defaults to 8192
  $vote = (new ClassicVote())->setUsername($username)->setServiceName('Your vote list')->setAddress($ip);
  $server->sendVote($vote);

  For NuVotifier v2: (new NuVotifier())->setHost('127.0.0.1')->setProtocolV2(true)->setToken('...').

• Failures now throw dedicated typed exceptions instead of a generic \Exception. Catch what you need: Exception\NotVotifierException; the NuVotifier family Exception\NuVotifierChallengeInvalidException, Exception\NuVotifierSignatureInvalidException, Exception\NuVotifierUnknownServiceException, Exception\NuVotifierUsernameTooLongException; and the transport-level Exception\Socket\NoConnectionException, Exception\Socket\PackageNotSentException, Exception\Socket\PackageNotReceivedException. A missing required field throws \InvalidArgumentException.

• verifyConnection() is available on a server to check reachability before sending.

♻️ Refactoring

• redesign Vote/Server API and rename to D3strukt0r\Votifier\Client (2978a21)
• reorganize Server, Vote and Exception class layout (224a1e8)
• adopt PSR-12 and add dedicated exception classes (9743475)

v2.1.2

2.1.2 (2020-08-31)

🧹 Chores

• migrate CI from Travis CI to GitHub Actions and fix coverage reporting (67165e1)

v2.1.1

2.1.1 (2020-04-25)

🐛 Bug Fixes

• use correct NuVotifier server-error message and default language to null (dfdf118)

📚 Documentation

• migrate documentation from README to Sphinx (c04368e)

v2.1.0

2.1.0 (2020-03-09)

🐛 Bug Fixes

• resolve socket connection bugs and add PHP_CodeSniffer (df15ece)

♻️ Refactoring

• rename LICENSE.md to LICENSE.txt (0a47e31)
• drop deprecated PHP versions and add type declarations (a33754a)

v2.0.0

2.0.0 (2018-04-24)

⚠ BREAKING CHANGES

• Namespace changed from Votifier\Client to D3strukt0r\VotifierClient (with ServerType\ and VoteType\ sub-namespaces). Update every use statement.

• The single Vote class with a six-argument constructor was removed. You now compose a server type, a vote type and a Vote wrapper, then call send():

  // before (1.x)
  use Votifier\Client\Vote;
  (new Vote('127.0.0.1', 8192, $publicKey, $username, 'My list', $ip))->send();
  
  // after (2.0.0)
  use D3strukt0r\VotifierClient\ServerType\ClassicVotifier;
  use D3strukt0r\VotifierClient\VoteType\ClassicVote;
  use D3strukt0r\VotifierClient\Vote;
  
  $serverType = new ClassicVotifier('127.0.0.1', null, $publicKey); // null port defaults to 8192
  $voteType = new ClassicVote($username, 'My list', $ip);
  (new Vote($voteType, $serverType))->send();

• NuVotifier is now supported via ServerType\NuVotifier($host, $port, $publicKey, $protocolV2 = false, $token = null) — pass true and a token for the v2 protocol.

• Sending still throws a generic \Exception on failure (typed exceptions arrive in 3.0.0).

v1.0.0

1.0.0 (2018-04-22)

🧹 Chores

• refine the Composer configuration and project files (923994f)
• rename the license to LICENSE.md and stop tracking IDE project files (90f3012)

v0.0.1

0.0.1 (2016-03-13)

✨ Features

• add Votifier client and convert to a Composer package (2c59024)

♻️ Refactoring

• restructure namespace and class layout (8e28858)
• relocate client classes into the Votifier\Client namespace (2d728e4)