commit 2ccad3b139ccd1c77e25e594b812071a092cb64b
Author: Miraty <miraty@antopie.org>
Date:   Wed Sep 29 14:37:44 2021 +0200

    Initial commit

diff --git a/db-reader/CHANGELOG.md b/db-reader/CHANGELOG.md
new file mode 100644
index 0000000..7b74978
--- /dev/null
+++ b/db-reader/CHANGELOG.md
@@ -0,0 +1,222 @@
+CHANGELOG
+=========
+
+1.10.1 (2021-04-14)
+-------------------
+
+* 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.
+
+1.10.0 (2021-02-09)
+-------------------
+
+* 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.
+
+1.9.0 (2021-01-07)
+------------------
+
+* The `maxminddb` extension is now buildable on Windows. Pull request
+  by Jan Ehrhardt. GitHub #115.
+
+1.8.0 (2020-10-01)
+------------------
+
+* Fixes for PHP 8.0. Pull Request by Remi Collet. GitHub #108.
+
+1.7.0 (2020-08-07)
+------------------
+
+* 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.
+
+1.6.0 (2019-12-19)
+------------------
+
+* 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.
+
+1.5.1 (2019-12-12)
+------------------
+
+* 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.
+
+1.5.0 (2019-09-30)
+------------------
+
+* 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.
+
+1.4.1 (2019-01-04)
+------------------
+
+* 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.
+
+1.4.0 (2018-11-20)
+------------------
+
+* 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.
+
+1.3.0 (2018-02-21)
+------------------
+
+* 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.
+
+1.2.0 (2017-10-27)
+------------------
+
+* 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.
+
+1.1.3 (2017-01-19)
+------------------
+
+* Fix incorrect version in `ext/php_maxminddb.h`. GitHub #48.
+
+1.1.2 (2016-11-22)
+------------------
+
+* 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.
+
+1.1.1 (2016-09-15)
+------------------
+
+* 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.
+
+1.1.0 (2016-01-04)
+------------------
+
+* The MaxMind DB extension now supports PHP 7. Pull request by John Boehr.
+  GitHub #27.
+
+1.0.3 (2015-03-13)
+------------------
+
+* All uses of `strlen` were removed. This should prevent issues in situations
+  where the function is overloaded or otherwise broken.
+
+1.0.2 (2015-01-19)
+------------------
+
+* 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.)
+
+1.0.1 (2015-01-12)
+------------------
+
+* 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.
+
+1.0.0 (2014-09-22)
+------------------
+
+* 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.
+
+0.3.3 (2014-09-15)
+------------------
+
+* Clarified behavior of 128-bit type in documentation.
+* Updated phpunit and fixed some test breakage from the newer version.
+
+0.3.2 (2014-09-10)
+------------------
+
+* 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.
+
+0.3.1 (2014-05-01)
+------------------
+
+* 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.
+
+0.3.0 (2014-02-19)
+------------------
+
+* 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.
+
+0.2.0 (2013-10-21)
+------------------
+
+* 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.
+
+0.1.0 (2013-07-16)
+------------------
+
+* Initial release
diff --git a/db-reader/LICENSE b/db-reader/LICENSE
new file mode 100644
index 0000000..d645695
--- /dev/null
+++ b/db-reader/LICENSE
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/db-reader/README.md b/db-reader/README.md
new file mode 100644
index 0000000..49fa280
--- /dev/null
+++ b/db-reader/README.md
@@ -0,0 +1,185 @@
+# MaxMind DB Reader PHP API #
+
+## Description ##
+
+This is the PHP API for reading MaxMind DB files. MaxMind DB is a binary file
+format that stores data indexed by IP address subnets (IPv4 or IPv6).
+
+## Installation (Composer) ##
+
+We recommend installing this package with [Composer](https://getcomposer.org/).
+
+### Download Composer ###
+
+To download Composer, run in the root directory of your project:
+
+```bash
+curl -sS https://getcomposer.org/installer | php
+```
+
+You should now have the file `composer.phar` in your project directory.
+
+### Install Dependencies ###
+
+Run in your project root:
+
+```
+php composer.phar require maxmind-db/reader:~1.0
+```
+
+You should now have the files `composer.json` and `composer.lock` as well as
+the directory `vendor` in your project directory. If you use a version control
+system, `composer.json` should be added to it.
+
+### Require Autoloader ###
+
+After installing the dependencies, you need to require the Composer autoloader
+from your code:
+
+```php
+require 'vendor/autoload.php';
+```
+
+## Installation (Standalone) ##
+
+If you don't want to use Composer for some reason, a custom
+`autoload.php` is provided for you in the project root. To use the
+library, simply include that file,
+
+```php
+require('/path/to/MaxMind-DB-Reader-php/autoload.php');
+```
+
+and then instantiate the reader class normally:
+
+```php
+use MaxMind\Db\Reader;
+$reader = new Reader('example.mmdb');
+```
+
+## Installation (RPM)
+
+RPMs are available in the [official Fedora repository](https://apps.fedoraproject.org/packages/php-maxminddb).
+
+To install on Fedora, run:
+
+```bash
+dnf install php-maxminddb
+```
+
+To install on CentOS or RHEL 7, first [enable the EPEL repository](https://fedoraproject.org/wiki/EPEL)
+and then run:
+
+```bash
+yum install php-maxminddb
+```
+
+Please note that these packages are *not* maintained by MaxMind.
+
+## Usage ##
+
+## Example ##
+
+```php
+<?php
+require_once 'vendor/autoload.php';
+
+use MaxMind\Db\Reader;
+
+$ipAddress = '24.24.24.24';
+$databaseFile = 'GeoIP2-City.mmdb';
+
+$reader = new Reader($databaseFile);
+
+// get returns just the record for the IP address
+print_r($reader->get($ipAddress));
+
+// getWithPrefixLen returns an array containing the record and the
+// associated prefix length for that record.
+print_r($reader->getWithPrefixLen($ipAddress));
+
+$reader->close();
+```
+
+## Optional PHP C Extension ##
+
+MaxMind provides an optional C extension that is a drop-in replacement for
+`MaxMind\Db\Reader`. In order to use this extension, you must install the
+Reader API as described above and install the extension as described below. If
+you are using an autoloader, no changes to your code should be necessary.
+
+### Installing Extension ###
+
+First install [libmaxminddb](https://github.com/maxmind/libmaxminddb) as
+described in its [README.md
+file](https://github.com/maxmind/libmaxminddb/blob/main/README.md#installing-from-a-tarball).
+After successfully installing libmaxmindb, you may install the extension
+from [pecl](https://pecl.php.net/package/maxminddb):
+
+```
+pecl install maxminddb
+```
+
+Alternatively, you may install it from the source. To do so, run the following
+commands from the top-level directory of this distribution:
+
+```
+cd ext
+phpize
+./configure
+make
+make test
+sudo make install
+```
+
+You then must load your extension. The recommend method is to add the
+following to your `php.ini` file:
+
+```
+extension=maxminddb.so
+```
+
+Note: You may need to install the PHP development package on your OS such as
+php5-dev for Debian-based systems or php-devel for RedHat/Fedora-based ones.
+
+## 128-bit Integer Support ##
+
+The MaxMind DB format includes 128-bit unsigned integer as a type. Although
+no MaxMind-distributed database currently makes use of this type, both the
+pure PHP reader and the C extension support this type. The pure PHP reader
+requires gmp or bcmath to read databases with 128-bit unsigned integers.
+
+The integer is currently returned as a hexadecimal string (prefixed with "0x")
+by the C extension and a decimal string (no prefix) by the pure PHP reader.
+Any change to make the reader implementations always return either a
+hexadecimal or decimal representation of the integer will NOT be considered a
+breaking change.
+
+## Support ##
+
+Please report all issues with this code using the [GitHub issue tracker](https://github.com/maxmind/MaxMind-DB-Reader-php/issues).
+
+If you are having an issue with a MaxMind service that is not specific to the
+client API, please see [our support page](https://www.maxmind.com/en/support).
+
+## Requirements  ##
+
+This library requires PHP 7.2 or greater.
+
+The GMP or BCMath extension may be required to read some databases
+using the pure PHP API.
+
+## Contributing ##
+
+Patches and pull requests are encouraged. All code should follow the PSR-1 and
+PSR-2 style guidelines. Please include unit tests whenever possible.
+
+## Versioning ##
+
+The MaxMind DB Reader PHP API uses [Semantic Versioning](https://semver.org/).
+
+## Copyright and License ##
+
+This software is Copyright (c) 2014-2020 by MaxMind, Inc.
+
+This is free software, licensed under the Apache License, Version 2.0.
diff --git a/db-reader/autoload.php b/db-reader/autoload.php
new file mode 100644
index 0000000..a1119e7
--- /dev/null
+++ b/db-reader/autoload.php
@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * PSR-4 autoloader implementation for the MaxMind\DB namespace.
+ * First we define the 'mmdb_autoload' function, and then we register
+ * it with 'spl_autoload_register' so that PHP knows to use it.
+ *
+ * @param mixed $class
+ */
+
+/**
+ * Automatically include the file that defines <code>class</code>.
+ *
+ * @param string $class
+ *                      the name of the class to load
+ */
+function mmdb_autoload($class): void
+{
+    /*
+    * A project-specific mapping between the namespaces and where
+    * they're located. By convention, we include the trailing
+    * slashes. The one-element array here simply makes things easy
+    * to extend in the future if (for example) the test classes
+    * begin to use one another.
+    */
+    $namespace_map = ['MaxMind\\Db\\' => __DIR__ . '/src/MaxMind/Db/'];
+
+    foreach ($namespace_map as $prefix => $dir) {
+        // First swap out the namespace prefix with a directory...
+        $path = str_replace($prefix, $dir, $class);
+
+        // replace the namespace separator with a directory separator...
+        $path = str_replace('\\', '/', $path);
+
+        // and finally, add the PHP file extension to the result.
+        $path = $path . '.php';
+
+        // $path should now contain the path to a PHP file defining $class
+        if (file_exists($path)) {
+            include $path;
+        }
+    }
+}
+
+spl_autoload_register('mmdb_autoload');
diff --git a/db-reader/composer.json b/db-reader/composer.json
new file mode 100644
index 0000000..8d9f9d5
--- /dev/null
+++ b/db-reader/composer.json
@@ -0,0 +1,44 @@
+{
+    "name": "maxmind-db/reader",
+    "description": "MaxMind DB Reader API",
+    "keywords": ["database", "geoip", "geoip2", "geolocation", "maxmind"],
+    "homepage": "https://github.com/maxmind/MaxMind-DB-Reader-php",
+    "type": "library",
+    "license": "Apache-2.0",
+    "authors": [
+        {
+            "name": "Gregory J. Oschwald",
+            "email": "goschwald@maxmind.com",
+            "homepage": "https://www.maxmind.com/"
+        }
+    ],
+    "require": {
+        "php": ">=7.2"
+    },
+    "suggest": {
+        "ext-bcmath": "bcmath or gmp is required for decoding larger integers with the pure PHP decoder",
+        "ext-gmp": "bcmath or gmp is required for decoding larger integers with the pure PHP decoder",
+        "ext-maxminddb": "A C-based database decoder that provides significantly faster lookups"
+    },
+    "conflict": {
+        "ext-maxminddb": "<1.10.1,>=2.0.0"
+    },
+    "require-dev": {
+        "friendsofphp/php-cs-fixer": "*",
+        "phpunit/phpunit": ">=8.0.0,<10.0.0",
+        "php-coveralls/php-coveralls": "^2.1",
+        "phpunit/phpcov": ">=6.0.0",
+        "squizlabs/php_codesniffer": "3.*",
+        "phpstan/phpstan": "*"
+    },
+    "autoload": {
+        "psr-4": {
+            "MaxMind\\Db\\": "src/MaxMind/Db"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "MaxMind\\Db\\Test\\Reader\\": "tests/MaxMind/Db/Test/Reader"
+        }
+    }
+}
diff --git a/db-reader/ext/config.m4 b/db-reader/ext/config.m4
new file mode 100644
index 0000000..675e00c
--- /dev/null
+++ b/db-reader/ext/config.m4
@@ -0,0 +1,40 @@
+PHP_ARG_WITH(maxminddb,
+    [Whether to enable the MaxMind DB Reader extension],
+    [  --with-maxminddb      Enable MaxMind DB Reader extension support])
+
+PHP_ARG_ENABLE(maxminddb-debug, for MaxMind DB debug support,
+    [ --enable-maxminddb-debug    Enable enable MaxMind DB deubg support], no, no)
+
+if test $PHP_MAXMINDDB != "no"; then
+
+    AC_PATH_PROG(PKG_CONFIG, pkg-config, no)
+
+    AC_MSG_CHECKING(for libmaxminddb)
+    if test -x "$PKG_CONFIG" && $PKG_CONFIG --exists libmaxminddb; then
+        dnl retrieve build options from pkg-config
+        if $PKG_CONFIG libmaxminddb --atleast-version 1.0.0; then
+            LIBMAXMINDDB_INC=`$PKG_CONFIG libmaxminddb --cflags`
+            LIBMAXMINDDB_LIB=`$PKG_CONFIG libmaxminddb --libs`
+            LIBMAXMINDDB_VER=`$PKG_CONFIG libmaxminddb --modversion`
+            AC_MSG_RESULT(found version $LIBMAXMINDDB_VER)
+        else
+            AC_MSG_ERROR(system libmaxminddb must be upgraded to version >= 1.0.0)
+        fi
+        PHP_EVAL_LIBLINE($LIBMAXMINDDB_LIB, MAXMINDDB_SHARED_LIBADD)
+        PHP_EVAL_INCLINE($LIBMAXMINDDB_INC)
+    else
+        AC_MSG_RESULT(pkg-config information missing)
+        AC_MSG_WARN(will use libmaxmxinddb from compiler default path)
+
+        PHP_CHECK_LIBRARY(maxminddb, MMDB_open)
+        PHP_ADD_LIBRARY(maxminddb, 1, MAXMINDDB_SHARED_LIBADD)
+    fi
+
+    if test $PHP_MAXMINDDB_DEBUG != "no"; then
+        CFLAGS="$CFLAGS -Wall -Wextra -Wno-unused-parameter -Wno-missing-field-initializers -Werror"
+    fi
+
+    PHP_SUBST(MAXMINDDB_SHARED_LIBADD)
+
+    PHP_NEW_EXTENSION(maxminddb, maxminddb.c, $ext_shared)
+fi
diff --git a/db-reader/ext/config.w32 b/db-reader/ext/config.w32
new file mode 100644
index 0000000..4eb18f8
--- /dev/null
+++ b/db-reader/ext/config.w32
@@ -0,0 +1,10 @@
+ARG_WITH("maxminddb", "Enable MaxMind DB Reader extension support", "no");
+
+if (PHP_MAXMINDDB == "yes") {
+	if (CHECK_HEADER_ADD_INCLUDE("maxminddb.h", "CFLAGS_MAXMINDDB", PHP_MAXMINDDB +  ";" + PHP_PHP_BUILD + "\\include\\maxminddb") &&
+		CHECK_LIB("libmaxminddb.lib", "maxminddb", PHP_MAXMINDDB)) {
+		EXTENSION("maxminddb", "maxminddb.c");
+	} else {
+		WARNING('Could not find maxminddb.h or libmaxminddb.lib; skipping');
+	}
+}
diff --git a/db-reader/ext/maxminddb.c b/db-reader/ext/maxminddb.c
new file mode 100644
index 0000000..efb2510
--- /dev/null
+++ b/db-reader/ext/maxminddb.c
@@ -0,0 +1,806 @@
+/* MaxMind, Inc., licenses this file to you under the Apache License, Version
+ * 2.0 (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+ * License for the specific language governing permissions and limitations
+ * under the License.
+ */
+
+#include "php_maxminddb.h"
+
+#ifdef HAVE_CONFIG_H
+#include "config.h"
+#endif
+
+#include <php.h>
+#include <zend.h>
+
+#include "Zend/zend_exceptions.h"
+#include "Zend/zend_types.h"
+#include "ext/spl/spl_exceptions.h"
+#include "ext/standard/info.h"
+#include <maxminddb.h>
+
+#ifdef ZTS
+#include <TSRM.h>
+#endif
+
+#define __STDC_FORMAT_MACROS
+#include <inttypes.h>
+
+#define PHP_MAXMINDDB_NS ZEND_NS_NAME("MaxMind", "Db")
+#define PHP_MAXMINDDB_READER_NS ZEND_NS_NAME(PHP_MAXMINDDB_NS, "Reader")
+#define PHP_MAXMINDDB_METADATA_NS                                              \
+    ZEND_NS_NAME(PHP_MAXMINDDB_READER_NS, "Metadata")
+#define PHP_MAXMINDDB_READER_EX_NS                                             \
+    ZEND_NS_NAME(PHP_MAXMINDDB_READER_NS, "InvalidDatabaseException")
+
+#define Z_MAXMINDDB_P(zv) php_maxminddb_fetch_object(Z_OBJ_P(zv))
+typedef size_t strsize_t;
+typedef zend_object free_obj_t;
+
+/* For PHP 8 compatibility */
+#if PHP_VERSION_ID < 80000
+
+#define PROP_OBJ(zv) (zv)
+
+#else
+
+#define PROP_OBJ(zv) Z_OBJ_P(zv)
+
+#define TSRMLS_C
+#define TSRMLS_CC
+#define TSRMLS_DC
+
+/* End PHP 8 compatibility */
+#endif
+
+#ifndef ZEND_ACC_CTOR
+#define ZEND_ACC_CTOR 0
+#endif
+
+/* IS_MIXED was added in 2020 */
+#ifndef IS_MIXED
+#define IS_MIXED IS_UNDEF
+#endif
+
+typedef struct _maxminddb_obj {
+    MMDB_s *mmdb;
+    zend_object std;
+} maxminddb_obj;
+
+PHP_FUNCTION(maxminddb);
+
+static int
+get_record(INTERNAL_FUNCTION_PARAMETERS, zval *record, int *prefix_len);
+static const MMDB_entry_data_list_s *
+handle_entry_data_list(const MMDB_entry_data_list_s *entry_data_list,
+                       zval *z_value TSRMLS_DC);
+static const MMDB_entry_data_list_s *
+handle_array(const MMDB_entry_data_list_s *entry_data_list,
+             zval *z_value TSRMLS_DC);
+static const MMDB_entry_data_list_s *
+handle_map(const MMDB_entry_data_list_s *entry_data_list,
+           zval *z_value TSRMLS_DC);
+static void handle_uint128(const MMDB_entry_data_list_s *entry_data_list,
+                           zval *z_value TSRMLS_DC);
+static void handle_uint64(const MMDB_entry_data_list_s *entry_data_list,
+                          zval *z_value TSRMLS_DC);
+static void handle_uint32(const MMDB_entry_data_list_s *entry_data_list,
+                          zval *z_value TSRMLS_DC);
+
+#define CHECK_ALLOCATED(val)                                                   \
+    if (!val) {                                                                \
+        zend_error(E_ERROR, "Out of memory");                                  \
+        return;                                                                \
+    }
+
+static zend_object_handlers maxminddb_obj_handlers;
+static zend_class_entry *maxminddb_ce, *maxminddb_exception_ce, *metadata_ce;
+
+static inline maxminddb_obj *
+php_maxminddb_fetch_object(zend_object *obj TSRMLS_DC) {
+    return (maxminddb_obj *)((char *)(obj)-XtOffsetOf(maxminddb_obj, std));
+}
+
+ZEND_BEGIN_ARG_INFO_EX(arginfo_maxminddbreader_construct, 0, 0, 1)
+ZEND_ARG_TYPE_INFO(0, db_file, IS_STRING, 0)
+ZEND_END_ARG_INFO()
+
+PHP_METHOD(MaxMind_Db_Reader, __construct) {
+    char *db_file = NULL;
+    strsize_t name_len;
+    zval *_this_zval = NULL;
+
+    if (zend_parse_method_parameters(ZEND_NUM_ARGS() TSRMLS_CC,
+                                     getThis(),
+                                     "Os",
+                                     &_this_zval,
+                                     maxminddb_ce,
+                                     &db_file,
+                                     &name_len) == FAILURE) {
+        return;
+    }
+
+    if (0 != php_check_open_basedir(db_file TSRMLS_CC) ||
+        0 != access(db_file, R_OK)) {
+        zend_throw_exception_ex(
+            spl_ce_InvalidArgumentException,
+            0 TSRMLS_CC,
+            "The file \"%s\" does not exist or is not readable.",
+            db_file);
+        return;
+    }
+
+    MMDB_s *mmdb = (MMDB_s *)ecalloc(1, sizeof(MMDB_s));
+    uint16_t status = MMDB_open(db_file, MMDB_MODE_MMAP, mmdb);
+
+    if (MMDB_SUCCESS != status) {
+        zend_throw_exception_ex(
+            maxminddb_exception_ce,
+            0 TSRMLS_CC,
+            "Error opening database file (%s). Is this a valid "
+            "MaxMind DB file?",
+            db_file);
+        efree(mmdb);
+        return;
+    }
+
+    maxminddb_obj *mmdb_obj = Z_MAXMINDDB_P(getThis());
+    mmdb_obj->mmdb = mmdb;
+}
+
+ZEND_BEGIN_ARG_WITH_RETURN_TYPE_INFO_EX(
+    arginfo_maxminddbreader_get, 0, 1, IS_MIXED, 1)
+ZEND_ARG_TYPE_INFO(0, ip_address, IS_STRING, 0)
+ZEND_END_ARG_INFO()
+
+PHP_METHOD(MaxMind_Db_Reader, get) {
+    int prefix_len = 0;
+    get_record(INTERNAL_FUNCTION_PARAM_PASSTHRU, return_value, &prefix_len);
+}
+
+ZEND_BEGIN_ARG_WITH_RETURN_TYPE_INFO_EX(
+    arginfo_maxminddbreader_getWithPrefixLen, 0, 1, IS_ARRAY, 1)
+ZEND_ARG_TYPE_INFO(0, ip_address, IS_STRING, 0)
+ZEND_END_ARG_INFO()
+
+PHP_METHOD(MaxMind_Db_Reader, getWithPrefixLen) {
+    zval record, z_prefix_len;
+
+    int prefix_len = 0;
+    if (get_record(INTERNAL_FUNCTION_PARAM_PASSTHRU, &record, &prefix_len) ==
+        FAILURE) {
+        return;
+    }
+
+    array_init(return_value);
+    add_next_index_zval(return_value, &record);
+
+    ZVAL_LONG(&z_prefix_len, prefix_len);
+    add_next_index_zval(return_value, &z_prefix_len);
+}
+
+static int
+get_record(INTERNAL_FUNCTION_PARAMETERS, zval *record, int *prefix_len) {
+    char *ip_address = NULL;
+    strsize_t name_len;
+    zval *this_zval = NULL;
+
+    if (zend_parse_method_parameters(ZEND_NUM_ARGS() TSRMLS_CC,
+                                     getThis(),
+                                     "Os",
+                                     &this_zval,
+                                     maxminddb_ce,
+                                     &ip_address,
+                                     &name_len) == FAILURE) {
+        return FAILURE;
+    }
+
+    const maxminddb_obj *mmdb_obj = (maxminddb_obj *)Z_MAXMINDDB_P(getThis());
+
+    MMDB_s *mmdb = mmdb_obj->mmdb;
+
+    if (NULL == mmdb) {
+        zend_throw_exception_ex(spl_ce_BadMethodCallException,
+                                0 TSRMLS_CC,
+                                "Attempt to read from a closed MaxMind DB.");
+        return FAILURE;
+    }
+
+    struct addrinfo hints = {
+        .ai_family = AF_UNSPEC,
+        .ai_flags = AI_NUMERICHOST,
+        /* We set ai_socktype so that we only get one result back */
+        .ai_socktype = SOCK_STREAM};
+
+    struct addrinfo *addresses = NULL;
+    int gai_status = getaddrinfo(ip_address, NULL, &hints, &addresses);
+    if (gai_status) {
+        zend_throw_exception_ex(spl_ce_InvalidArgumentException,
+                                0 TSRMLS_CC,
+                                "The value \"%s\" is not a valid IP address.",
+                                ip_address);
+        return FAILURE;
+    }
+    if (!addresses || !addresses->ai_addr) {
+        zend_throw_exception_ex(
+            spl_ce_InvalidArgumentException,
+            0 TSRMLS_CC,
+            "getaddrinfo was successful but failed to set the addrinfo");
+        return FAILURE;
+    }
+
+    int sa_family = addresses->ai_addr->sa_family;
+
+    int mmdb_error = MMDB_SUCCESS;
+    MMDB_lookup_result_s result =
+        MMDB_lookup_sockaddr(mmdb, addresses->ai_addr, &mmdb_error);
+
+    freeaddrinfo(addresses);
+
+    if (MMDB_SUCCESS != mmdb_error) {
+        zend_class_entry *ex;
+        if (MMDB_IPV6_LOOKUP_IN_IPV4_DATABASE_ERROR == mmdb_error) {
+            ex = spl_ce_InvalidArgumentException;
+        } else {
+            ex = maxminddb_exception_ce;
+        }
+        zend_throw_exception_ex(ex,
+                                0 TSRMLS_CC,
+                                "Error looking up %s. %s",
+                                ip_address,
+                                MMDB_strerror(mmdb_error));
+        return FAILURE;
+    }
+
+    *prefix_len = result.netmask;
+
+    if (sa_family == AF_INET && mmdb->metadata.ip_version == 6) {
+        /* We return the prefix length given the IPv4 address. If there is
+           no IPv4 subtree, we return a prefix length of 0. */
+        *prefix_len = *prefix_len >= 96 ? *prefix_len - 96 : 0;
+    }
+
+    if (!result.found_entry) {
+        ZVAL_NULL(record);
+        return SUCCESS;
+    }
+
+    MMDB_entry_data_list_s *entry_data_list = NULL;
+    int status = MMDB_get_entry_data_list(&result.entry, &entry_data_list);
+
+    if (MMDB_SUCCESS != status) {
+        zend_throw_exception_ex(maxminddb_exception_ce,
+                                0 TSRMLS_CC,
+                                "Error while looking up data for %s. %s",
+                                ip_address,
+                                MMDB_strerror(status));
+        MMDB_free_entry_data_list(entry_data_list);
+        return FAILURE;
+    } else if (NULL == entry_data_list) {
+        zend_throw_exception_ex(
+            maxminddb_exception_ce,
+            0 TSRMLS_CC,
+            "Error while looking up data for %s. Your database may "
+            "be corrupt or you have found a bug in libmaxminddb.",
+            ip_address);
+        return FAILURE;
+    }
+
+    const MMDB_entry_data_list_s *rv =
+        handle_entry_data_list(entry_data_list, record TSRMLS_CC);
+    if (rv == NULL) {
+        /* We should have already thrown the exception in handle_entry_data_list
+         */
+        return FAILURE;
+    }
+    MMDB_free_entry_data_list(entry_data_list);
+    return SUCCESS;
+}
+
+ZEND_BEGIN_ARG_INFO_EX(arginfo_maxminddbreader_void, 0, 0, 0)
+ZEND_END_ARG_INFO()
+
+PHP_METHOD(MaxMind_Db_Reader, metadata) {
+    zval *this_zval = NULL;
+
+    if (zend_parse_method_parameters(ZEND_NUM_ARGS() TSRMLS_CC,
+                                     getThis(),
+                                     "O",
+                                     &this_zval,
+                                     maxminddb_ce) == FAILURE) {
+        return;
+    }
+
+    const maxminddb_obj *const mmdb_obj =
+        (maxminddb_obj *)Z_MAXMINDDB_P(this_zval);
+
+    if (NULL == mmdb_obj->mmdb) {
+        zend_throw_exception_ex(spl_ce_BadMethodCallException,
+                                0 TSRMLS_CC,
+                                "Attempt to read from a closed MaxMind DB.");
+        return;
+    }
+
+    object_init_ex(return_value, metadata_ce);
+
+    MMDB_entry_data_list_s *entry_data_list;
+    MMDB_get_metadata_as_entry_data_list(mmdb_obj->mmdb, &entry_data_list);
+
+    zval metadata_array;
+    const MMDB_entry_data_list_s *rv =
+        handle_entry_data_list(entry_data_list, &metadata_array TSRMLS_CC);
+    if (rv == NULL) {
+        return;
+    }
+    MMDB_free_entry_data_list(entry_data_list);
+    zend_call_method_with_1_params(PROP_OBJ(return_value),
+                                   metadata_ce,
+                                   &metadata_ce->constructor,
+                                   ZEND_CONSTRUCTOR_FUNC_NAME,
+                                   NULL,
+                                   &metadata_array);
+    zval_ptr_dtor(&metadata_array);
+}
+
+PHP_METHOD(MaxMind_Db_Reader, close) {
+    zval *this_zval = NULL;
+
+    if (zend_parse_method_parameters(ZEND_NUM_ARGS() TSRMLS_CC,
+                                     getThis(),
+                                     "O",
+                                     &this_zval,
+                                     maxminddb_ce) == FAILURE) {
+        return;
+    }
+
+    maxminddb_obj *mmdb_obj = (maxminddb_obj *)Z_MAXMINDDB_P(this_zval);
+
+    if (NULL == mmdb_obj->mmdb) {
+        zend_throw_exception_ex(spl_ce_BadMethodCallException,
+                                0 TSRMLS_CC,
+                                "Attempt to close a closed MaxMind DB.");
+        return;
+    }
+    MMDB_close(mmdb_obj->mmdb);
+    efree(mmdb_obj->mmdb);
+    mmdb_obj->mmdb = NULL;
+}
+
+static const MMDB_entry_data_list_s *
+handle_entry_data_list(const MMDB_entry_data_list_s *entry_data_list,
+                       zval *z_value TSRMLS_DC) {
+    switch (entry_data_list->entry_data.type) {
+        case MMDB_DATA_TYPE_MAP:
+            return handle_map(entry_data_list, z_value TSRMLS_CC);
+        case MMDB_DATA_TYPE_ARRAY:
+            return handle_array(entry_data_list, z_value TSRMLS_CC);
+        case MMDB_DATA_TYPE_UTF8_STRING:
+            ZVAL_STRINGL(z_value,
+                         (char *)entry_data_list->entry_data.utf8_string,
+                         entry_data_list->entry_data.data_size);
+            break;
+        case MMDB_DATA_TYPE_BYTES:
+            ZVAL_STRINGL(z_value,
+                         (char *)entry_data_list->entry_data.bytes,
+                         entry_data_list->entry_data.data_size);
+            break;
+        case MMDB_DATA_TYPE_DOUBLE:
+            ZVAL_DOUBLE(z_value, entry_data_list->entry_data.double_value);
+            break;
+        case MMDB_DATA_TYPE_FLOAT:
+            ZVAL_DOUBLE(z_value, entry_data_list->entry_data.float_value);
+            break;
+        case MMDB_DATA_TYPE_UINT16:
+            ZVAL_LONG(z_value, entry_data_list->entry_data.uint16);
+            break;
+        case MMDB_DATA_TYPE_UINT32:
+            handle_uint32(entry_data_list, z_value TSRMLS_CC);
+            break;
+        case MMDB_DATA_TYPE_BOOLEAN:
+            ZVAL_BOOL(z_value, entry_data_list->entry_data.boolean);
+            break;
+        case MMDB_DATA_TYPE_UINT64:
+            handle_uint64(entry_data_list, z_value TSRMLS_CC);
+            break;
+        case MMDB_DATA_TYPE_UINT128:
+            handle_uint128(entry_data_list, z_value TSRMLS_CC);
+            break;
+        case MMDB_DATA_TYPE_INT32:
+            ZVAL_LONG(z_value, entry_data_list->entry_data.int32);
+            break;
+        default:
+            zend_throw_exception_ex(maxminddb_exception_ce,
+                                    0 TSRMLS_CC,
+                                    "Invalid data type arguments: %d",
+                                    entry_data_list->entry_data.type);
+            return NULL;
+    }
+    return entry_data_list;
+}
+
+static const MMDB_entry_data_list_s *
+handle_map(const MMDB_entry_data_list_s *entry_data_list,
+           zval *z_value TSRMLS_DC) {
+    array_init(z_value);
+    const uint32_t map_size = entry_data_list->entry_data.data_size;
+
+    uint32_t i;
+    for (i = 0; i < map_size && entry_data_list; i++) {
+        entry_data_list = entry_data_list->next;
+
+        char *key = estrndup((char *)entry_data_list->entry_data.utf8_string,
+                             entry_data_list->entry_data.data_size);
+        if (NULL == key) {
+            zend_throw_exception_ex(maxminddb_exception_ce,
+                                    0 TSRMLS_CC,
+                                    "Invalid data type arguments");
+            return NULL;
+        }
+
+        entry_data_list = entry_data_list->next;
+        zval new_value;
+        entry_data_list =
+            handle_entry_data_list(entry_data_list, &new_value TSRMLS_CC);
+        if (entry_data_list != NULL) {
+            add_assoc_zval(z_value, key, &new_value);
+        }
+        efree(key);
+    }
+    return entry_data_list;
+}
+
+static const MMDB_entry_data_list_s *
+handle_array(const MMDB_entry_data_list_s *entry_data_list,
+             zval *z_value TSRMLS_DC) {
+    const uint32_t size = entry_data_list->entry_data.data_size;
+
+    array_init(z_value);
+
+    uint32_t i;
+    for (i = 0; i < size && entry_data_list; i++) {
+        entry_data_list = entry_data_list->next;
+        zval new_value;
+        entry_data_list =
+            handle_entry_data_list(entry_data_list, &new_value TSRMLS_CC);
+        if (entry_data_list != NULL) {
+            add_next_index_zval(z_value, &new_value);
+        }
+    }
+    return entry_data_list;
+}
+
+static void handle_uint128(const MMDB_entry_data_list_s *entry_data_list,
+                           zval *z_value TSRMLS_DC) {
+    uint64_t high = 0;
+    uint64_t low = 0;
+#if MMDB_UINT128_IS_BYTE_ARRAY
+    int i;
+    for (i = 0; i < 8; i++) {
+        high = (high << 8) | entry_data_list->entry_data.uint128[i];
+    }
+
+    for (i = 8; i < 16; i++) {
+        low = (low << 8) | entry_data_list->entry_data.uint128[i];
+    }
+#else
+    high = entry_data_list->entry_data.uint128 >> 64;
+    low = (uint64_t)entry_data_list->entry_data.uint128;
+#endif
+
+    char *num_str;
+    spprintf(&num_str, 0, "0x%016" PRIX64 "%016" PRIX64, high, low);
+    CHECK_ALLOCATED(num_str);
+
+    ZVAL_STRING(z_value, num_str);
+    efree(num_str);
+}
+
+static void handle_uint32(const MMDB_entry_data_list_s *entry_data_list,
+                          zval *z_value TSRMLS_DC) {
+    uint32_t val = entry_data_list->entry_data.uint32;
+
+#if LONG_MAX >= UINT32_MAX
+    ZVAL_LONG(z_value, val);
+    return;
+#else
+    if (val <= LONG_MAX) {
+        ZVAL_LONG(z_value, val);
+        return;
+    }
+
+    char *int_str;
+    spprintf(&int_str, 0, "%" PRIu32, val);
+    CHECK_ALLOCATED(int_str);
+
+    ZVAL_STRING(z_value, int_str);
+    efree(int_str);
+#endif
+}
+
+static void handle_uint64(const MMDB_entry_data_list_s *entry_data_list,
+                          zval *z_value TSRMLS_DC) {
+    uint64_t val = entry_data_list->entry_data.uint64;
+
+#if LONG_MAX >= UINT64_MAX
+    ZVAL_LONG(z_value, val);
+    return;
+#else
+    if (val <= LONG_MAX) {
+        ZVAL_LONG(z_value, val);
+        return;
+    }
+
+    char *int_str;
+    spprintf(&int_str, 0, "%" PRIu64, val);
+    CHECK_ALLOCATED(int_str);
+
+    ZVAL_STRING(z_value, int_str);
+    efree(int_str);
+#endif
+}
+
+static void maxminddb_free_storage(free_obj_t *object TSRMLS_DC) {
+    maxminddb_obj *obj =
+        php_maxminddb_fetch_object((zend_object *)object TSRMLS_CC);
+    if (obj->mmdb != NULL) {
+        MMDB_close(obj->mmdb);
+        efree(obj->mmdb);
+    }
+
+    zend_object_std_dtor(&obj->std TSRMLS_CC);
+}
+
+static zend_object *maxminddb_create_handler(zend_class_entry *type TSRMLS_DC) {
+    maxminddb_obj *obj = (maxminddb_obj *)ecalloc(1, sizeof(maxminddb_obj));
+    zend_object_std_init(&obj->std, type TSRMLS_CC);
+    object_properties_init(&(obj->std), type);
+
+    obj->std.handlers = &maxminddb_obj_handlers;
+
+    return &obj->std;
+}
+
+/* clang-format off */
+static zend_function_entry maxminddb_methods[] = {
+    PHP_ME(MaxMind_Db_Reader, __construct, arginfo_maxminddbreader_construct,
+           ZEND_ACC_PUBLIC | ZEND_ACC_CTOR)
+    PHP_ME(MaxMind_Db_Reader, close, arginfo_maxminddbreader_void, ZEND_ACC_PUBLIC)
+    PHP_ME(MaxMind_Db_Reader, get, arginfo_maxminddbreader_get,  ZEND_ACC_PUBLIC)
+    PHP_ME(MaxMind_Db_Reader, getWithPrefixLen, arginfo_maxminddbreader_getWithPrefixLen,  ZEND_ACC_PUBLIC)
+    PHP_ME(MaxMind_Db_Reader, metadata, arginfo_maxminddbreader_void, ZEND_ACC_PUBLIC)
+    { NULL, NULL, NULL }
+};
+/* clang-format on */
+
+ZEND_BEGIN_ARG_INFO_EX(arginfo_metadata_construct, 0, 0, 1)
+ZEND_ARG_TYPE_INFO(0, metadata, IS_ARRAY, 0)
+ZEND_END_ARG_INFO()
+
+PHP_METHOD(MaxMind_Db_Reader_Metadata, __construct) {
+    zval *object = NULL;
+    zval *metadata_array = NULL;
+    zend_long node_count = 0;
+    zend_long record_size = 0;
+
+    if (zend_parse_method_parameters(ZEND_NUM_ARGS() TSRMLS_CC,
+                                     getThis(),
+                                     "Oa",
+                                     &object,
+                                     metadata_ce,
+                                     &metadata_array) == FAILURE) {
+        return;
+    }
+
+    zval *tmp = NULL;
+    if ((tmp = zend_hash_str_find(HASH_OF(metadata_array),
+                                  "binary_format_major_version",
+                                  sizeof("binary_format_major_version") - 1))) {
+        zend_update_property(metadata_ce,
+                             PROP_OBJ(object),
+                             "binaryFormatMajorVersion",
+                             sizeof("binaryFormatMajorVersion") - 1,
+                             tmp);
+    }
+
+    if ((tmp = zend_hash_str_find(HASH_OF(metadata_array),
+                                  "binary_format_minor_version",
+                                  sizeof("binary_format_minor_version") - 1))) {
+        zend_update_property(metadata_ce,
+                             PROP_OBJ(object),
+                             "binaryFormatMinorVersion",
+                             sizeof("binaryFormatMinorVersion") - 1,
+                             tmp);
+    }
+
+    if ((tmp = zend_hash_str_find(HASH_OF(metadata_array),
+                                  "build_epoch",
+                                  sizeof("build_epoch") - 1))) {
+        zend_update_property(metadata_ce,
+                             PROP_OBJ(object),
+                             "buildEpoch",
+                             sizeof("buildEpoch") - 1,
+                             tmp);
+    }
+
+    if ((tmp = zend_hash_str_find(HASH_OF(metadata_array),
+                                  "database_type",
+                                  sizeof("database_type") - 1))) {
+        zend_update_property(metadata_ce,
+                             PROP_OBJ(object),
+                             "databaseType",
+                             sizeof("databaseType") - 1,
+                             tmp);
+    }
+
+    if ((tmp = zend_hash_str_find(HASH_OF(metadata_array),
+                                  "description",
+                                  sizeof("description") - 1))) {
+        zend_update_property(metadata_ce,
+                             PROP_OBJ(object),
+                             "description",
+                             sizeof("description") - 1,
+                             tmp);
+    }
+
+    if ((tmp = zend_hash_str_find(HASH_OF(metadata_array),
+                                  "ip_version",
+                                  sizeof("ip_version") - 1))) {
+        zend_update_property(metadata_ce,
+                             PROP_OBJ(object),
+                             "ipVersion",
+                             sizeof("ipVersion") - 1,
+                             tmp);
+    }
+
+    if ((tmp = zend_hash_str_find(
+             HASH_OF(metadata_array), "languages", sizeof("languages") - 1))) {
+        zend_update_property(metadata_ce,
+                             PROP_OBJ(object),
+                             "languages",
+                             sizeof("languages") - 1,
+                             tmp);
+    }
+
+    if ((tmp = zend_hash_str_find(HASH_OF(metadata_array),
+                                  "record_size",
+                                  sizeof("record_size") - 1))) {
+        zend_update_property(metadata_ce,
+                             PROP_OBJ(object),
+                             "recordSize",
+                             sizeof("recordSize") - 1,
+                             tmp);
+        if (Z_TYPE_P(tmp) == IS_LONG) {
+            record_size = Z_LVAL_P(tmp);
+        }
+    }
+
+    if (record_size != 0) {
+        zend_update_property_long(metadata_ce,
+                                  PROP_OBJ(object),
+                                  "nodeByteSize",
+                                  sizeof("nodeByteSize") - 1,
+                                  record_size / 4);
+    }
+
+    if ((tmp = zend_hash_str_find(HASH_OF(metadata_array),
+                                  "node_count",
+                                  sizeof("node_count") - 1))) {
+        zend_update_property(metadata_ce,
+                             PROP_OBJ(object),
+                             "nodeCount",
+                             sizeof("nodeCount") - 1,
+                             tmp);
+        if (Z_TYPE_P(tmp) == IS_LONG) {
+            node_count = Z_LVAL_P(tmp);
+        }
+    }
+
+    if (record_size != 0) {
+        zend_update_property_long(metadata_ce,
+                                  PROP_OBJ(object),
+                                  "searchTreeSize",
+                                  sizeof("searchTreeSize") - 1,
+                                  record_size * node_count / 4);
+    }
+}
+
+// clang-format off
+static zend_function_entry metadata_methods[] = {
+    PHP_ME(MaxMind_Db_Reader_Metadata, __construct, arginfo_metadata_construct, ZEND_ACC_PUBLIC | ZEND_ACC_CTOR)
+    {NULL, NULL, NULL}
+};
+// clang-format on
+
+PHP_MINIT_FUNCTION(maxminddb) {
+    zend_class_entry ce;
+
+    INIT_CLASS_ENTRY(ce, PHP_MAXMINDDB_READER_EX_NS, NULL);
+    maxminddb_exception_ce =
+        zend_register_internal_class_ex(&ce, zend_ce_exception);
+
+    INIT_CLASS_ENTRY(ce, PHP_MAXMINDDB_READER_NS, maxminddb_methods);
+    maxminddb_ce = zend_register_internal_class(&ce TSRMLS_CC);
+    maxminddb_ce->create_object = maxminddb_create_handler;
+
+    INIT_CLASS_ENTRY(ce, PHP_MAXMINDDB_METADATA_NS, metadata_methods);
+    metadata_ce = zend_register_internal_class(&ce TSRMLS_CC);
+    zend_declare_property_null(metadata_ce,
+                               "binaryFormatMajorVersion",
+                               sizeof("binaryFormatMajorVersion") - 1,
+                               ZEND_ACC_PUBLIC);
+    zend_declare_property_null(metadata_ce,
+                               "binaryFormatMinorVersion",
+                               sizeof("binaryFormatMinorVersion") - 1,
+                               ZEND_ACC_PUBLIC);
+    zend_declare_property_null(
+        metadata_ce, "buildEpoch", sizeof("buildEpoch") - 1, ZEND_ACC_PUBLIC);
+    zend_declare_property_null(metadata_ce,
+                               "databaseType",
+                               sizeof("databaseType") - 1,
+                               ZEND_ACC_PUBLIC);
+    zend_declare_property_null(
+        metadata_ce, "description", sizeof("description") - 1, ZEND_ACC_PUBLIC);
+    zend_declare_property_null(
+        metadata_ce, "ipVersion", sizeof("ipVersion") - 1, ZEND_ACC_PUBLIC);
+    zend_declare_property_null(
+        metadata_ce, "languages", sizeof("languages") - 1, ZEND_ACC_PUBLIC);
+    zend_declare_property_null(metadata_ce,
+                               "nodeByteSize",
+                               sizeof("nodeByteSize") - 1,
+                               ZEND_ACC_PUBLIC);
+    zend_declare_property_null(
+        metadata_ce, "nodeCount", sizeof("nodeCount") - 1, ZEND_ACC_PUBLIC);
+    zend_declare_property_null(
+        metadata_ce, "recordSize", sizeof("recordSize") - 1, ZEND_ACC_PUBLIC);
+    zend_declare_property_null(metadata_ce,
+                               "searchTreeSize",
+                               sizeof("searchTreeSize") - 1,
+                               ZEND_ACC_PUBLIC);
+
+    memcpy(&maxminddb_obj_handlers,
+           zend_get_std_object_handlers(),
+           sizeof(zend_object_handlers));
+    maxminddb_obj_handlers.clone_obj = NULL;
+    maxminddb_obj_handlers.offset = XtOffsetOf(maxminddb_obj, std);
+    maxminddb_obj_handlers.free_obj = maxminddb_free_storage;
+    zend_declare_class_constant_string(maxminddb_ce,
+                                       "MMDB_LIB_VERSION",
+                                       sizeof("MMDB_LIB_VERSION") - 1,
+                                       MMDB_lib_version() TSRMLS_CC);
+
+    return SUCCESS;
+}
+
+static PHP_MINFO_FUNCTION(maxminddb) {
+    php_info_print_table_start();
+
+    php_info_print_table_row(2, "MaxMind DB Reader", "enabled");
+    php_info_print_table_row(
+        2, "maxminddb extension version", PHP_MAXMINDDB_VERSION);
+    php_info_print_table_row(
+        2, "libmaxminddb library version", MMDB_lib_version());
+
+    php_info_print_table_end();
+}
+
+zend_module_entry maxminddb_module_entry = {STANDARD_MODULE_HEADER,
+                                            PHP_MAXMINDDB_EXTNAME,
+                                            NULL,
+                                            PHP_MINIT(maxminddb),
+                                            NULL,
+                                            NULL,
+                                            NULL,
+                                            PHP_MINFO(maxminddb),
+                                            PHP_MAXMINDDB_VERSION,
+                                            STANDARD_MODULE_PROPERTIES};
+
+#ifdef COMPILE_DL_MAXMINDDB
+ZEND_GET_MODULE(maxminddb)
+#endif
diff --git a/db-reader/ext/php_maxminddb.h b/db-reader/ext/php_maxminddb.h
new file mode 100644
index 0000000..cba9ed5
--- /dev/null
+++ b/db-reader/ext/php_maxminddb.h
@@ -0,0 +1,24 @@
+/* MaxMind, Inc., licenses this file to you under the Apache License, Version
+ * 2.0 (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+ * License for the specific language governing permissions and limitations
+ * under the License.
+ */
+
+#include <zend_interfaces.h>
+
+#ifndef PHP_MAXMINDDB_H
+#define PHP_MAXMINDDB_H 1
+#define PHP_MAXMINDDB_VERSION "1.10.1"
+#define PHP_MAXMINDDB_EXTNAME "maxminddb"
+
+extern zend_module_entry maxminddb_module_entry;
+#define phpext_maxminddb_ptr &maxminddb_module_entry
+
+#endif
diff --git a/db-reader/ext/tests/001-load.phpt b/db-reader/ext/tests/001-load.phpt
new file mode 100644
index 0000000..09810ee
--- /dev/null
+++ b/db-reader/ext/tests/001-load.phpt
@@ -0,0 +1,12 @@
+--TEST--
+Check for maxminddb presence
+--SKIPIF--
+<?php if (!extension_loaded('maxminddb')) {
+    echo 'skip';
+} ?>
+--FILE--
+<?php
+echo 'maxminddb extension is available';
+?>
+--EXPECT--
+maxminddb extension is available
diff --git a/db-reader/ext/tests/002-final.phpt b/db-reader/ext/tests/002-final.phpt
new file mode 100644
index 0000000..d91b7d0
--- /dev/null
+++ b/db-reader/ext/tests/002-final.phpt
@@ -0,0 +1,13 @@
+--TEST--
+Check that Reader class is not final
+--SKIPIF--
+<?php if (!extension_loaded('maxminddb')) {
+    echo 'skip';
+} ?>
+--FILE--
+<?php
+$reflectionClass = new \ReflectionClass('MaxMind\Db\Reader');
+var_dump($reflectionClass->isFinal());
+?>
+--EXPECT--
+bool(false)
diff --git a/db-reader/ext/tests/003-open-basedir.phpt b/db-reader/ext/tests/003-open-basedir.phpt
new file mode 100644
index 0000000..26e9781
--- /dev/null
+++ b/db-reader/ext/tests/003-open-basedir.phpt
@@ -0,0 +1,12 @@
+--TEST--
+openbase_dir is followed
+--INI--
+open_basedir=/--dne--
+--FILE--
+<?php
+use MaxMind\Db\Reader;
+
+$reader = new Reader('/usr/local/share/GeoIP/GeoIP2-City.mmdb');
+?>
+--EXPECTREGEX--
+.*open_basedir restriction in effect.*
diff --git a/db-reader/package.xml b/db-reader/package.xml
new file mode 100644
index 0000000..b687468
--- /dev/null
+++ b/db-reader/package.xml
@@ -0,0 +1,63 @@
+<?xml version="1.0"?>
+<package version="2.0" xmlns="http://pear.php.net/dtd/package-2.0"
+    xmlns:tasks="http://pear.php.net/dtd/tasks-1.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://pear.php.net/dtd/tasks-1.0 http://pear.php.net/dtd/tasks-1.0.xsd http://pear.php.net/dtd/package-2.0 http://pear.php.net/dtd/package-2.0.xsd">
+
+    <name>maxminddb</name>
+    <channel>pecl.php.net</channel>
+    <summary>Reader for the MaxMind DB file format</summary>
+    <description>This is the PHP extension for reading MaxMind DB files. MaxMind DB is a binary file format that stores data indexed by IP address subnets (IPv4 or IPv6).</description>
+    <lead>
+        <name>Greg Oschwald</name>
+        <user>oschwald</user>
+        <email>goschwald@maxmind.com</email>
+        <active>yes</active>
+    </lead>
+    <date>2021-04-14</date>
+    <version>
+        <release>1.10.1</release>
+        <api>1.10.1</api>
+    </version>
+    <stability>
+        <release>stable</release>
+        <api>stable</api>
+    </stability>
+    <license uri="https://github.com/maxmind/MaxMind-DB-Reader-php/blob/main/LICENSE">Apache License 2.0</license>
+    <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.</notes>
+    <contents>
+        <dir name="/">
+            <file role="doc" name="LICENSE"/>
+            <file role="doc" name="CHANGELOG.md"/>
+            <file role="doc" name="README.md"/>
+
+            <dir name="ext">
+                <file role="src" name="config.m4"/>
+                <file role="src" name="config.w32"/>
+
+                <file role="src" name="maxminddb.c"/>
+                <file role="src" name="php_maxminddb.h"/>
+
+                <dir name="tests">
+                    <file role="test" name="001-load.phpt"/>
+                    <file role="test" name="002-final.phpt"/>
+                    <file role="test" name="003-open-basedir.phpt"/>
+                </dir>
+            </dir>
+        </dir>
+    </contents>
+    <dependencies>
+        <required>
+            <php>
+                <min>7.2.0</min>
+            </php>
+            <pearinstaller>
+                <min>1.10.0</min>
+            </pearinstaller>
+        </required>
+    </dependencies>
+    <providesextension>maxminddb</providesextension>
+    <extsrcrelease />
+</package>
diff --git a/db-reader/phpstan.neon b/db-reader/phpstan.neon
new file mode 100644
index 0000000..ee1616d
--- /dev/null
+++ b/db-reader/phpstan.neon
@@ -0,0 +1,7 @@
+parameters:
+    level: 6
+    paths:
+        - src
+        - tests
+    checkMissingIterableValueType: false
+
diff --git a/db-reader/src/MaxMind/Db/Reader.php b/db-reader/src/MaxMind/Db/Reader.php
new file mode 100644
index 0000000..4dfaef4
--- /dev/null
+++ b/db-reader/src/MaxMind/Db/Reader.php
@@ -0,0 +1,373 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MaxMind\Db;
+
+use ArgumentCountError;
+use BadMethodCallException;
+use Exception;
+use InvalidArgumentException;
+use MaxMind\Db\Reader\Decoder;
+use MaxMind\Db\Reader\InvalidDatabaseException;
+use MaxMind\Db\Reader\Metadata;
+use MaxMind\Db\Reader\Util;
+use UnexpectedValueException;
+
+/**
+ * Instances of this class provide a reader for the MaxMind DB format. IP
+ * addresses can be looked up using the get method.
+ */
+class Reader
+{
+    /**
+     * @var int
+     */
+    private static $DATA_SECTION_SEPARATOR_SIZE = 16;
+    /**
+     * @var string
+     */
+    private static $METADATA_START_MARKER = "\xAB\xCD\xEFMaxMind.com";
+    /**
+     * @var int
+     */
+    private static $METADATA_START_MARKER_LENGTH = 14;
+    /**
+     * @var int
+     */
+    private static $METADATA_MAX_SIZE = 131072; // 128 * 1024 = 128KiB
+
+    /**
+     * @var Decoder
+     */
+    private $decoder;
+    /**
+     * @var resource
+     */
+    private $fileHandle;
+    /**
+     * @var int
+     */
+    private $fileSize;
+    /**
+     * @var int
+     */
+    private $ipV4Start;
+    /**
+     * @var Metadata
+     */
+    private $metadata;
+
+    /**
+     * Constructs a Reader for the MaxMind DB format. The file passed to it must
+     * be a valid MaxMind DB file such as a GeoIp2 database file.
+     *
+     * @param string $database
+     *                         the MaxMind DB file to use
+     *
+     * @throws InvalidArgumentException for invalid database path or unknown arguments
+     * @throws InvalidDatabaseException
+     *                                  if the database is invalid or there is an error reading
+     *                                  from it
+     */
+    public function __construct(string $database)
+    {
+        if (\func_num_args() !== 1) {
+            throw new ArgumentCountError(
+                sprintf('%s() expects exactly 1 parameter, %d given', __METHOD__, \func_num_args())
+            );
+        }
+
+        $fileHandle = @fopen($database, 'rb');
+        if ($fileHandle === false) {
+            throw new InvalidArgumentException(
+                "The file \"$database\" does not exist or is not readable."
+            );
+        }
+        $this->fileHandle = $fileHandle;
+
+        $fileSize = @filesize($database);
+        if ($fileSize === false) {
+            throw new UnexpectedValueException(
+                "Error determining the size of \"$database\"."
+            );
+        }
+        $this->fileSize = $fileSize;
+
+        $start = $this->findMetadataStart($database);
+        $metadataDecoder = new Decoder($this->fileHandle, $start);
+        [$metadataArray] = $metadataDecoder->decode($start);
+        $this->metadata = new Metadata($metadataArray);
+        $this->decoder = new Decoder(
+            $this->fileHandle,
+            $this->metadata->searchTreeSize + self::$DATA_SECTION_SEPARATOR_SIZE
+        );
+        $this->ipV4Start = $this->ipV4StartNode();
+    }
+
+    /**
+     * Retrieves the record for the IP address.
+     *
+     * @param string $ipAddress
+     *                          the IP address to look up
+     *
+     * @throws BadMethodCallException   if this method is called on a closed database
+     * @throws InvalidArgumentException if something other than a single IP address is passed to the method
+     * @throws InvalidDatabaseException
+     *                                  if the database is invalid or there is an error reading
+     *                                  from it
+     *
+     * @return mixed the record for the IP address
+     */
+    public function get(string $ipAddress)
+    {
+        if (\func_num_args() !== 1) {
+            throw new ArgumentCountError(
+                sprintf('%s() expects exactly 1 parameter, %d given', __METHOD__, \func_num_args())
+            );
+        }
+        [$record] = $this->getWithPrefixLen($ipAddress);
+
+        return $record;
+    }
+
+    /**
+     * Retrieves the record for the IP address and its associated network prefix length.
+     *
+     * @param string $ipAddress
+     *                          the IP address to look up
+     *
+     * @throws BadMethodCallException   if this method is called on a closed database
+     * @throws InvalidArgumentException if something other than a single IP address is passed to the method
+     * @throws InvalidDatabaseException
+     *                                  if the database is invalid or there is an error reading
+     *                                  from it
+     *
+     * @return array an array where the first element is the record and the
+     *               second the network prefix length for the record
+     */
+    public function getWithPrefixLen(string $ipAddress): array
+    {
+        if (\func_num_args() !== 1) {
+            throw new ArgumentCountError(
+                sprintf('%s() expects exactly 1 parameter, %d given', __METHOD__, \func_num_args())
+            );
+        }
+
+        if (!\is_resource($this->fileHandle)) {
+            throw new BadMethodCallException(
+                'Attempt to read from a closed MaxMind DB.'
+            );
+        }
+
+        [$pointer, $prefixLen] = $this->findAddressInTree($ipAddress);
+        if ($pointer === 0) {
+            return [null, $prefixLen];
+        }
+
+        return [$this->resolveDataPointer($pointer), $prefixLen];
+    }
+
+    private function findAddressInTree(string $ipAddress): array
+    {
+        $packedAddr = @inet_pton($ipAddress);
+        if ($packedAddr === false) {
+            throw new InvalidArgumentException(
+                "The value \"$ipAddress\" is not a valid IP address."
+            );
+        }
+
+        $rawAddress = unpack('C*', $packedAddr);
+
+        $bitCount = \count($rawAddress) * 8;
+
+        // The first node of the tree is always node 0, at the beginning of the
+        // value
+        $node = 0;
+
+        $metadata = $this->metadata;
+
+        // Check if we are looking up an IPv4 address in an IPv6 tree. If this
+        // is the case, we can skip over the first 96 nodes.
+        if ($metadata->ipVersion === 6) {
+            if ($bitCount === 32) {
+                $node = $this->ipV4Start;
+            }
+        } elseif ($metadata->ipVersion === 4 && $bitCount === 128) {
+            throw new InvalidArgumentException(
+                "Error looking up $ipAddress. You attempted to look up an"
+                . ' IPv6 address in an IPv4-only database.'
+            );
+        }
+
+        $nodeCount = $metadata->nodeCount;
+
+        for ($i = 0; $i < $bitCount && $node < $nodeCount; ++$i) {
+            $tempBit = 0xFF & $rawAddress[($i >> 3) + 1];
+            $bit = 1 & ($tempBit >> 7 - ($i % 8));
+
+            $node = $this->readNode($node, $bit);
+        }
+        if ($node === $nodeCount) {
+            // Record is empty
+            return [0, $i];
+        }
+        if ($node > $nodeCount) {
+            // Record is a data pointer
+            return [$node, $i];
+        }
+
+        throw new InvalidDatabaseException(
+            'Invalid or corrupt database. Maximum search depth reached without finding a leaf node'
+        );
+    }
+
+    private function ipV4StartNode(): int
+    {
+        // If we have an IPv4 database, the start node is the first node
+        if ($this->metadata->ipVersion === 4) {
+            return 0;
+        }
+
+        $node = 0;
+
+        for ($i = 0; $i < 96 && $node < $this->metadata->nodeCount; ++$i) {
+            $node = $this->readNode($node, 0);
+        }
+
+        return $node;
+    }
+
+    private function readNode(int $nodeNumber, int $index): int
+    {
+        $baseOffset = $nodeNumber * $this->metadata->nodeByteSize;
+
+        switch ($this->metadata->recordSize) {
+            case 24:
+                $bytes = Util::read($this->fileHandle, $baseOffset + $index * 3, 3);
+                [, $node] = unpack('N', "\x00" . $bytes);
+
+                return $node;
+
+            case 28:
+                $bytes = Util::read($this->fileHandle, $baseOffset + 3 * $index, 4);
+                if ($index === 0) {
+                    $middle = (0xF0 & \ord($bytes[3])) >> 4;
+                } else {
+                    $middle = 0x0F & \ord($bytes[0]);
+                }
+                [, $node] = unpack('N', \chr($middle) . substr($bytes, $index, 3));
+
+                return $node;
+
+            case 32:
+                $bytes = Util::read($this->fileHandle, $baseOffset + $index * 4, 4);
+                [, $node] = unpack('N', $bytes);
+
+                return $node;
+
+            default:
+                throw new InvalidDatabaseException(
+                    'Unknown record size: '
+                    . $this->metadata->recordSize
+                );
+        }
+    }
+
+    /**
+     * @return mixed
+     */
+    private function resolveDataPointer(int $pointer)
+    {
+        $resolved = $pointer - $this->metadata->nodeCount
+            + $this->metadata->searchTreeSize;
+        if ($resolved >= $this->fileSize) {
+            throw new InvalidDatabaseException(
+                "The MaxMind DB file's search tree is corrupt"
+            );
+        }
+
+        [$data] = $this->decoder->decode($resolved);
+
+        return $data;
+    }
+
+    /*
+     * This is an extremely naive but reasonably readable implementation. There
+     * are much faster algorithms (e.g., Boyer-Moore) for this if speed is ever
+     * an issue, but I suspect it won't be.
+     */
+    private function findMetadataStart(string $filename): int
+    {
+        $handle = $this->fileHandle;
+        $fstat = fstat($handle);
+        $fileSize = $fstat['size'];
+        $marker = self::$METADATA_START_MARKER;
+        $markerLength = self::$METADATA_START_MARKER_LENGTH;
+
+        $minStart = $fileSize - min(self::$METADATA_MAX_SIZE, $fileSize);
+
+        for ($offset = $fileSize - $markerLength; $offset >= $minStart; --$offset) {
+            if (fseek($handle, $offset) !== 0) {
+                break;
+            }
+
+            $value = fread($handle, $markerLength);
+            if ($value === $marker) {
+                return $offset + $markerLength;
+            }
+        }
+
+        throw new InvalidDatabaseException(
+            "Error opening database file ($filename). " .
+            'Is this a valid MaxMind DB file?'
+        );
+    }
+
+    /**
+     * @throws InvalidArgumentException if arguments are passed to the method
+     * @throws BadMethodCallException   if the database has been closed
+     *
+     * @return Metadata object for the database
+     */
+    public function metadata(): Metadata
+    {
+        if (\func_num_args()) {
+            throw new ArgumentCountError(
+                sprintf('%s() expects exactly 0 parameters, %d given', __METHOD__, \func_num_args())
+            );
+        }
+
+        // Not technically required, but this makes it consistent with
+        // C extension and it allows us to change our implementation later.
+        if (!\is_resource($this->fileHandle)) {
+            throw new BadMethodCallException(
+                'Attempt to read from a closed MaxMind DB.'
+            );
+        }
+
+        return clone $this->metadata;
+    }
+
+    /**
+     * Closes the MaxMind DB and returns resources to the system.
+     *
+     * @throws Exception
+     *                   if an I/O error occurs
+     */
+    public function close(): void
+    {
+        if (\func_num_args()) {
+            throw new ArgumentCountError(
+                sprintf('%s() expects exactly 0 parameters, %d given', __METHOD__, \func_num_args())
+            );
+        }
+
+        if (!\is_resource($this->fileHandle)) {
+            throw new BadMethodCallException(
+                'Attempt to close a closed MaxMind DB.'
+            );
+        }
+        fclose($this->fileHandle);
+    }
+}
diff --git a/db-reader/src/MaxMind/Db/Reader/Decoder.php b/db-reader/src/MaxMind/Db/Reader/Decoder.php
new file mode 100644
index 0000000..4b00456
--- /dev/null
+++ b/db-reader/src/MaxMind/Db/Reader/Decoder.php
@@ -0,0 +1,381 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MaxMind\Db\Reader;
+
+// @codingStandardsIgnoreLine
+use RuntimeException;
+
+/*
+ * @ignore
+ *
+ * We subtract 1 from the log to protect against precision loss.
+ */
+\define(__NAMESPACE__ . '\_MM_MAX_INT_BYTES', (int) ((log(\PHP_INT_MAX, 2) - 1) / 8));
+
+class Decoder
+{
+    /**
+     * @var resource
+     */
+    private $fileStream;
+    /**
+     * @var int
+     */
+    private $pointerBase;
+    /**
+     * @var float
+     */
+    private $pointerBaseByteSize;
+    /**
+     * This is only used for unit testing.
+     *
+     * @var bool
+     */
+    private $pointerTestHack;
+    /**
+     * @var bool
+     */
+    private $switchByteOrder;
+
+    private const _EXTENDED = 0;
+    private const _POINTER = 1;
+    private const _UTF8_STRING = 2;
+    private const _DOUBLE = 3;
+    private const _BYTES = 4;
+    private const _UINT16 = 5;
+    private const _UINT32 = 6;
+    private const _MAP = 7;
+    private const _INT32 = 8;
+    private const _UINT64 = 9;
+    private const _UINT128 = 10;
+    private const _ARRAY = 11;
+    private const _CONTAINER = 12;
+    private const _END_MARKER = 13;
+    private const _BOOLEAN = 14;
+    private const _FLOAT = 15;
+
+    /**
+     * @param resource $fileStream
+     */
+    public function __construct(
+        $fileStream,
+        int $pointerBase = 0,
+        bool $pointerTestHack = false
+    ) {
+        $this->fileStream = $fileStream;
+        $this->pointerBase = $pointerBase;
+
+        $this->pointerBaseByteSize = $pointerBase > 0 ? log($pointerBase, 2) / 8 : 0;
+        $this->pointerTestHack = $pointerTestHack;
+
+        $this->switchByteOrder = $this->isPlatformLittleEndian();
+    }
+
+    public function decode(int $offset): array
+    {
+        $ctrlByte = \ord(Util::read($this->fileStream, $offset, 1));
+        ++$offset;
+
+        $type = $ctrlByte >> 5;
+
+        // Pointers are a special case, we don't read the next $size bytes, we
+        // use the size to determine the length of the pointer and then follow
+        // it.
+        if ($type === self::_POINTER) {
+            [$pointer, $offset] = $this->decodePointer($ctrlByte, $offset);
+
+            // for unit testing
+            if ($this->pointerTestHack) {
+                return [$pointer];
+            }
+
+            [$result] = $this->decode($pointer);
+
+            return [$result, $offset];
+        }
+
+        if ($type === self::_EXTENDED) {
+            $nextByte = \ord(Util::read($this->fileStream, $offset, 1));
+
+            $type = $nextByte + 7;
+
+            if ($type < 8) {
+                throw new InvalidDatabaseException(
+                    'Something went horribly wrong in the decoder. An extended type '
+                    . 'resolved to a type number < 8 ('
+                    . $type
+                    . ')'
+                );
+            }
+
+            ++$offset;
+        }
+
+        [$size, $offset] = $this->sizeFromCtrlByte($ctrlByte, $offset);
+
+        return $this->decodeByType($type, $offset, $size);
+    }
+
+    private function decodeByType(int $type, int $offset, int $size): array
+    {
+        switch ($type) {
+            case self::_MAP:
+                return $this->decodeMap($size, $offset);
+
+            case self::_ARRAY:
+                return $this->decodeArray($size, $offset);
+
+            case self::_BOOLEAN:
+                return [$this->decodeBoolean($size), $offset];
+        }
+
+        $newOffset = $offset + $size;
+        $bytes = Util::read($this->fileStream, $offset, $size);
+
+        switch ($type) {
+            case self::_BYTES:
+            case self::_UTF8_STRING:
+                return [$bytes, $newOffset];
+
+            case self::_DOUBLE:
+                $this->verifySize(8, $size);
+
+                return [$this->decodeDouble($bytes), $newOffset];
+
+            case self::_FLOAT:
+                $this->verifySize(4, $size);
+
+                return [$this->decodeFloat($bytes), $newOffset];
+
+            case self::_INT32:
+                return [$this->decodeInt32($bytes, $size), $newOffset];
+
+            case self::_UINT16:
+            case self::_UINT32:
+            case self::_UINT64:
+            case self::_UINT128:
+                return [$this->decodeUint($bytes, $size), $newOffset];
+
+            default:
+                throw new InvalidDatabaseException(
+                    'Unknown or unexpected type: ' . $type
+                );
+        }
+    }
+
+    private function verifySize(int $expected, int $actual): void
+    {
+        if ($expected !== $actual) {
+            throw new InvalidDatabaseException(
+                "The MaxMind DB file's data section contains bad data (unknown data type or corrupt data)"
+            );
+        }
+    }
+
+    private function decodeArray(int $size, int $offset): array
+    {
+        $array = [];
+
+        for ($i = 0; $i < $size; ++$i) {
+            [$value, $offset] = $this->decode($offset);
+            $array[] = $value;
+        }
+
+        return [$array, $offset];
+    }
+
+    private function decodeBoolean(int $size): bool
+    {
+        return $size !== 0;
+    }
+
+    private function decodeDouble(string $bytes): float
+    {
+        // This assumes IEEE 754 doubles, but most (all?) modern platforms
+        // use them.
+        [, $double] = unpack('E', $bytes);
+
+        return $double;
+    }
+
+    private function decodeFloat(string $bytes): float
+    {
+        // This assumes IEEE 754 floats, but most (all?) modern platforms
+        // use them.
+        [, $float] = unpack('G', $bytes);
+
+        return $float;
+    }
+
+    private function decodeInt32(string $bytes, int $size): int
+    {
+        switch ($size) {
+            case 0:
+                return 0;
+
+            case 1:
+            case 2:
+            case 3:
+                $bytes = str_pad($bytes, 4, "\x00", \STR_PAD_LEFT);
+
+                break;
+
+            case 4:
+                break;
+
+            default:
+                throw new InvalidDatabaseException(
+                    "The MaxMind DB file's data section contains bad data (unknown data type or corrupt data)"
+                );
+        }
+
+        [, $int] = unpack('l', $this->maybeSwitchByteOrder($bytes));
+
+        return $int;
+    }
+
+    private function decodeMap(int $size, int $offset): array
+    {
+        $map = [];
+
+        for ($i = 0; $i < $size; ++$i) {
+            [$key, $offset] = $this->decode($offset);
+            [$value, $offset] = $this->decode($offset);
+            $map[$key] = $value;
+        }
+
+        return [$map, $offset];
+    }
+
+    private function decodePointer(int $ctrlByte, int $offset): array
+    {
+        $pointerSize = (($ctrlByte >> 3) & 0x3) + 1;
+
+        $buffer = Util::read($this->fileStream, $offset, $pointerSize);
+        $offset = $offset + $pointerSize;
+
+        switch ($pointerSize) {
+            case 1:
+                $packed = \chr($ctrlByte & 0x7) . $buffer;
+                [, $pointer] = unpack('n', $packed);
+                $pointer += $this->pointerBase;
+
+                break;
+
+            case 2:
+                $packed = "\x00" . \chr($ctrlByte & 0x7) . $buffer;
+                [, $pointer] = unpack('N', $packed);
+                $pointer += $this->pointerBase + 2048;
+
+                break;
+
+            case 3:
+                $packed = \chr($ctrlByte & 0x7) . $buffer;
+
+                // It is safe to use 'N' here, even on 32 bit machines as the
+                // first bit is 0.
+                [, $pointer] = unpack('N', $packed);
+                $pointer += $this->pointerBase + 526336;
+
+                break;
+
+            case 4:
+                // We cannot use unpack here as we might overflow on 32 bit
+                // machines
+                $pointerOffset = $this->decodeUint($buffer, $pointerSize);
+
+                $pointerBase = $this->pointerBase;
+
+                if (\PHP_INT_MAX - $pointerBase >= $pointerOffset) {
+                    $pointer = $pointerOffset + $pointerBase;
+                } else {
+                    throw new RuntimeException(
+                        'The database offset is too large to be represented on your platform.'
+                    );
+                }
+
+                break;
+
+            default:
+                throw new InvalidDatabaseException(
+                    'Unexpected pointer size ' . $pointerSize
+                );
+        }
+
+        return [$pointer, $offset];
+    }
+
+    // @phpstan-ignore-next-line
+    private function decodeUint(string $bytes, int $byteLength)
+    {
+        if ($byteLength === 0) {
+            return 0;
+        }
+
+        $integer = 0;
+
+        // PHP integers are signed. _MM_MAX_INT_BYTES is the number of
+        // complete bytes that can be converted to an integer. However,
+        // we can convert another byte if the leading bit is zero.
+        $useRealInts = $byteLength <= _MM_MAX_INT_BYTES
+            || ($byteLength === _MM_MAX_INT_BYTES + 1 && (\ord($bytes[0]) & 0x80) === 0);
+
+        for ($i = 0; $i < $byteLength; ++$i) {
+            $part = \ord($bytes[$i]);
+
+            // We only use gmp or bcmath if the final value is too big
+            if ($useRealInts) {
+                $integer = ($integer << 8) + $part;
+            } elseif (\extension_loaded('gmp')) {
+                $integer = gmp_strval(gmp_add(gmp_mul((string) $integer, '256'), $part));
+            } elseif (\extension_loaded('bcmath')) {
+                $integer = bcadd(bcmul((string) $integer, '256'), (string) $part);
+            } else {
+                throw new RuntimeException(
+                    'The gmp or bcmath extension must be installed to read this database.'
+                );
+            }
+        }
+
+        return $integer;
+    }
+
+    private function sizeFromCtrlByte(int $ctrlByte, int $offset): array
+    {
+        $size = $ctrlByte & 0x1f;
+
+        if ($size < 29) {
+            return [$size, $offset];
+        }
+
+        $bytesToRead = $size - 28;
+        $bytes = Util::read($this->fileStream, $offset, $bytesToRead);
+
+        if ($size === 29) {
+            $size = 29 + \ord($bytes);
+        } elseif ($size === 30) {
+            [, $adjust] = unpack('n', $bytes);
+            $size = 285 + $adjust;
+        } else {
+            [, $adjust] = unpack('N', "\x00" . $bytes);
+            $size = $adjust + 65821;
+        }
+
+        return [$size, $offset + $bytesToRead];
+    }
+
+    private function maybeSwitchByteOrder(string $bytes): string
+    {
+        return $this->switchByteOrder ? strrev($bytes) : $bytes;
+    }
+
+    private function isPlatformLittleEndian(): bool
+    {
+        $testint = 0x00FF;
+        $packed = pack('S', $testint);
+
+        return $testint === current(unpack('v', $packed));
+    }
+}
diff --git a/db-reader/src/MaxMind/Db/Reader/InvalidDatabaseException.php b/db-reader/src/MaxMind/Db/Reader/InvalidDatabaseException.php
new file mode 100644
index 0000000..5323107
--- /dev/null
+++ b/db-reader/src/MaxMind/Db/Reader/InvalidDatabaseException.php
@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MaxMind\Db\Reader;
+
+use Exception;
+
+/**
+ * This class should be thrown when unexpected data is found in the database.
+ */
+class InvalidDatabaseException extends Exception
+{
+}
diff --git a/db-reader/src/MaxMind/Db/Reader/Metadata.php b/db-reader/src/MaxMind/Db/Reader/Metadata.php
new file mode 100644
index 0000000..873064b
--- /dev/null
+++ b/db-reader/src/MaxMind/Db/Reader/Metadata.php
@@ -0,0 +1,112 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MaxMind\Db\Reader;
+
+use ArgumentCountError;
+
+/**
+ * This class provides the metadata for the MaxMind DB file.
+ */
+class Metadata
+{
+    /**
+     * This is an unsigned 16-bit integer indicating the major version number
+     * for the database's binary format.
+     *
+     * @var int
+     */
+    public $binaryFormatMajorVersion;
+    /**
+     * This is an unsigned 16-bit integer indicating the minor version number
+     * for the database's binary format.
+     *
+     * @var int
+     */
+    public $binaryFormatMinorVersion;
+    /**
+     * This is an unsigned 64-bit integer that contains the database build
+     * timestamp as a Unix epoch value.
+     *
+     * @var int
+     */
+    public $buildEpoch;
+    /**
+     * This is a string that indicates the structure of each data record
+     * associated with an IP address.  The actual definition of these
+     * structures is left up to the database creator.
+     *
+     * @var string
+     */
+    public $databaseType;
+    /**
+     * This key will always point to a map (associative array). The keys of
+     * that map will be language codes, and the values will be a description
+     * in that language as a UTF-8 string. May be undefined for some
+     * databases.
+     *
+     * @var array
+     */
+    public $description;
+    /**
+     * This is an unsigned 16-bit integer which is always 4 or 6. It indicates
+     * whether the database contains IPv4 or IPv6 address data.
+     *
+     * @var int
+     */
+    public $ipVersion;
+    /**
+     * An array of strings, each of which is a language code. A given record
+     * may contain data items that have been localized to some or all of
+     * these languages. This may be undefined.
+     *
+     * @var array
+     */
+    public $languages;
+    /**
+     * @var int
+     */
+    public $nodeByteSize;
+    /**
+     * This is an unsigned 32-bit integer indicating the number of nodes in
+     * the search tree.
+     *
+     * @var int
+     */
+    public $nodeCount;
+    /**
+     * This is an unsigned 16-bit integer. It indicates the number of bits in a
+     * record in the search tree. Note that each node consists of two records.
+     *
+     * @var int
+     */
+    public $recordSize;
+    /**
+     * @var int
+     */
+    public $searchTreeSize;
+
+    public function __construct(array $metadata)
+    {
+        if (\func_num_args() !== 1) {
+            throw new ArgumentCountError(
+                sprintf('%s() expects exactly 1 parameter, %d given', __METHOD__, \func_num_args())
+            );
+        }
+
+        $this->binaryFormatMajorVersion =
+            $metadata['binary_format_major_version'];
+        $this->binaryFormatMinorVersion =
+            $metadata['binary_format_minor_version'];
+        $this->buildEpoch = $metadata['build_epoch'];
+        $this->databaseType = $metadata['database_type'];
+        $this->languages = $metadata['languages'];
+        $this->description = $metadata['description'];
+        $this->ipVersion = $metadata['ip_version'];
+        $this->nodeCount = $metadata['node_count'];
+        $this->recordSize = $metadata['record_size'];
+        $this->nodeByteSize = $this->recordSize / 4;
+        $this->searchTreeSize = $this->nodeCount * $this->nodeByteSize;
+    }
+}
diff --git a/db-reader/src/MaxMind/Db/Reader/Util.php b/db-reader/src/MaxMind/Db/Reader/Util.php
new file mode 100644
index 0000000..89db715
--- /dev/null
+++ b/db-reader/src/MaxMind/Db/Reader/Util.php
@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MaxMind\Db\Reader;
+
+class Util
+{
+    /**
+     * @param resource $stream
+     */
+    public static function read($stream, int $offset, int $numberOfBytes): string
+    {
+        if ($numberOfBytes === 0) {
+            return '';
+        }
+        if (fseek($stream, $offset) === 0) {
+            $value = fread($stream, $numberOfBytes);
+
+            // We check that the number of bytes read is equal to the number
+            // asked for. We use ftell as getting the length of $value is
+            // much slower.
+            if ($value !== false && ftell($stream) - $offset === $numberOfBytes) {
+                return $value;
+            }
+        }
+
+        throw new InvalidDatabaseException(
+            'The MaxMind DB file contains bad data'
+        );
+    }
+}
diff --git a/emoji.html b/emoji.html
new file mode 100644
index 0000000..3b1cd61
--- /dev/null
+++ b/emoji.html
@@ -0,0 +1,1637 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="UTF-8">
+  </head>
+  <body>
+    <h1>Unicode emoji list v13.1 without gender and skin tone variations</h1>
+    <main>
+😀 grinning face<br>
+😃 grinning face with big eyes<br>
+😄 grinning face with smiling eyes<br>
+😁 beaming face with smiling eyes<br>
+😆 grinning squinting face<br>
+😅 grinning face with sweat<br>
+🤣 rolling on the floor laughing<br>
+😂 face with tears of joy<br>
+🙂 slightly smiling face<br>
+🙃 upside-down face<br>
+😉 winking face<br>
+😊 smiling face with smiling eyes<br>
+😇 smiling face with halo<br>
+🥰 smiling face with hearts<br>
+😍 smiling face with heart-eyes<br>
+🤩 star-struck<br>
+😘 face blowing a kiss<br>
+😗 kissing face<br>
+☺ smiling face<br>
+😚 kissing face with closed eyes<br>
+😙 kissing face with smiling eyes<br>
+🥲 smiling face with tear<br>
+😋 face savoring food<br>
+😛 face with tongue<br>
+😜 winking face with tongue<br>
+🤪 zany face<br>
+😝 squinting face with tongue<br>
+🤑 money-mouth face<br>
+🤗 hugging face<br>
+🤭 face with hand over mouth<br>
+🤫 shushing face<br>
+🤔 thinking face<br>
+🤐 zipper-mouth face<br>
+🤨 face with raised eyebrow<br>
+😐 neutral face<br>
+😑 expressionless face<br>
+😶 face without mouth<br>
+😶‍🌫️ face in clouds<br>
+😏 smirking face<br>
+😒 unamused face<br>
+🙄 face with rolling eyes<br>
+😬 grimacing face<br>
+😮‍💨 face exhaling<br>
+🤥 lying face<br>
+😌 relieved face<br>
+😔 pensive face<br>
+😪 sleepy face<br>
+🤤 drooling face<br>
+😴 sleeping face<br>
+😷 face with medical mask<br>
+🤒 face with thermometer<br>
+🤕 face with head-bandage<br>
+🤢 nauseated face<br>
+🤮 face vomiting<br>
+🤧 sneezing face<br>
+🥵 hot face<br>
+🥶 cold face<br>
+🥴 woozy face<br>
+😵 knocked-out face<br>
+😵‍💫 face with spiral eyes<br>
+🤯 exploding head<br>
+🤠 cowboy hat face<br>
+🥳 partying face<br>
+🥸 disguised face<br>
+😎 smiling face with sunglasses<br>
+🤓 nerd face<br>
+🧐 face with monocle<br>
+😕 confused face<br>
+😟 worried face<br>
+🙁 slightly frowning face<br>
+☹ frowning face<br>
+😮 face with open mouth<br>
+😯 hushed face<br>
+😲 astonished face<br>
+😳 flushed face<br>
+🥺 pleading face<br>
+😦 frowning face with open mouth<br>
+😧 anguished face<br>
+😨 fearful face<br>
+😰 anxious face with sweat<br>
+😥 sad but relieved face<br>
+😢 crying face<br>
+😭 loudly crying face<br>
+😱 face screaming in fear<br>
+😖 confounded face<br>
+😣 persevering face<br>
+😞 disappointed face<br>
+😓 downcast face with sweat<br>
+😩 weary face<br>
+😫 tired face<br>
+🥱 yawning face<br>
+😤 face with steam from nose<br>
+😡 pouting face<br>
+😠 angry face<br>
+🤬 face with symbols on mouth<br>
+😈 smiling face with horns<br>
+👿 angry face with horns<br>
+💀 skull<br>
+☠ skull and crossbones<br>
+💩 pile of poo<br>
+🤡 clown face<br>
+👹 ogre<br>
+👺 goblin<br>
+👻 ghost<br>
+👽 alien<br>
+👾 alien monster<br>
+🤖 robot<br>
+😺 grinning cat<br>
+😸 grinning cat with smiling eyes<br>
+😹 cat with tears of joy<br>
+😻 smiling cat with heart-eyes<br>
+😼 cat with wry smile<br>
+😽 kissing cat<br>
+🙀 weary cat<br>
+😿 crying cat<br>
+😾 pouting cat<br>
+🙈 see-no-evil monkey<br>
+🙉 hear-no-evil monkey<br>
+🙊 speak-no-evil monkey<br>
+💋 kiss mark<br>
+💌 love letter<br>
+💘 heart with arrow<br>
+💝 heart with ribbon<br>
+💖 sparkling heart<br>
+💗 growing heart<br>
+💓 beating heart<br>
+💞 revolving hearts<br>
+💕 two hearts<br>
+💟 heart decoration<br>
+❣ heart exclamation<br>
+💔 broken heart<br>
+❤️‍🔥 heart on fire<br>
+❤️‍🩹 mending heart<br>
+❤ red heart<br>
+🧡 orange heart<br>
+💛 yellow heart<br>
+💚 green heart<br>
+💙 blue heart<br>
+💜 purple heart<br>
+🤎 brown heart<br>
+🖤 black heart<br>
+🤍 white heart<br>
+💯 hundred points<br>
+💢 anger symbol<br>
+💥 collision<br>
+💫 dizzy<br>
+💦 sweat droplets<br>
+💨 dashing away<br>
+🕳 hole<br>
+💣 bomb<br>
+💬 speech balloon<br>
+👁️‍🗨️ eye in speech bubble<br>
+🗨 left speech bubble<br>
+🗯 right anger bubble<br>
+💭 thought balloon<br>
+💤 zzz<br>
+👋 waving hand<br>
+🤚 raised back of hand<br>
+🖐 hand with fingers splayed<br>
+✋ raised hand<br>
+🖖 vulcan salute<br>
+👌 OK hand<br>
+🤌 pinched fingers<br>
+🤏 pinching hand<br>
+✌ victory hand<br>
+🤞 crossed fingers<br>
+🤟 love-you gesture<br>
+🤘 sign of the horns<br>
+🤙 call me hand<br>
+👈 backhand index pointing left<br>
+👉 backhand index pointing right<br>
+👆 backhand index pointing up<br>
+🖕 middle finger<br>
+👇 backhand index pointing down<br>
+☝ index pointing up<br>
+👍 thumbs up<br>
+👎 thumbs down<br>
+✊ raised fist<br>
+👊 oncoming fist<br>
+🤛 left-facing fist<br>
+🤜 right-facing fist<br>
+👏 clapping hands<br>
+🙌 raising hands<br>
+👐 open hands<br>
+🤲 palms up together<br>
+🤝 handshake<br>
+🙏 folded hands<br>
+✍ writing hand<br>
+💅 nail polish<br>
+🤳 selfie<br>
+💪 flexed biceps<br>
+🦾 mechanical arm<br>
+🦿 mechanical leg<br>
+🦵 leg<br>
+🦶 foot<br>
+👂 ear<br>
+🦻 ear with hearing aid<br>
+👃 nose<br>
+🧠 brain<br>
+🫀 anatomical heart<br>
+🫁 lungs<br>
+🦷 tooth<br>
+🦴 bone<br>
+👀 eyes<br>
+👁 eye<br>
+👅 tongue<br>
+👄 mouth<br>
+👶 baby<br>
+🧒 child<br>
+🧑 person<br>
+👱 person: blond hair<br>
+🧔 person: beard<br>
+🧑‍🦰 person: red hair<br>
+🧑‍🦱 person: curly hair<br>
+🧑‍🦳 person: white hair<br>
+🧑‍🦲 person: bald<br>
+🧓 older person<br>
+🙍 person frowning<br>
+🙎 person pouting<br>
+🙅 person gesturing NO<br>
+🙆 person gesturing OK<br>
+💁 person tipping hand<br>
+🙋 person raising hand<br>
+🧏 deaf person<br>
+🙇 person bowing<br>
+🤦 person facepalming<br>
+🤷 person shrugging<br>
+🧑‍⚕️ health worker<br>
+🧑‍🎓 student<br>
+🧑‍🏫 teacher<br>
+🧑‍⚖️ judge<br>
+🧑‍🌾 farmer<br>
+🧑‍🍳 cook<br>
+🧑‍🔧 mechanic<br>
+🧑‍🏭 factory worker<br>
+🧑‍💼 office worker<br>
+🧑‍🔬 scientist<br>
+🧑‍💻 technologist<br>
+🧑‍🎤 singer<br>
+🧑‍🎨 artist<br>
+🧑‍✈️ pilot<br>
+🧑‍🚀 astronaut<br>
+🧑‍🚒 firefighter<br>
+👮 police officer<br>
+🕵 detective<br>
+💂 guard<br>
+🥷 ninja<br>
+👷 construction worker<br>
+🤴 prince<br>
+👸 princess<br>
+👳 person wearing turban<br>
+👲 person with skullcap<br>
+🧕 woman with headscarf<br>
+🤵 person in tuxedo<br>
+👰 person with veil<br>
+🤰 pregnant woman<br>
+🤱 breast-feeding<br>
+🧑‍🍼 person feeding baby<br>
+👼 baby angel<br>
+🎅 Santa Claus<br>
+🤶 Mrs. Claus<br>
+🧑‍🎄 mx claus<br>
+🦸 superhero<br>
+🦹 supervillain<br>
+🧙 mage<br>
+🧚 fairy<br>
+🧛 vampire<br>
+🧜 merperson<br>
+🧝 elf<br>
+🧞 genie<br>
+🧟 zombie<br>
+💆 person getting massage<br>
+💇 person getting haircut<br>
+🚶 person walking<br>
+🧍 person standing<br>
+🧎 person kneeling<br>
+🧑‍🦯 person with white cane<br>
+🧑‍🦼 person in motorized wheelchair<br>
+🧑‍🦽 person in manual wheelchair<br>
+🏃 person running<br>
+💃 woman dancing<br>
+🕺 man dancing<br>
+🕴 person in suit levitating<br>
+👯 people with bunny ears<br>
+🧖 person in steamy room<br>
+🧗 person climbing<br>
+🤺 person fencing<br>
+🏇 horse racing<br>
+⛷ skier<br>
+🏂 snowboarder<br>
+🏌 person golfing<br>
+🏄 person surfing<br>
+🚣 person rowing boat<br>
+🏊 person swimming<br>
+⛹ person bouncing ball<br>
+🏋 person lifting weights<br>
+🚴 person biking<br>
+🚵 person mountain biking<br>
+🤸 person cartwheeling<br>
+🤼 people wrestling<br>
+🤽 person playing water polo<br>
+🤾 person playing handball<br>
+🤹 person juggling<br>
+🧘 person in lotus position<br>
+🛀 person taking bath<br>
+🛌 person in bed<br>
+🧑‍🤝‍🧑 people holding hands<br>
+💏 kiss<br>
+💑 couple with heart<br>
+👪 family<br>
+🗣 speaking head<br>
+👤 bust in silhouette<br>
+👥 busts in silhouette<br>
+🫂 people hugging<br>
+👣 footprints<br>
+🦰 red hair<br>
+🦱 curly hair<br>
+🦳 white hair<br>
+🦲 bald<br>
+🐵 monkey face<br>
+🐒 monkey<br>
+🦍 gorilla<br>
+🦧 orangutan<br>
+🐶 dog face<br>
+🐕 dog<br>
+🦮 guide dog<br>
+🐕‍🦺 service dog<br>
+🐩 poodle<br>
+🐺 wolf<br>
+🦊 fox<br>
+🦝 raccoon<br>
+🐱 cat face<br>
+🐈 cat<br>
+🐈‍⬛ black cat<br>
+🦁 lion<br>
+🐯 tiger face<br>
+🐅 tiger<br>
+🐆 leopard<br>
+🐴 horse face<br>
+🐎 horse<br>
+🦄 unicorn<br>
+🦓 zebra<br>
+🦌 deer<br>
+🦬 bison<br>
+🐮 cow face<br>
+🐂 ox<br>
+🐃 water buffalo<br>
+🐄 cow<br>
+🐷 pig face<br>
+🐖 pig<br>
+🐗 boar<br>
+🐽 pig nose<br>
+🐏 ram<br>
+🐑 ewe<br>
+🐐 goat<br>
+🐪 camel<br>
+🐫 two-hump camel<br>
+🦙 llama<br>
+🦒 giraffe<br>
+🐘 elephant<br>
+🦣 mammoth<br>
+🦏 rhinoceros<br>
+🦛 hippopotamus<br>
+🐭 mouse face<br>
+🐁 mouse<br>
+🐀 rat<br>
+🐹 hamster<br>
+🐰 rabbit face<br>
+🐇 rabbit<br>
+🐿 chipmunk<br>
+🦫 beaver<br>
+🦔 hedgehog<br>
+🦇 bat<br>
+🐻 bear<br>
+🐻‍❄️ polar bear<br>
+🐨 koala<br>
+🐼 panda<br>
+🦥 sloth<br>
+🦦 otter<br>
+🦨 skunk<br>
+🦘 kangaroo<br>
+🦡 badger<br>
+🐾 paw prints<br>
+🦃 turkey<br>
+🐔 chicken<br>
+🐓 rooster<br>
+🐣 hatching chick<br>
+🐤 baby chick<br>
+🐥 front-facing baby chick<br>
+🐦 bird<br>
+🐧 penguin<br>
+🕊 dove<br>
+🦅 eagle<br>
+🦆 duck<br>
+🦢 swan<br>
+🦉 owl<br>
+🦤 dodo<br>
+🪶 feather<br>
+🦩 flamingo<br>
+🦚 peacock<br>
+🦜 parrot<br>
+🐸 frog<br>
+🐊 crocodile<br>
+🐢 turtle<br>
+🦎 lizard<br>
+🐍 snake<br>
+🐲 dragon face<br>
+🐉 dragon<br>
+🦕 sauropod<br>
+🦖 T-Rex<br>
+🐳 spouting whale<br>
+🐋 whale<br>
+🐬 dolphin<br>
+🦭 seal<br>
+🐟 fish<br>
+🐠 tropical fish<br>
+🐡 blowfish<br>
+🦈 shark<br>
+🐙 octopus<br>
+🐚 spiral shell<br>
+🐌 snail<br>
+🦋 butterfly<br>
+🐛 bug<br>
+🐜 ant<br>
+🐝 honeybee<br>
+🪲 beetle<br>
+🐞 lady beetle<br>
+🦗 cricket<br>
+🪳 cockroach<br>
+🕷 spider<br>
+🕸 spider web<br>
+🦂 scorpion<br>
+🦟 mosquito<br>
+🪰 fly<br>
+🪱 worm<br>
+🦠 microbe<br>
+💐 bouquet<br>
+🌸 cherry blossom<br>
+💮 white flower<br>
+🏵 rosette<br>
+🌹 rose<br>
+🥀 wilted flower<br>
+🌺 hibiscus<br>
+🌻 sunflower<br>
+🌼 blossom<br>
+🌷 tulip<br>
+🌱 seedling<br>
+🪴 potted plant<br>
+🌲 evergreen tree<br>
+🌳 deciduous tree<br>
+🌴 palm tree<br>
+🌵 cactus<br>
+🌾 sheaf of rice<br>
+🌿 herb<br>
+☘ shamrock<br>
+🍀 four leaf clover<br>
+🍁 maple leaf<br>
+🍂 fallen leaf<br>
+🍃 leaf fluttering in wind<br>
+🍇 grapes<br>
+🍈 melon<br>
+🍉 watermelon<br>
+🍊 tangerine<br>
+🍋 lemon<br>
+🍌 banana<br>
+🍍 pineapple<br>
+🥭 mango<br>
+🍎 red apple<br>
+🍏 green apple<br>
+🍐 pear<br>
+🍑 peach<br>
+🍒 cherries<br>
+🍓 strawberry<br>
+🫐 blueberries<br>
+🥝 kiwi fruit<br>
+🍅 tomato<br>
+🫒 olive<br>
+🥥 coconut<br>
+🥑 avocado<br>
+🍆 eggplant<br>
+🥔 potato<br>
+🥕 carrot<br>
+🌽 ear of corn<br>
+🌶 hot pepper<br>
+🫑 bell pepper<br>
+🥒 cucumber<br>
+🥬 leafy green<br>
+🥦 broccoli<br>
+🧄 garlic<br>
+🧅 onion<br>
+🍄 mushroom<br>
+🥜 peanuts<br>
+🌰 chestnut<br>
+🍞 bread<br>
+🥐 croissant<br>
+🥖 baguette bread<br>
+🫓 flatbread<br>
+🥨 pretzel<br>
+🥯 bagel<br>
+🥞 pancakes<br>
+🧇 waffle<br>
+🧀 cheese wedge<br>
+🍖 meat on bone<br>
+🍗 poultry leg<br>
+🥩 cut of meat<br>
+🥓 bacon<br>
+🍔 hamburger<br>
+🍟 french fries<br>
+🍕 pizza<br>
+🌭 hot dog<br>
+🥪 sandwich<br>
+🌮 taco<br>
+🌯 burrito<br>
+🫔 tamale<br>
+🥙 stuffed flatbread<br>
+🧆 falafel<br>
+🥚 egg<br>
+🍳 cooking<br>
+🥘 shallow pan of food<br>
+🍲 pot of food<br>
+🫕 fondue<br>
+🥣 bowl with spoon<br>
+🥗 green salad<br>
+🍿 popcorn<br>
+🧈 butter<br>
+🧂 salt<br>
+🥫 canned food<br>
+🍱 bento box<br>
+🍘 rice cracker<br>
+🍙 rice ball<br>
+🍚 cooked rice<br>
+🍛 curry rice<br>
+🍜 steaming bowl<br>
+🍝 spaghetti<br>
+🍠 roasted sweet potato<br>
+🍢 oden<br>
+🍣 sushi<br>
+🍤 fried shrimp<br>
+🍥 fish cake with swirl<br>
+🥮 moon cake<br>
+🍡 dango<br>
+🥟 dumpling<br>
+🥠 fortune cookie<br>
+🥡 takeout box<br>
+🦀 crab<br>
+🦞 lobster<br>
+🦐 shrimp<br>
+🦑 squid<br>
+🦪 oyster<br>
+🍦 soft ice cream<br>
+🍧 shaved ice<br>
+🍨 ice cream<br>
+🍩 doughnut<br>
+🍪 cookie<br>
+🎂 birthday cake<br>
+🍰 shortcake<br>
+🧁 cupcake<br>
+🥧 pie<br>
+🍫 chocolate bar<br>
+🍬 candy<br>
+🍭 lollipop<br>
+🍮 custard<br>
+🍯 honey pot<br>
+🍼 baby bottle<br>
+🥛 glass of milk<br>
+☕ hot beverage<br>
+🫖 teapot<br>
+🍵 teacup without handle<br>
+🍶 sake<br>
+🍾 bottle with popping cork<br>
+🍷 wine glass<br>
+🍸 cocktail glass<br>
+🍹 tropical drink<br>
+🍺 beer mug<br>
+🍻 clinking beer mugs<br>
+🥂 clinking glasses<br>
+🥃 tumbler glass<br>
+🥤 cup with straw<br>
+🧋 bubble tea<br>
+🧃 beverage box<br>
+🧉 mate<br>
+🧊 ice<br>
+🥢 chopsticks<br>
+🍽 fork and knife with plate<br>
+🍴 fork and knife<br>
+🥄 spoon<br>
+🔪 kitchen knife<br>
+🏺 amphora<br>
+🌍 globe showing Europe-Africa<br>
+🌎 globe showing Americas<br>
+🌏 globe showing Asia-Australia<br>
+🌐 globe with meridians<br>
+🗺 world map<br>
+🗾 map of Japan<br>
+🧭 compass<br>
+🏔 snow-capped mountain<br>
+⛰ mountain<br>
+🌋 volcano<br>
+🗻 mount fuji<br>
+🏕 camping<br>
+🏖 beach with umbrella<br>
+🏜 desert<br>
+🏝 desert island<br>
+🏞 national park<br>
+🏟 stadium<br>
+🏛 classical building<br>
+🏗 building construction<br>
+🧱 brick<br>
+🪨 rock<br>
+🪵 wood<br>
+🛖 hut<br>
+🏘 houses<br>
+🏚 derelict house<br>
+🏠 house<br>
+🏡 house with garden<br>
+🏢 office building<br>
+🏣 Japanese post office<br>
+🏤 post office<br>
+🏥 hospital<br>
+🏦 bank<br>
+🏨 hotel<br>
+🏩 love hotel<br>
+🏪 convenience store<br>
+🏫 school<br>
+🏬 department store<br>
+🏭 factory<br>
+🏯 Japanese castle<br>
+🏰 castle<br>
+💒 wedding<br>
+🗼 Tokyo tower<br>
+🗽 Statue of Liberty<br>
+⛪ church<br>
+🕌 mosque<br>
+🛕 hindu temple<br>
+🕍 synagogue<br>
+⛩ shinto shrine<br>
+🕋 kaaba<br>
+⛲ fountain<br>
+⛺ tent<br>
+🌁 foggy<br>
+🌃 night with stars<br>
+🏙 cityscape<br>
+🌄 sunrise over mountains<br>
+🌅 sunrise<br>
+🌆 cityscape at dusk<br>
+🌇 sunset<br>
+🌉 bridge at night<br>
+♨ hot springs<br>
+🎠 carousel horse<br>
+🎡 ferris wheel<br>
+🎢 roller coaster<br>
+💈 barber pole<br>
+🎪 circus tent<br>
+🚂 locomotive<br>
+🚃 railway car<br>
+🚄 high-speed train<br>
+🚅 bullet train<br>
+🚆 train<br>
+🚇 metro<br>
+🚈 light rail<br>
+🚉 station<br>
+🚊 tram<br>
+🚝 monorail<br>
+🚞 mountain railway<br>
+🚋 tram car<br>
+🚌 bus<br>
+🚍 oncoming bus<br>
+🚎 trolleybus<br>
+🚐 minibus<br>
+🚑 ambulance<br>
+🚒 fire engine<br>
+🚓 police car<br>
+🚔 oncoming police car<br>
+🚕 taxi<br>
+🚖 oncoming taxi<br>
+🚗 automobile<br>
+🚘 oncoming automobile<br>
+🚙 sport utility vehicle<br>
+🛻 pickup truck<br>
+🚚 delivery truck<br>
+🚛 articulated lorry<br>
+🚜 tractor<br>
+🏎 racing car<br>
+🏍 motorcycle<br>
+🛵 motor scooter<br>
+🦽 manual wheelchair<br>
+🦼 motorized wheelchair<br>
+🛺 auto rickshaw<br>
+🚲 bicycle<br>
+🛴 kick scooter<br>
+🛹 skateboard<br>
+🛼 roller skate<br>
+🚏 bus stop<br>
+🛣 motorway<br>
+🛤 railway track<br>
+🛢 oil drum<br>
+⛽ fuel pump<br>
+🚨 police car light<br>
+🚥 horizontal traffic light<br>
+🚦 vertical traffic light<br>
+🛑 stop sign<br>
+🚧 construction<br>
+⚓ anchor<br>
+⛵ sailboat<br>
+🛶 canoe<br>
+🚤 speedboat<br>
+🛳 passenger ship<br>
+⛴ ferry<br>
+🛥 motor boat<br>
+🚢 ship<br>
+✈ airplane<br>
+🛩 small airplane<br>
+🛫 airplane departure<br>
+🛬 airplane arrival<br>
+🪂 parachute<br>
+💺 seat<br>
+🚁 helicopter<br>
+🚟 suspension railway<br>
+🚠 mountain cableway<br>
+🚡 aerial tramway<br>
+🛰 satellite<br>
+🚀 rocket<br>
+🛸 flying saucer<br>
+🛎 bellhop bell<br>
+🧳 luggage<br>
+⌛ hourglass done<br>
+⏳ hourglass not done<br>
+⌚ watch<br>
+⏰ alarm clock<br>
+⏱ stopwatch<br>
+⏲ timer clock<br>
+🕰 mantelpiece clock<br>
+🕛 twelve o’clock<br>
+🕧 twelve-thirty<br>
+🕐 one o’clock<br>
+🕜 one-thirty<br>
+🕑 two o’clock<br>
+🕝 two-thirty<br>
+🕒 three o’clock<br>
+🕞 three-thirty<br>
+🕓 four o’clock<br>
+🕟 four-thirty<br>
+🕔 five o’clock<br>
+🕠 five-thirty<br>
+🕕 six o’clock<br>
+🕡 six-thirty<br>
+🕖 seven o’clock<br>
+🕢 seven-thirty<br>
+🕗 eight o’clock<br>
+🕣 eight-thirty<br>
+🕘 nine o’clock<br>
+🕤 nine-thirty<br>
+🕙 ten o’clock<br>
+🕥 ten-thirty<br>
+🕚 eleven o’clock<br>
+🕦 eleven-thirty<br>
+🌑 new moon<br>
+🌒 waxing crescent moon<br>
+🌓 first quarter moon<br>
+🌔 waxing gibbous moon<br>
+🌕 full moon<br>
+🌖 waning gibbous moon<br>
+🌗 last quarter moon<br>
+🌘 waning crescent moon<br>
+🌙 crescent moon<br>
+🌚 new moon face<br>
+🌛 first quarter moon face<br>
+🌜 last quarter moon face<br>
+🌡 thermometer<br>
+☀ sun<br>
+🌝 full moon face<br>
+🌞 sun with face<br>
+🪐 ringed planet<br>
+⭐ star<br>
+🌟 glowing star<br>
+🌠 shooting star<br>
+🌌 milky way<br>
+☁ cloud<br>
+⛅ sun behind cloud<br>
+⛈ cloud with lightning and rain<br>
+🌤 sun behind small cloud<br>
+🌥 sun behind large cloud<br>
+🌦 sun behind rain cloud<br>
+🌧 cloud with rain<br>
+🌨 cloud with snow<br>
+🌩 cloud with lightning<br>
+🌪 tornado<br>
+🌫 fog<br>
+🌬 wind face<br>
+🌀 cyclone<br>
+🌈 rainbow<br>
+🌂 closed umbrella<br>
+☂ umbrella<br>
+☔ umbrella with rain drops<br>
+⛱ umbrella on ground<br>
+⚡ high voltage<br>
+❄ snowflake<br>
+☃ snowman<br>
+⛄ snowman without snow<br>
+☄ comet<br>
+🔥 fire<br>
+💧 droplet<br>
+🌊 water wave<br>
+🎃 jack-o-lantern<br>
+🎄 Christmas tree<br>
+🎆 fireworks<br>
+🎇 sparkler<br>
+🧨 firecracker<br>
+✨ sparkles<br>
+🎈 balloon<br>
+🎉 party popper<br>
+🎊 confetti ball<br>
+🎋 tanabata tree<br>
+🎍 pine decoration<br>
+🎎 Japanese dolls<br>
+🎏 carp streamer<br>
+🎐 wind chime<br>
+🎑 moon viewing ceremony<br>
+🧧 red envelope<br>
+🎀 ribbon<br>
+🎁 wrapped gift<br>
+🎗 reminder ribbon<br>
+🎟 admission tickets<br>
+🎫 ticket<br>
+🎖 military medal<br>
+🏆 trophy<br>
+🏅 sports medal<br>
+🥇 st place medal<br>
+🥈 nd place medal<br>
+🥉 rd place medal<br>
+⚽ soccer ball<br>
+⚾ baseball<br>
+🥎 softball<br>
+🏀 basketball<br>
+🏐 volleyball<br>
+🏈 american football<br>
+🏉 rugby football<br>
+🎾 tennis<br>
+🥏 flying disc<br>
+🎳 bowling<br>
+🏏 cricket game<br>
+🏑 field hockey<br>
+🏒 ice hockey<br>
+🥍 lacrosse<br>
+🏓 ping pong<br>
+🏸 badminton<br>
+🥊 boxing glove<br>
+🥋 martial arts uniform<br>
+🥅 goal net<br>
+⛳ flag in hole<br>
+⛸ ice skate<br>
+🎣 fishing pole<br>
+🤿 diving mask<br>
+🎽 running shirt<br>
+🎿 skis<br>
+🛷 sled<br>
+🥌 curling stone<br>
+🎯 bullseye<br>
+🪀 yo-yo<br>
+🪁 kite<br>
+🎱 pool  ball<br>
+🔮 crystal ball<br>
+🪄 magic wand<br>
+🧿 nazar amulet<br>
+🎮 video game<br>
+🕹 joystick<br>
+🎰 slot machine<br>
+🎲 game die<br>
+🧩 puzzle piece<br>
+🧸 teddy bear<br>
+🪅 piñata<br>
+🪆 nesting dolls<br>
+♠ spade suit<br>
+♥ heart suit<br>
+♦ diamond suit<br>
+♣ club suit<br>
+♟ chess pawn<br>
+🃏 joker<br>
+🀄 mahjong red dragon<br>
+🎴 flower playing cards<br>
+🎭 performing arts<br>
+🖼 framed picture<br>
+🎨 artist palette<br>
+🧵 thread<br>
+🪡 sewing needle<br>
+🧶 yarn<br>
+🪢 knot<br>
+👓 glasses<br>
+🕶 sunglasses<br>
+🥽 goggles<br>
+🥼 lab coat<br>
+🦺 safety vest<br>
+👔 necktie<br>
+👕 t-shirt<br>
+👖 jeans<br>
+🧣 scarf<br>
+🧤 gloves<br>
+🧥 coat<br>
+🧦 socks<br>
+👗 dress<br>
+👘 kimono<br>
+🥻 sari<br>
+🩱 one-piece swimsuit<br>
+🩲 briefs<br>
+🩳 shorts<br>
+👙 bikini<br>
+👚 woman’s clothes<br>
+👛 purse<br>
+👜 handbag<br>
+👝 clutch bag<br>
+🛍 shopping bags<br>
+🎒 backpack<br>
+🩴 thong sandal<br>
+👞 man’s shoe<br>
+👟 running shoe<br>
+🥾 hiking boot<br>
+🥿 flat shoe<br>
+👠 high-heeled shoe<br>
+👡 woman’s sandal<br>
+🩰 ballet shoes<br>
+👢 woman’s boot<br>
+👑 crown<br>
+👒 woman’s hat<br>
+🎩 top hat<br>
+🎓 graduation cap<br>
+🧢 billed cap<br>
+🪖 military helmet<br>
+⛑ rescue worker’s helmet<br>
+📿 prayer beads<br>
+💄 lipstick<br>
+💍 ring<br>
+💎 gem stone<br>
+🔇 muted speaker<br>
+🔈 speaker low volume<br>
+🔉 speaker medium volume<br>
+🔊 speaker high volume<br>
+📢 loudspeaker<br>
+📣 megaphone<br>
+📯 postal horn<br>
+🔔 bell<br>
+🔕 bell with slash<br>
+🎼 musical score<br>
+🎵 musical note<br>
+🎶 musical notes<br>
+🎙 studio microphone<br>
+🎚 level slider<br>
+🎛 control knobs<br>
+🎤 microphone<br>
+🎧 headphone<br>
+📻 radio<br>
+🎷 saxophone<br>
+🪗 accordion<br>
+🎸 guitar<br>
+🎹 musical keyboard<br>
+🎺 trumpet<br>
+🎻 violin<br>
+🪕 banjo<br>
+🥁 drum<br>
+🪘 long drum<br>
+📱 mobile phone<br>
+📲 mobile phone with arrow<br>
+☎ telephone<br>
+📞 telephone receiver<br>
+📟 pager<br>
+📠 fax machine<br>
+🔋 battery<br>
+🔌 electric plug<br>
+💻 laptop<br>
+🖥 desktop computer<br>
+🖨 printer<br>
+⌨ keyboard<br>
+🖱 computer mouse<br>
+🖲 trackball<br>
+💽 computer disk<br>
+💾 floppy disk<br>
+💿 optical disk<br>
+📀 dvd<br>
+🧮 abacus<br>
+🎥 movie camera<br>
+🎞 film frames<br>
+📽 film projector<br>
+🎬 clapper board<br>
+📺 television<br>
+📷 camera<br>
+📸 camera with flash<br>
+📹 video camera<br>
+📼 videocassette<br>
+🔍 magnifying glass tilted left<br>
+🔎 magnifying glass tilted right<br>
+🕯 candle<br>
+💡 light bulb<br>
+🔦 flashlight<br>
+🏮 red paper lantern<br>
+🪔 diya lamp<br>
+📔 notebook with decorative cover<br>
+📕 closed book<br>
+📖 open book<br>
+📗 green book<br>
+📘 blue book<br>
+📙 orange book<br>
+📚 books<br>
+📓 notebook<br>
+📒 ledger<br>
+📃 page with curl<br>
+📜 scroll<br>
+📄 page facing up<br>
+📰 newspaper<br>
+🗞 rolled-up newspaper<br>
+📑 bookmark tabs<br>
+🔖 bookmark<br>
+🏷 label<br>
+💰 money bag<br>
+🪙 coin<br>
+💴 yen banknote<br>
+💵 dollar banknote<br>
+💶 euro banknote<br>
+💷 pound banknote<br>
+💸 money with wings<br>
+💳 credit card<br>
+🧾 receipt<br>
+💹 chart increasing with yen<br>
+✉ envelope<br>
+📧 e-mail<br>
+📨 incoming envelope<br>
+📩 envelope with arrow<br>
+📤 outbox tray<br>
+📥 inbox tray<br>
+📦 package<br>
+📫 closed mailbox with raised flag<br>
+📪 closed mailbox with lowered flag<br>
+📬 open mailbox with raised flag<br>
+📭 open mailbox with lowered flag<br>
+📮 postbox<br>
+🗳 ballot box with ballot<br>
+✏ pencil<br>
+✒ black nib<br>
+🖋 fountain pen<br>
+🖊 pen<br>
+🖌 paintbrush<br>
+🖍 crayon<br>
+📝 memo<br>
+💼 briefcase<br>
+📁 file folder<br>
+📂 open file folder<br>
+🗂 card index dividers<br>
+📅 calendar<br>
+📆 tear-off calendar<br>
+🗒 spiral notepad<br>
+🗓 spiral calendar<br>
+📇 card index<br>
+📈 chart increasing<br>
+📉 chart decreasing<br>
+📊 bar chart<br>
+📋 clipboard<br>
+📌 pushpin<br>
+📍 round pushpin<br>
+📎 paperclip<br>
+🖇 linked paperclips<br>
+📏 straight ruler<br>
+📐 triangular ruler<br>
+✂ scissors<br>
+🗃 card file box<br>
+🗄 file cabinet<br>
+🗑 wastebasket<br>
+🔒 locked<br>
+🔓 unlocked<br>
+🔏 locked with pen<br>
+🔐 locked with key<br>
+🔑 key<br>
+🗝 old key<br>
+🔨 hammer<br>
+🪓 axe<br>
+⛏ pick<br>
+⚒ hammer and pick<br>
+🛠 hammer and wrench<br>
+🗡 dagger<br>
+⚔ crossed swords<br>
+🔫 water pistol<br>
+🪃 boomerang<br>
+🏹 bow and arrow<br>
+🛡 shield<br>
+🪚 carpentry saw<br>
+🔧 wrench<br>
+🪛 screwdriver<br>
+🔩 nut and bolt<br>
+⚙ gear<br>
+🗜 clamp<br>
+⚖ balance scale<br>
+🦯 white cane<br>
+🔗 link<br>
+⛓ chains<br>
+🪝 hook<br>
+🧰 toolbox<br>
+🧲 magnet<br>
+🪜 ladder<br>
+⚗ alembic<br>
+🧪 test tube<br>
+🧫 petri dish<br>
+🧬 dna<br>
+🔬 microscope<br>
+🔭 telescope<br>
+📡 satellite antenna<br>
+💉 syringe<br>
+🩸 drop of blood<br>
+💊 pill<br>
+🩹 adhesive bandage<br>
+🩺 stethoscope<br>
+🚪 door<br>
+🛗 elevator<br>
+🪞 mirror<br>
+🪟 window<br>
+🛏 bed<br>
+🛋 couch and lamp<br>
+🪑 chair<br>
+🚽 toilet<br>
+🪠 plunger<br>
+🚿 shower<br>
+🛁 bathtub<br>
+🪤 mouse trap<br>
+🪒 razor<br>
+🧴 lotion bottle<br>
+🧷 safety pin<br>
+🧹 broom<br>
+🧺 basket<br>
+🧻 roll of paper<br>
+🪣 bucket<br>
+🧼 soap<br>
+🪥 toothbrush<br>
+🧽 sponge<br>
+🧯 fire extinguisher<br>
+🛒 shopping cart<br>
+🚬 cigarette<br>
+⚰ coffin<br>
+🪦 headstone<br>
+⚱ funeral urn<br>
+🗿 moai<br>
+🪧 placard<br>
+🏧 ATM sign<br>
+🚮 litter in bin sign<br>
+🚰 potable water<br>
+♿ wheelchair symbol<br>
+🚹 men’s room<br>
+🚺 women’s room<br>
+🚻 restroom<br>
+🚼 baby symbol<br>
+🚾 water closet<br>
+🛂 passport control<br>
+🛃 customs<br>
+🛄 baggage claim<br>
+🛅 left luggage<br>
+⚠ warning<br>
+🚸 children crossing<br>
+⛔ no entry<br>
+🚫 prohibited<br>
+🚳 no bicycles<br>
+🚭 no smoking<br>
+🚯 no littering<br>
+🚱 non-potable water<br>
+🚷 no pedestrians<br>
+📵 no mobile phones<br>
+🔞 no one under eighteen<br>
+☢ radioactive<br>
+☣ biohazard<br>
+⬆ up arrow<br>
+↗ up-right arrow<br>
+➡ right arrow<br>
+↘ down-right arrow<br>
+⬇ down arrow<br>
+↙ down-left arrow<br>
+⬅ left arrow<br>
+↖ up-left arrow<br>
+↕ up-down arrow<br>
+↔ left-right arrow<br>
+↩ right arrow curving left<br>
+↪ left arrow curving right<br>
+⤴ right arrow curving up<br>
+⤵ right arrow curving down<br>
+🔃 clockwise vertical arrows<br>
+🔄 counterclockwise arrows button<br>
+🔙 BACK arrow<br>
+🔚 END arrow<br>
+🔛 ON! arrow<br>
+🔜 SOON arrow<br>
+🔝 TOP arrow<br>
+🛐 place of worship<br>
+⚛ atom symbol<br>
+🕉 om<br>
+✡ star of David<br>
+☸ wheel of dharma<br>
+☯ yin yang<br>
+✝ latin cross<br>
+☦ orthodox cross<br>
+☪ star and crescent<br>
+☮ peace symbol<br>
+🕎 menorah<br>
+🔯 dotted six-pointed star<br>
+♈ Aries<br>
+♉ Taurus<br>
+♊ Gemini<br>
+♋ Cancer<br>
+♌ Leo<br>
+♍ Virgo<br>
+♎ Libra<br>
+♏ Scorpio<br>
+♐ Sagittarius<br>
+♑ Capricorn<br>
+♒ Aquarius<br>
+♓ Pisces<br>
+⛎ Ophiuchus<br>
+🔀 shuffle tracks button<br>
+🔁 repeat button<br>
+🔂 repeat single button<br>
+▶ play button<br>
+⏩ fast-forward button<br>
+⏭ next track button<br>
+⏯ play or pause button<br>
+◀ reverse button<br>
+⏪ fast reverse button<br>
+⏮ last track button<br>
+🔼 upwards button<br>
+⏫ fast up button<br>
+🔽 downwards button<br>
+⏬ fast down button<br>
+⏸ pause button<br>
+⏹ stop button<br>
+⏺ record button<br>
+⏏ eject button<br>
+🎦 cinema<br>
+🔅 dim button<br>
+🔆 bright button<br>
+📶 antenna bars<br>
+📳 vibration mode<br>
+📴 mobile phone off<br>
+♀ female sign<br>
+♂ male sign<br>
+⚧ transgender symbol<br>
+✖ multiply<br>
+➕ plus<br>
+➖ minus<br>
+➗ divide<br>
+♾ infinity<br>
+‼ double exclamation mark<br>
+⁉ exclamation question mark<br>
+❓ red question mark<br>
+❔ white question mark<br>
+❕ white exclamation mark<br>
+❗ red exclamation mark<br>
+〰 wavy dash<br>
+💱 currency exchange<br>
+💲 heavy dollar sign<br>
+⚕ medical symbol<br>
+♻ recycling symbol<br>
+⚜ fleur-de-lis<br>
+🔱 trident emblem<br>
+📛 name badge<br>
+🔰 Japanese symbol for beginner<br>
+⭕ hollow red circle<br>
+✅ check mark button<br>
+☑ check box with check<br>
+✔ check mark<br>
+❌ cross mark<br>
+❎ cross mark button<br>
+➰ curly loop<br>
+➿ double curly loop<br>
+〽 part alternation mark<br>
+✳ eight-spoked asterisk<br>
+✴ eight-pointed star<br>
+❇ sparkle<br>
+© copyright<br>
+® registered<br>
+™ trade mark<br>
+#️⃣ keycap: #<br>
+*️⃣ keycap: *<br>
+0️⃣ keycap: 0<br>
+1️⃣ keycap: 1<br>
+2️⃣ keycap: 2<br>
+3️⃣ keycap: 3<br>
+4️⃣ keycap: 4<br>
+5️⃣ keycap: 5<br>
+6️⃣ keycap: 6<br>
+7️⃣ keycap: 7<br>
+8️⃣ keycap: 8<br>
+9️⃣ keycap: 9<br>
+🔟 keycap: 10<br>
+🔠 input latin uppercase<br>
+🔡 input latin lowercase<br>
+🔢 input numbers<br>
+🔣 input symbols<br>
+🔤 input latin letters<br>
+🅰 A button (blood type)<br>
+🆎 AB button (blood type)<br>
+🅱 B button (blood type)<br>
+🆑 CL button<br>
+🆒 COOL button<br>
+🆓 FREE button<br>
+ℹ information<br>
+🆔 ID button<br>
+Ⓜ circled M<br>
+🆕 NEW button<br>
+🆖 NG button<br>
+🅾 O button (blood type)<br>
+🆗 OK button<br>
+🅿 P button<br>
+🆘 SOS button<br>
+🆙 UP! button<br>
+🆚 VS button<br>
+🈁 Japanese “here” button<br>
+🈂 Japanese “service charge” button<br>
+🈷 Japanese “monthly amount” button<br>
+🈶 Japanese “not free of charge” button<br>
+🈯 Japanese “reserved” button<br>
+🉐 Japanese “bargain” button<br>
+🈹 Japanese “discount” button<br>
+🈚 Japanese “free of charge” button<br>
+🈲 Japanese “prohibited” button<br>
+🉑 Japanese “acceptable” button<br>
+🈸 Japanese “application” button<br>
+🈴 Japanese “passing grade” button<br>
+🈳 Japanese “vacancy” button<br>
+㊗ Japanese “congratulations” button<br>
+㊙ Japanese “secret” button<br>
+🈺 Japanese “open for business” button<br>
+🈵 Japanese “no vacancy” button<br>
+🔴 red circle<br>
+🟠 orange circle<br>
+🟡 yellow circle<br>
+🟢 green circle<br>
+🔵 blue circle<br>
+🟣 purple circle<br>
+🟤 brown circle<br>
+⚫ black circle<br>
+⚪ white circle<br>
+🟥 red square<br>
+🟧 orange square<br>
+🟨 yellow square<br>
+🟩 green square<br>
+🟦 blue square<br>
+🟪 purple square<br>
+🟫 brown square<br>
+⬛ black large square<br>
+⬜ white large square<br>
+◼ black medium square<br>
+◻ white medium square<br>
+◾ black medium-small square<br>
+◽ white medium-small square<br>
+▪ black small square<br>
+▫ white small square<br>
+🔶 large orange diamond<br>
+🔷 large blue diamond<br>
+🔸 small orange diamond<br>
+🔹 small blue diamond<br>
+🔺 red triangle pointed up<br>
+🔻 red triangle pointed down<br>
+💠 diamond with a dot<br>
+🔘 radio button<br>
+🔳 white square button<br>
+🔲 black square button<br>
+🏁 chequered flag<br>
+🚩 triangular flag<br>
+🎌 crossed flags<br>
+🏴 black flag<br>
+🏳 white flag<br>
+🏳️‍🌈 rainbow flag<br>
+🏳️‍⚧️ transgender flag<br>
+🏴‍☠️ pirate flag<br>
+🇦🇨 flag: Ascension Island<br>
+🇦🇩 flag: Andorra<br>
+🇦🇪 flag: United Arab Emirates<br>
+🇦🇫 flag: Afghanistan<br>
+🇦🇬 flag: Antigua &amp; Barbuda<br>
+🇦🇮 flag: Anguilla<br>
+🇦🇱 flag: Albania<br>
+🇦🇲 flag: Armenia<br>
+🇦🇴 flag: Angola<br>
+🇦🇶 flag: Antarctica<br>
+🇦🇷 flag: Argentina<br>
+🇦🇸 flag: American Samoa<br>
+🇦🇹 flag: Austria<br>
+🇦🇺 flag: Australia<br>
+🇦🇼 flag: Aruba<br>
+🇦🇽 flag: Åland Islands<br>
+🇦🇿 flag: Azerbaijan<br>
+🇧🇦 flag: Bosnia &amp; Herzegovina<br>
+🇧🇧 flag: Barbados<br>
+🇧🇩 flag: Bangladesh<br>
+🇧🇪 flag: Belgium<br>
+🇧🇫 flag: Burkina Faso<br>
+🇧🇬 flag: Bulgaria<br>
+🇧🇭 flag: Bahrain<br>
+🇧🇮 flag: Burundi<br>
+🇧🇯 flag: Benin<br>
+🇧🇱 flag: St. Barthélemy<br>
+🇧🇲 flag: Bermuda<br>
+🇧🇳 flag: Brunei<br>
+🇧🇴 flag: Bolivia<br>
+🇧🇶 flag: Caribbean Netherlands<br>
+🇧🇷 flag: Brazil<br>
+🇧🇸 flag: Bahamas<br>
+🇧🇹 flag: Bhutan<br>
+🇧🇻 flag: Bouvet Island<br>
+🇧🇼 flag: Botswana<br>
+🇧🇾 flag: Belarus<br>
+🇧🇿 flag: Belize<br>
+🇨🇦 flag: Canada<br>
+🇨🇨 flag: Cocos (Keeling) Islands<br>
+🇨🇩 flag: Congo - Kinshasa<br>
+🇨🇫 flag: Central African Republic<br>
+🇨🇬 flag: Congo - Brazzaville<br>
+🇨🇭 flag: Switzerland<br>
+🇨🇮 flag: Côte d’Ivoire<br>
+🇨🇰 flag: Cook Islands<br>
+🇨🇱 flag: Chile<br>
+🇨🇲 flag: Cameroon<br>
+🇨🇳 flag: China<br>
+🇨🇴 flag: Colombia<br>
+🇨🇵 flag: Clipperton Island<br>
+🇨🇷 flag: Costa Rica<br>
+🇨🇺 flag: Cuba<br>
+🇨🇻 flag: Cape Verde<br>
+🇨🇼 flag: Curaçao<br>
+🇨🇽 flag: Christmas Island<br>
+🇨🇾 flag: Cyprus<br>
+🇨🇿 flag: Czechia<br>
+🇩🇪 flag: Germany<br>
+🇩🇬 flag: Diego Garcia<br>
+🇩🇯 flag: Djibouti<br>
+🇩🇰 flag: Denmark<br>
+🇩🇲 flag: Dominica<br>
+🇩🇴 flag: Dominican Republic<br>
+🇩🇿 flag: Algeria<br>
+🇪🇦 flag: Ceuta &amp; Melilla<br>
+🇪🇨 flag: Ecuador<br>
+🇪🇪 flag: Estonia<br>
+🇪🇬 flag: Egypt<br>
+🇪🇭 flag: Western Sahara<br>
+🇪🇷 flag: Eritrea<br>
+🇪🇸 flag: Spain<br>
+🇪🇹 flag: Ethiopia<br>
+🇪🇺 flag: European Union<br>
+🇫🇮 flag: Finland<br>
+🇫🇯 flag: Fiji<br>
+🇫🇰 flag: Falkland Islands<br>
+🇫🇲 flag: Micronesia<br>
+🇫🇴 flag: Faroe Islands<br>
+🇫🇷 flag: France<br>
+🇬🇦 flag: Gabon<br>
+🇬🇧 flag: United Kingdom<br>
+🇬🇩 flag: Grenada<br>
+🇬🇪 flag: Georgia<br>
+🇬🇫 flag: French Guiana<br>
+🇬🇬 flag: Guernsey<br>
+🇬🇭 flag: Ghana<br>
+🇬🇮 flag: Gibraltar<br>
+🇬🇱 flag: Greenland<br>
+🇬🇲 flag: Gambia<br>
+🇬🇳 flag: Guinea<br>
+🇬🇵 flag: Guadeloupe<br>
+🇬🇶 flag: Equatorial Guinea<br>
+🇬🇷 flag: Greece<br>
+🇬🇸 flag: South Georgia &amp; South Sandwich Islands<br>
+🇬🇹 flag: Guatemala<br>
+🇬🇺 flag: Guam<br>
+🇬🇼 flag: Guinea-Bissau<br>
+🇬🇾 flag: Guyana<br>
+🇭🇰 flag: Hong Kong SAR China<br>
+🇭🇲 flag: Heard &amp; McDonald Islands<br>
+🇭🇳 flag: Honduras<br>
+🇭🇷 flag: Croatia<br>
+🇭🇹 flag: Haiti<br>
+🇭🇺 flag: Hungary<br>
+🇮🇨 flag: Canary Islands<br>
+🇮🇩 flag: Indonesia<br>
+🇮🇪 flag: Ireland<br>
+🇮🇱 flag: Israel<br>
+🇮🇲 flag: Isle of Man<br>
+🇮🇳 flag: India<br>
+🇮🇴 flag: British Indian Ocean Territory<br>
+🇮🇶 flag: Iraq<br>
+🇮🇷 flag: Iran<br>
+🇮🇸 flag: Iceland<br>
+🇮🇹 flag: Italy<br>
+🇯🇪 flag: Jersey<br>
+🇯🇲 flag: Jamaica<br>
+🇯🇴 flag: Jordan<br>
+🇯🇵 flag: Japan<br>
+🇰🇪 flag: Kenya<br>
+🇰🇬 flag: Kyrgyzstan<br>
+🇰🇭 flag: Cambodia<br>
+🇰🇮 flag: Kiribati<br>
+🇰🇲 flag: Comoros<br>
+🇰🇳 flag: St. Kitts &amp; Nevis<br>
+🇰🇵 flag: North Korea<br>
+🇰🇷 flag: South Korea<br>
+🇰🇼 flag: Kuwait<br>
+🇰🇾 flag: Cayman Islands<br>
+🇰🇿 flag: Kazakhstan<br>
+🇱🇦 flag: Laos<br>
+🇱🇧 flag: Lebanon<br>
+🇱🇨 flag: St. Lucia<br>
+🇱🇮 flag: Liechtenstein<br>
+🇱🇰 flag: Sri Lanka<br>
+🇱🇷 flag: Liberia<br>
+🇱🇸 flag: Lesotho<br>
+🇱🇹 flag: Lithuania<br>
+🇱🇺 flag: Luxembourg<br>
+🇱🇻 flag: Latvia<br>
+🇱🇾 flag: Libya<br>
+🇲🇦 flag: Morocco<br>
+🇲🇨 flag: Monaco<br>
+🇲🇩 flag: Moldova<br>
+🇲🇪 flag: Montenegro<br>
+🇲🇫 flag: St. Martin<br>
+🇲🇬 flag: Madagascar<br>
+🇲🇭 flag: Marshall Islands<br>
+🇲🇰 flag: North Macedonia<br>
+🇲🇱 flag: Mali<br>
+🇲🇲 flag: Myanmar (Burma)<br>
+🇲🇳 flag: Mongolia<br>
+🇲🇴 flag: Macao SAR China<br>
+🇲🇵 flag: Northern Mariana Islands<br>
+🇲🇶 flag: Martinique<br>
+🇲🇷 flag: Mauritania<br>
+🇲🇸 flag: Montserrat<br>
+🇲🇹 flag: Malta<br>
+🇲🇺 flag: Mauritius<br>
+🇲🇻 flag: Maldives<br>
+🇲🇼 flag: Malawi<br>
+🇲🇽 flag: Mexico<br>
+🇲🇾 flag: Malaysia<br>
+🇲🇿 flag: Mozambique<br>
+🇳🇦 flag: Namibia<br>
+🇳🇨 flag: New Caledonia<br>
+🇳🇪 flag: Niger<br>
+🇳🇫 flag: Norfolk Island<br>
+🇳🇬 flag: Nigeria<br>
+🇳🇮 flag: Nicaragua<br>
+🇳🇱 flag: Netherlands<br>
+🇳🇴 flag: Norway<br>
+🇳🇵 flag: Nepal<br>
+🇳🇷 flag: Nauru<br>
+🇳🇺 flag: Niue<br>
+🇳🇿 flag: New Zealand<br>
+🇴🇲 flag: Oman<br>
+🇵🇦 flag: Panama<br>
+🇵🇪 flag: Peru<br>
+🇵🇫 flag: French Polynesia<br>
+🇵🇬 flag: Papua New Guinea<br>
+🇵🇭 flag: Philippines<br>
+🇵🇰 flag: Pakistan<br>
+🇵🇱 flag: Poland<br>
+🇵🇲 flag: St. Pierre &amp; Miquelon<br>
+🇵🇳 flag: Pitcairn Islands<br>
+🇵🇷 flag: Puerto Rico<br>
+🇵🇸 flag: Palestinian Territories<br>
+🇵🇹 flag: Portugal<br>
+🇵🇼 flag: Palau<br>
+🇵🇾 flag: Paraguay<br>
+🇶🇦 flag: Qatar<br>
+🇷🇪 flag: Réunion<br>
+🇷🇴 flag: Romania<br>
+🇷🇸 flag: Serbia<br>
+🇷🇺 flag: Russia<br>
+🇷🇼 flag: Rwanda<br>
+🇸🇦 flag: Saudi Arabia<br>
+🇸🇧 flag: Solomon Islands<br>
+🇸🇨 flag: Seychelles<br>
+🇸🇩 flag: Sudan<br>
+🇸🇪 flag: Sweden<br>
+🇸🇬 flag: Singapore<br>
+🇸🇭 flag: St. Helena<br>
+🇸🇮 flag: Slovenia<br>
+🇸🇯 flag: Svalbard &amp; Jan Mayen<br>
+🇸🇰 flag: Slovakia<br>
+🇸🇱 flag: Sierra Leone<br>
+🇸🇲 flag: San Marino<br>
+🇸🇳 flag: Senegal<br>
+🇸🇴 flag: Somalia<br>
+🇸🇷 flag: Suriname<br>
+🇸🇸 flag: South Sudan<br>
+🇸🇹 flag: São Tomé &amp; Príncipe<br>
+🇸🇻 flag: El Salvador<br>
+🇸🇽 flag: Sint Maarten<br>
+🇸🇾 flag: Syria<br>
+🇸🇿 flag: Eswatini<br>
+🇹🇦 flag: Tristan da Cunha<br>
+🇹🇨 flag: Turks &amp; Caicos Islands<br>
+🇹🇩 flag: Chad<br>
+🇹🇫 flag: French Southern Territories<br>
+🇹🇬 flag: Togo<br>
+🇹🇭 flag: Thailand<br>
+🇹🇯 flag: Tajikistan<br>
+🇹🇰 flag: Tokelau<br>
+🇹🇱 flag: Timor-Leste<br>
+🇹🇲 flag: Turkmenistan<br>
+🇹🇳 flag: Tunisia<br>
+🇹🇴 flag: Tonga<br>
+🇹🇷 flag: Turkey<br>
+🇹🇹 flag: Trinidad &amp; Tobago<br>
+🇹🇻 flag: Tuvalu<br>
+🇹🇼 flag: Taiwan<br>
+🇹🇿 flag: Tanzania<br>
+🇺🇦 flag: Ukraine<br>
+🇺🇬 flag: Uganda<br>
+🇺🇲 flag: U.S. Outlying Islands<br>
+🇺🇳 flag: United Nations<br>
+🇺🇸 flag: United States<br>
+🇺🇾 flag: Uruguay<br>
+🇺🇿 flag: Uzbekistan<br>
+🇻🇦 flag: Vatican City<br>
+🇻🇨 flag: St. Vincent &amp; Grenadines<br>
+🇻🇪 flag: Venezuela<br>
+🇻🇬 flag: British Virgin Islands<br>
+🇻🇮 flag: U.S. Virgin Islands<br>
+🇻🇳 flag: Vietnam<br>
+🇻🇺 flag: Vanuatu<br>
+🇼🇫 flag: Wallis &amp; Futuna<br>
+🇼🇸 flag: Samoa<br>
+🇽🇰 flag: Kosovo<br>
+🇾🇪 flag: Yemen<br>
+🇾🇹 flag: Mayotte<br>
+🇿🇦 flag: South Africa<br>
+🇿🇲 flag: Zambia<br>
+🇿🇼 flag: Zimbabwe<br>
+🏴󠁧󠁢󠁥󠁮󠁧󠁿 flag: England<br>
+🏴󠁧󠁢󠁳󠁣󠁴󠁿 flag: Scotland<br>
+🏴󠁧󠁢󠁷󠁬󠁳󠁿 flag: Wales<br>
+    </main>
+  </body>
+</html>
diff --git a/geolite2.php b/geolite2.php
new file mode 100644
index 0000000..b36fec8
--- /dev/null
+++ b/geolite2.php
@@ -0,0 +1,56 @@
+<?php
+$ip = substr($_SERVER['REQUEST_URI'], 1);
+
+if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4))
+  $ipFormat = "IPv4";
+else if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6))
+  $ipFormat = "IPv6";
+else
+  exit("This is not a valid IP address!");
+
+define("GEOLITE2_DATE", "20210914");
+require('db-reader/autoload.php');
+use MaxMind\Db\Reader;
+
+$reader = new Reader("geolite2/GeoLite2-ASN_" . GEOLITE2_DATE . "/GeoLite2-ASN.mmdb");
+$asnData = $reader->get($ip);
+$reader->close();
+
+$reader = new Reader("geolite2/GeoLite2-City_" . GEOLITE2_DATE . "/GeoLite2-City.mmdb");
+$cityData = $reader->get($ip);
+$reader->close();
+
+?>
+<!DOCTYPE html>
+<html>
+    <head>
+	     <meta charset="UTF-8">
+       <title>Informations about <?= $ipFormat ?> address <?= htmlspecialchars($ip) ?></title>
+    </head>
+    <body>
+      <h1>Informations about <?= $ipFormat ?> address <code><?= htmlspecialchars($ip) ?></code></h1>
+      <main>
+        <abbr title="Autonomous System Number">ASN</abbr>: <code><?= htmlspecialchars($asnData['autonomous_system_number']) ?></code><br>
+        <abbr title="Autonomous System">AS</abbr> name: <?= htmlspecialchars($asnData['autonomous_system_organization']) ?><br>
+        Location: <a href="geo:<?= htmlspecialchars($cityData['location']['latitude']) ?>,<?= htmlspecialchars($cityData['location']['longitude']) ?>"><?= htmlspecialchars($cityData['location']['latitude']) ?>,<?= htmlspecialchars($cityData['location']['longitude']) ?></a> (accuracy radius: <?= htmlspecialchars($cityData['location']['accuracy_radius']) ?> km)<br>
+        Continent: <?php if (isset($cityData['continent']['names']['en'])) echo htmlspecialchars($cityData['continent']['names']['en']) . " (" . htmlspecialchars($cityData['continent']['code']) . ")"; else echo "unknown"; ?><br>
+        Time zone: <?php if (isset($cityData['location']['time_zone'])) echo htmlspecialchars($cityData['location']['time_zone']); else echo "unknown"; ?><br>
+        Country: <?php if (isset($cityData['country']['names']['en'])) echo htmlspecialchars($cityData['country']['names']['en']) . " (" . htmlspecialchars($cityData['country']['iso_code']) . ")"; else echo "unknown"; ?><br>
+        Subdivision: <?php if (isset($cityData['subdivisions']['0']['names']['en'])) echo htmlspecialchars($cityData['subdivisions']['0']['names']['en']) . " (" . htmlspecialchars($cityData['subdivisions']['0']['iso_code']) . ")"; else echo "unknown"; ?><br>
+        Postal code: <?php if (isset($cityData['postal']['code'])) echo htmlspecialchars($cityData['postal']['code']); else echo "unknown"; ?><br>
+        City: <?php if (isset($cityData['city']['names']['en'])) echo htmlspecialchars($cityData['city']['names']['en']); else echo "unknown"; ?><br>
+      </main>
+      <footer>
+        <small>This page queries a local GeoLite2 database dating from <?= GEOLITE2_DATE ?>.</small>
+      </footer>
+    </body>
+</html>
+<!--
+
+RAW ASN DATA
+<?= htmlspecialchars(var_dump($asnData)); ?>
+
+RAW CITY DATA
+<?= htmlspecialchars(var_dump($cityData)); ?>
+
+-->
diff --git a/geolite2/GeoLite2-ASN_20210914/COPYRIGHT.txt b/geolite2/GeoLite2-ASN_20210914/COPYRIGHT.txt
new file mode 100644
index 0000000..90eb0ee
--- /dev/null
+++ b/geolite2/GeoLite2-ASN_20210914/COPYRIGHT.txt
@@ -0,0 +1 @@
+Database and Contents Copyright (c) 2021 MaxMind, Inc.
diff --git a/geolite2/GeoLite2-ASN_20210914/GeoLite2-ASN.mmdb b/geolite2/GeoLite2-ASN_20210914/GeoLite2-ASN.mmdb
new file mode 100644
index 0000000..aacf58b
Binary files /dev/null and b/geolite2/GeoLite2-ASN_20210914/GeoLite2-ASN.mmdb differ
diff --git a/geolite2/GeoLite2-ASN_20210914/LICENSE.txt b/geolite2/GeoLite2-ASN_20210914/LICENSE.txt
new file mode 100644
index 0000000..ee7434d
--- /dev/null
+++ b/geolite2/GeoLite2-ASN_20210914/LICENSE.txt
@@ -0,0 +1,3 @@
+Use of this MaxMind product is governed by MaxMind's GeoLite2 End User License Agreement, which can be viewed at https://www.maxmind.com/en/geolite2/eula.
+
+This database incorporates GeoNames [https://www.geonames.org] geographical data, which is made available under the Creative Commons Attribution 4.0 License. To view a copy of this license, visit https://creativecommons.org/licenses/by/4.0/.
diff --git a/geolite2/GeoLite2-City_20210914/COPYRIGHT.txt b/geolite2/GeoLite2-City_20210914/COPYRIGHT.txt
new file mode 100644
index 0000000..90eb0ee
--- /dev/null
+++ b/geolite2/GeoLite2-City_20210914/COPYRIGHT.txt
@@ -0,0 +1 @@
+Database and Contents Copyright (c) 2021 MaxMind, Inc.
diff --git a/geolite2/GeoLite2-City_20210914/GeoLite2-City.mmdb b/geolite2/GeoLite2-City_20210914/GeoLite2-City.mmdb
new file mode 100644
index 0000000..0db8d36
Binary files /dev/null and b/geolite2/GeoLite2-City_20210914/GeoLite2-City.mmdb differ
diff --git a/geolite2/GeoLite2-City_20210914/LICENSE.txt b/geolite2/GeoLite2-City_20210914/LICENSE.txt
new file mode 100644
index 0000000..ee7434d
--- /dev/null
+++ b/geolite2/GeoLite2-City_20210914/LICENSE.txt
@@ -0,0 +1,3 @@
+Use of this MaxMind product is governed by MaxMind's GeoLite2 End User License Agreement, which can be viewed at https://www.maxmind.com/en/geolite2/eula.
+
+This database incorporates GeoNames [https://www.geonames.org] geographical data, which is made available under the Creative Commons Attribution 4.0 License. To view a copy of this license, visit https://creativecommons.org/licenses/by/4.0/.
diff --git a/geolite2/GeoLite2-City_20210914/README.txt b/geolite2/GeoLite2-City_20210914/README.txt
new file mode 100644
index 0000000..16e29ad
--- /dev/null
+++ b/geolite2/GeoLite2-City_20210914/README.txt
@@ -0,0 +1 @@
+Latitude and longitude are not precise and should not be used to identify a particular street address or household.
diff --git a/geolite2/GeoLite2-Country_20210914/COPYRIGHT.txt b/geolite2/GeoLite2-Country_20210914/COPYRIGHT.txt
new file mode 100644
index 0000000..90eb0ee
--- /dev/null
+++ b/geolite2/GeoLite2-Country_20210914/COPYRIGHT.txt
@@ -0,0 +1 @@
+Database and Contents Copyright (c) 2021 MaxMind, Inc.
diff --git a/geolite2/GeoLite2-Country_20210914/GeoLite2-Country.mmdb b/geolite2/GeoLite2-Country_20210914/GeoLite2-Country.mmdb
new file mode 100644
index 0000000..d1e6a57
Binary files /dev/null and b/geolite2/GeoLite2-Country_20210914/GeoLite2-Country.mmdb differ
diff --git a/geolite2/GeoLite2-Country_20210914/LICENSE.txt b/geolite2/GeoLite2-Country_20210914/LICENSE.txt
new file mode 100644
index 0000000..ee7434d
--- /dev/null
+++ b/geolite2/GeoLite2-Country_20210914/LICENSE.txt
@@ -0,0 +1,3 @@
+Use of this MaxMind product is governed by MaxMind's GeoLite2 End User License Agreement, which can be viewed at https://www.maxmind.com/en/geolite2/eula.
+
+This database incorporates GeoNames [https://www.geonames.org] geographical data, which is made available under the Creative Commons Attribution 4.0 License. To view a copy of this license, visit https://creativecommons.org/licenses/by/4.0/.
diff --git a/index.php b/index.php
new file mode 100644
index 0000000..a10a912
--- /dev/null
+++ b/index.php
@@ -0,0 +1,9 @@
+<?php
+if ($_SERVER['REQUEST_URI'] === "/me")
+  header("Location: /" . htmlspecialchars($_SERVER['REMOTE_ADDR']));
+else if ($_SERVER['REQUEST_URI'] === "/emoji")
+  echo file_get_contents("emoji.html");
+else if (filter_var(substr($_SERVER['REQUEST_URI'], 1), FILTER_VALIDATE_IP))
+  require "geolite2.php";
+else
+  require "meta.php";
diff --git a/meta.php b/meta.php
new file mode 100644
index 0000000..637b5f1
--- /dev/null
+++ b/meta.php
@@ -0,0 +1,103 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8">
+    <title>Meta</title>
+  </head>
+  <body>
+
+    <section>
+      <h1><abbr title="Internet Protocol">IP</abbr></h1>
+      Client address: <samp><?= htmlspecialchars($_SERVER['REMOTE_ADDR']) ?></samp> (<a href="<?= htmlspecialchars($_SERVER['REMOTE_ADDR']) ?>">informations from database</a>)<br>
+      Server address: <?php
+      if (filter_var($_SERVER['SERVER_ADDR'], FILTER_VALIDATE_IP, FILTER_FLAG_NO_PRIV_RANGE)) { ?>
+        <samp><?= htmlspecialchars($_SERVER['SERVER_ADDR']) ?></samp> (<a href="<?= htmlspecialchars($_SERVER['SERVER_ADDR']) ?>">informations from database</a>)
+      <?php } else
+        echo "<em>- (require IPv6)</em>";
+      ?>
+      <br>
+
+    </section>
+
+    <section>
+      <h1><abbr title="Transmission Control Protocol">TCP</abbr></h1>
+      <abbr title="Round Trip Time">RTT</abbr>: <samp><?= htmlspecialchars($_SERVER['TCPINFO_RTT']) ?></samp> milliseconds<br>
+      <abbr title="Round Trip Time">RTT</abbr> variance: <samp><?= htmlspecialchars($_SERVER['TCPINFO_RTTVAR']) ?></samp><br>
+      SND CWND: <samp><?= htmlspecialchars($_SERVER['TCPINFO_SND_CWND']) ?></samp><br>
+      RCV SPACE: <samp><?= htmlspecialchars($_SERVER['TCPINFO_RCV_SPACE']) ?></samp><br>
+      <section>
+        <h2>Ports</h2>
+
+        Client port: <samp><?= htmlspecialchars($_SERVER['REMOTE_PORT']) ?></samp><br>
+        Server port: <samp><?= htmlspecialchars($_SERVER['SERVER_PORT']) ?></samp><br>
+
+        <details>
+          <summary>Test outgoing destination ports (IPv6 only)</summary>
+          <?php
+          $reachablePorts = Array(1,2,20,21,22,23,25,53,80,123,143,443,587,853,993,1312,3478,5349,8448,16384,25535,32768,49152,65535);
+          foreach ($reachablePorts as $port) { ?>
+            <a href="https://ports.meta.4.niv.re:<?= $port ?>/">https://ports.meta.4.niv.re:<strong><?= $port ?></strong>/</a><br>
+          <?php }
+
+          ?>
+        </details>
+      </section>
+    </section>
+
+    <section>
+      <h1><abbr title="Transport Layer Security">TLS</abbr></h1>
+      TLS session ID: <samp><?= htmlspecialchars($_SERVER['SSL_SESSION_ID']) ?></samp><br>
+      Offered TLS curves: <samp><?= htmlspecialchars($_SERVER['SSL_CURVES']) ?></samp><br>
+      Offered TLS ciphers: <samp><?= htmlspecialchars($_SERVER['SSL_CIPHERS']) ?></samp><br>
+      Negotiated TLS cipher: <samp><?= htmlspecialchars($_SERVER['SSL_CIPHER']) ?></samp><br>
+      Negotiated TLS version: <samp><?= htmlspecialchars($_SERVER['SSL_PROTOCOL']) ?></samp><br>
+    </section>
+
+    <section>
+      <h1><abbr title="HyperText Transfert Protocol">HTTP</abbr></h1>
+      Request line: <samp><?= htmlspecialchars($_SERVER['REQUEST']) ?></samp><br>
+
+      <section>
+        <h2>Headers</h2>
+        <pre><?php
+        foreach (getallheaders() as $name => $value) {
+          if ($name !== "Content-Length" AND $name !== "Content-Type")
+            echo htmlspecialchars($name) . ": " . htmlspecialchars($value) . "\n";
+        } ?></pre>
+
+        <details>
+          <summary>Headers definition lists</summary>
+          <a href="https://en.wikipedia.org/wiki/List_of_HTTP_header_fields">https://en.wikipedia.org/wiki/List_of_HTTP_header_fields</a><br>
+          <a href="https://developer.mozilla.org/docs/Web/HTTP/Headers">https://developer.mozilla.org/docs/Web/HTTP/Headers</a><br>
+          <a href="https://datatracker.ietf.org/doc/html/rfc2616">https://datatracker.ietf.org/doc/html/rfc2616</a><br>
+          <a href="https://datatracker.ietf.org/doc/html/rfc7231#section-5">RFC 7231 <em>Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content</em> > <em>5. Request Header Fields</em></a><br>
+          <a href="https://datatracker.ietf.org/doc/html/rfc7231#section-7">RFC 7231 <em>Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content</em> > <em>7. Response Header Fields</em></a><br>
+        </details>
+      </section>
+    </section>
+
+    <section>
+      <h1>Server system informations</h1>
+      <?php
+      date_default_timezone_set('UTC');
+      ?>
+      Architecture: <samp><?= htmlspecialchars(php_uname("m")) ?></samp><br>
+      Distribution: <samp><?php echo htmlspecialchars(shell_exec("/usr/bin/lsb_release -si")); ?></samp><br>
+      Distribution version: <samp><?php echo htmlspecialchars(shell_exec("/usr/bin/lsb_release -sr")); ?></samp><br>
+      Distribution version codename: <samp><?php echo htmlspecialchars(shell_exec("/usr/bin/lsb_release -sc")); ?></samp><br>
+      Distribution description: <samp><?php echo htmlspecialchars(shell_exec("/usr/bin/lsb_release -sd")); ?></samp><br>
+      Kernel: <samp><?= htmlspecialchars(php_uname("s")) ?></samp><br>
+      Kernel version: <samp><?= htmlspecialchars(php_uname("r")) ?></samp><br>
+      Nginx version: <samp><?= htmlspecialchars($_SERVER['NGINX_VERSION']) ?></samp><br>
+      PHP version: <samp><?= htmlspecialchars(phpversion()) ?></samp><br>
+      Connection ID since Nginx startup: <samp><?= htmlspecialchars($_SERVER['CONNECTION']) ?></samp><br>
+      Requests in this connection: <samp><?= htmlspecialchars($_SERVER['CONNECTION_REQUESTS']) ?></samp><br>
+      <?php
+      $time = explode(".", $_SERVER['REQUEST_TIME_FLOAT']);
+      ?>
+      Unix time: <samp title="Number of seconds since January 1 1970 00:00:00.0000 UTC"><?= htmlspecialchars($_SERVER['REQUEST_TIME_FLOAT']) ?></samp> (<span title="year-month-day hour:minute:second.decimal"><?= date("Y-m-d H:i:s", $time[0]) . "." .  $time[1] ?></span> UTC)<br>
+
+      <br>
+    </section>
+  </body>
+</html>