DO NOT MERGE: (to be split into separate PRs)

[zanbaldwin]

• Add getCommonCidr() functionality.
  • Add unit tests for method for all version types.
  • Add documentation about method.
• Updated inRange() method:
  • Fix bug when comparing IPv6 and IPv4-embedded addresses (incorrect network addresses compared).
  • Will now throw InvalidCidrException on an invalid CIDR, instead of just returning false.
  • Will now throw WrongVersionException on comparing two IPs of differing byte-length (IPv4 vs IPv6/IPv4-embedded).
• Static class Binary now split into Binary and MbString utility classes:
  • Add unit tests for each, and
  • Added to documentation, so they are discoverable (no longer internal).
• Helper methods in Multi now correctly detect IPv4 according to embedding strategy and CIDR.
• Update a load of documentation.
  • Add section about instantiation via static factory method.
  • Reword headings and method declarations/signatures.
  • Reword concepts section (CIDRs and IP comparisons), with examples.
  • Switch Doctrine entity example to PHP 8+ attributes.
  • Mention the word "Poop".
• Ignore tests and documentation when exporting Git archive (eg, download package via Composer).
• Added Psalm configuration (tests/psalm.xml) to project instead of auto-generating in CI static-analysis pipeline.
• Update DocComments (change to one-liners if only contains one annotation).
• WrongVersionException now returns human-readable IP address string instead of binary where possible.

[zanbaldwin]

Superceded