PackageTrack
Sign in Get early access

maxmind-db/reader

MaxMind DB Reader API

v1.13.1 113M downloads/mo #372 most downloaded on Packagist maxmind/MaxMind-DB-Reader-php

What this package is like to depend on

Last release 9 months ago

21 Nov 2025

Release timing varies

gaps range from 5 weeks to 2.1 years

Nearly every release is documented

notes for 32 of 32 stable releases

Nothing withdrawn

no release was ever pulled

13 years old

32 releases · first in 2013

2 releases in the last 12 months

see the full history below

Release timeline

32 releases · Jul 2013 to Nov 2025
2014 2016 2018 2020 2022 2024 2026
Release Pre-release

Releases

latest 32
  1. v1.13.1 21 Nov 2025
    Release notes
    • First PIE release. No other changes.
    Open source →
    Release notes
    • First PIE release. No other changes.
    Open source →
  2. v1.13.0 20 Nov 2025
    Release notes
    • A redundant filesize() call in the reader's constructor was removed.
      Pull request by Pavel Djundik. GitHub #189.
    Open source →
    Release notes
    • A redundant filesize() call in the reader's constructor was removed. Pull request by Pavel Djundik. GitHub #189.
    Open source →
  3. v1.12.1 05 May 2025
    Release notes
    • The C extension now checks that the database metadata lookup was
      successful.
    Open source →
    Release notes
    • The C extension now checks that the database metadata lookup was successful.
    Open source →
  4. v1.12.0 14 Nov 2024
    Release notes
    • Improve the error handling when the user tries to open a directory
      with the pure PHP reader.
    • Improve the typehints on arrays in the PHPDocs.
    Open source →
    Release notes
    • Improve the error handling when the user tries to open a directory with the pure PHP reader.
    • Improve the typehints on arrays in the PHPDocs.
    Open source →
  5. v1.11.1 02 Dec 2023
    Release notes
    • Resolve warnings when compiling the C extension.
    • Fix various type issues detected by PHPStan level. Pull request by
      LauraTaylorUK. GitHub #160.
    Open source →
    Release notes
    • Resolve warnings when compiling the C extension.
    • Fix various type issues detected by PHPStan level. Pull request by LauraTaylorUK. GitHub #160.
    Open source →
  6. v1.11.0 18 Oct 2021
    Release notes
    • Replace runtime define of a constant to facilitate opcache preloading.
      Reported by vedadkajtaz. GitHub #134.
    • Resolve minor issue found by the Clang static analyzer in the C
      extension.
    Open source →
    Release notes
    • Replace runtime define of a constant to facilitate opcache preloading. Reported by vedadkajtaz. GitHub #134.
    • Resolve minor issue found by the Clang static analyzer in the C extension.
    Open source →
  7. v1.10.1 14 Apr 2021
    Release notes
    • Fix a TypeError exception in the pure PHP reader when using large
      databases on 32-bit PHP builds with the bcmath extension. Reported
      by dodo1708. GitHub #124.
    Open source →
    Release notes
    • Fix a TypeError exception in the pure PHP reader when using large databases on 32-bit PHP builds with the bcmath extension. Reported by dodo1708. GitHub #124.
    Open source →
  8. v1.10.0 09 Feb 2021
    Release notes
    • When using the pure PHP reader, unsigned integers up to PHP_MAX_INT
      will now be integers in PHP rather than strings. Previously integers
      greater than 2^24 on 32-bit platforms and 2^56 on 64-bit platforms
      would be strings due to the use of gmp or bcmath to decode them.
      Reported by Alejandro Celaya. GitHub #119.
    Open source →
    Release notes
    • When using the pure PHP reader, unsigned integers up to PHP_MAX_INT will now be integers in PHP rather than strings. Previously integers greater than 2^24 on 32-bit platforms and 2^56 on 64-bit platforms would be strings due to the use of gmp or bcmath to decode them. Reported by Alejandro Celaya. GitHub #119.
    Open source →
  9. v1.9.0 07 Jan 2021
    Release notes
    • The maxminddb extension is now buildable on Windows. Pull request
      by Jan Ehrhardt. GitHub #115.
    Open source →
    Release notes
    • The maxminddb extension is now buildable on Windows. Pull request by Jan Ehrhardt. GitHub #115.
    Open source →
  10. v1.8.0 01 Oct 2020
    Release notes
    • Fixes for PHP 8.0. Pull Request by Remi Collet. GitHub #108.
    Open source →
    Release notes
    • Fixes for PHP 8.0. Pull Request by Remi Collet. GitHub #108.
    Open source →
  11. v1.7.0 07 Aug 2020
    Release notes
    • IMPORTANT: PHP 7.2 or greater is now required.
    • The extension no longer depends on the pure PHP classes in maxmind-db/reader. You can use it independently.
    • Type hints have been added to both the pure PHP implementation and the extension.
    • The metadata method on the reader now returns a new copy of the metadata object rather than the actual object used by the reader.
    • Work around PHP is_readable() bug. Reported by Ben Roberts. GitHub #92.
    • This is the first release of the extension as a PECL package. GitHub #34.
    Open source →
  12. v1.6.0 19 Dec 2019
    Release notes
    • 1.5.0 and 1.5.1 contained a possible memory corruptions when using getWithPrefixLen. This has been fixed. Reported by proton-ab. GitHub #96.
    • The composer.json file now conflicts with all versions of the maxminddb C extension less than the Composer version. This is to reduce the chance of having an older, conflicting version of the extension installed. You will need to upgrade the extension before running composer update. Pull request by Benoît Burnichon. GitHub #97.
    Open source →
  13. v1.5.1 12 Dec 2019
    Release notes
    • Minor performance improvements.
    • Make tests pass with older versions of libmaxminddb. PR by Remi Collet. GitHub #90.
    • Test enhancements. PR by Chun-Sheng, Li. GitHub #91.
    Open source →
  14. v1.5.0 30 Sep 2019
    Release notes
    • PHP 5.6 or greater is now required.
    • The C extension now supports PHP 8. Pull request by John Boehr. GitHub #87.
    • A new method, getWithPrefixLen, was added to the Reader class. This method returns an array containing the record and the prefix length for that record. GitHub #89.
    Open source →
  15. v1.4.1 04 Jan 2019
    Release notes
    • The maxminddb extension now returns a string when a uint32 value is greater than LONG_MAX. Previously, the value would overflow. This generally only affects 32-bit machines. Reported by Remi Collet. GitHub #79.
    • For uint64 values, the maxminddb extension now returns an integer rather than a string when the value is less than or equal to LONG_MAX. This more closely matches the behavior of the pure PHP reader.
    Open source →
  16. v1.4.0 20 Nov 2018
    Release notes
    • The maxminddb extension now has the arginfo when using reflection. PR by Remi Collet. GitHub #75.
    • The maxminddb extension now provides MINFO() function that displays the extension version and the libmaxminddb version. PR by Remi Collet. GitHub #74.
    • The maxminddb configure script now uses pkg-config when available to get libmaxmindb build info. PR by Remi Collet. GitHub #73.
    • The pure PHP reader now correctly decodes integers on 32-bit platforms. Previously, large integers would overflow. Reported by Remi Collet. GitHub #77.
    • There are small performance improvements for the pure PHP reader.
    Open source →
  17. v1.3.0 21 Feb 2018
    Release notes
    • IMPORTANT: The maxminddb extension now obeys open_basedir. If open_basedir is set, you must store the database within the specified directory. Placing the file outside of this directory will result in an exception. Please test your integration before upgrading the extension. This does not affect the pure PHP implementation, which has always had this restriction. Reported by Benoît Burnichon. GitHub #61.
    • A custom autoload.php file is provided for installations without Composer. GitHub #56.
    Open source →
  18. v1.2.0 27 Oct 2017
    Release notes
    • PHP 5.4 or greater is now required.
    • The Reader class for the maxminddb extension is no longer final. This was change to match the behavior of the pure PHP class. Reported and fixed by venyii. GitHub #52 & #54.
    Open source →
  19. v1.1.3 19 Jan 2017
    Release notes
    • Fix incorrect version in ext/php_maxminddb.h. GitHub #48.
    Open source →
  20. v1.1.2 21 Nov 2016
    Release notes
    • Searching for database metadata only occurs within the last 128KB (128 * 1024 bytes) of the file, speeding detection of corrupt datafiles. Reported by Eric Teubert. GitHub #42.
    • Suggest relevant extensions when installing with Composer. GitHub #37.
    Open source →
  21. v1.1.1 15 Sep 2016
    Release notes
    • Development files were added to the .gitattributes as export-ignore so that they are not part of the Composer release. Pull request by Michele Locati. GitHub #39.
    Open source →
  22. v1.1.0 04 Jan 2016
    Release notes
    • The MaxMind DB extension now supports PHP 7. Pull request by John Boehr. GitHub #27.
    Open source →
  23. v1.0.3 13 Mar 2015
    Release notes
    • All uses of strlen were removed. This should prevent issues in situations where the function is overloaded or otherwise broken.
    Open source →
  24. v1.0.2 19 Jan 2015
    Release notes
    • Previously the MaxMind DB extension would cause a segfault if the Reader object's destructor was called without first having called the constructor. (Reported by Matthias Saou & Juan Peri. GitHub #20.)
    Open source →
  25. v1.0.1 12 Jan 2015
    Release notes
    • In the last several releases, the version number in the extension was incorrect. This release is being done to correct it. No other code changes are included.
    Open source →
  26. v1.0.0 22 Sep 2014
    Release notes
    • First production release.
    • In the pure PHP reader, a string length test after fread() was replaced with the difference between the start pointer and the end pointer. This provided a 15% speed increase.
    Open source →
  27. v0.3.3 15 Sep 2014
    Release notes
    • Clarified behavior of 128-bit type in documentation.
    • Updated phpunit and fixed some test breakage from the newer version.
    Open source →
  28. v0.3.2 10 Sep 2014
    Release notes
    • Fixed invalid reference to global class RuntimeException from namespaced code. Fixed by Steven Don. GitHub issue #15.
    • Additional documentation of Metadata class as well as misc. documentation cleanup.
    Open source →
  29. v0.3.1 01 May 2014
    Release notes
    • The API now works when mbstring.func_overload is set.
    • BCMath is no longer required. If the decoder encounters a big integer, it will try to use GMP and then BCMath. If both of those fail, it will throw an exception. No databases released by MaxMind currently use big integers.
    • The API now officially supports HHVM when using the pure PHP reader.
    Open source →
  30. v0.3.0 19 Feb 2014
    Release notes
    • This API is now licensed under the Apache License, Version 2.0.
    • The code for the C extension was cleaned up, fixing several potential issues.
    Open source →
  31. v0.2.0 21 Oct 2013
    Release notes
    • Added optional C extension for using libmaxminddb in place of the pure PHP reader.
    • Significantly improved error handling in pure PHP reader.
    • Improved performance for IPv4 lookups in an IPv6 database.
    Open source →
  32. v0.1.0 16 Jul 2013
    Release notes
    • Initial release
    Open source →

Every package, every release, already written down.

The archive is open and free. Watching your own project is what we are building next.

Browse the archive