X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;ds=inline;f=README.md;fp=README.md;h=fbf1db500d8a85dbe655053d1f7daef276b50ffa;hb=c4160f5b4aa1f891529790b9d6011039c96e24c2;hp=0000000000000000000000000000000000000000;hpb=0272ce4a9b54b22f3f39e3b8dd2043ade3f3b697;p=awesomized%2Fext-ion

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fbf1db5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,45 @@
+# ext-ion
+
+PHP extension wrapping [amzn/ion-c](https://github.com/amzn/ion-c).
+See the [Amazon ION specification](https://amzn.github.io/ion-docs/).
+
+## License
+[BSD-2-Clause](https://github.com/awesomized/ext-ion/blob/master/LICENSE);
+see [spdx.org](https://spdx.org/licenses/BSD-2-Clause.html).
+
+## Install
+### Dependencies
+#### Required
+* PHP-8.1
+  * ext/date (standard)
+  * ext/spl (standard)
+#### Optional
+* [amzn/ion-c](https://github.com/amzn/ion-c) (bundled as git submodule)
+
+### Trinity
+```shell
+phpize
+./configure
+make # -j$(nproc)
+sudo make install # INSTALL=install
+```
+### Try with Docker
+```shell
+docker build -t php-ion
+docker run --rm php-ion -r 'echo ion\serialize(ion\Symbol\Table\PHP());'
+```
+### PECL
+> WIP
+### PHARext
+> WIP
+
+## IDE Stub
+See [ion.stub.php](https://github.com/awesomized/ext-ion/blob/master/ion.stub.php).
+
+## Known Issues
+Due to private internal state of ion-c's readers and writers,
+instances of the following PHP classes cannot be cloned:
+* ion\Reader\Reader
+* ion\Writer\Writer
+* ion\Serializer\PHP
+* ion\Unserializer\PHP