X-Git-Url: https://git.m6w6.name/?p=m6w6%2Fext-pq;a=blobdiff_plain;f=README.md;h=58d8cb833e3138fe8ff08b4a43c8fbee5cadd9cb;hp=cb4d725acbb132d2f774c84aff81f5862ead2471;hb=25e7c9331c023ef1ca869b2f1c8433251bc8f359;hpb=8056f4e71952a5c0f0ef0e81b7b21a0c09878947 diff --git a/README.md b/README.md index cb4d725..58d8cb8 100644 --- a/README.md +++ b/README.md @@ -8,18 +8,39 @@ This is a modern binding to the mature [libpq](http://www.postgresql.org/docs/cu ### Highlights: -* Nearly 100% support for [asynchronous usage](http://devel-m6w6.rhcloud.com/mdref/pq/Connection/: Asynchronous Usage). -* Extended [type support by pg_type](http://devel-m6w6.rhcloud.com/mdref/pq/Types/: Overview). -* Fetching simple [multi-dimensional array maps](http://devel-m6w6.rhcloud.com/mdref/pq/Result/map). +* Nearly 100% support for [asynchronous usage](https://mdref.m6w6.name/pq/Connection/:+Asynchronous+Usage). +* Extended [type support by pg_type](https://mdref.m6w6.name/pq/Types/:+Overview). +* Fetching simple [multi-dimensional array maps](https://mdref.m6w6.name/pq/Result/map). * Working [Gateway implementation](https://github.com/m6w6/pq-gateway). -## Installation: +## Documentation -This extension is hosted at [PECL](http://pecl.php.net) and can be installed with [PEAR](http://pear.php.net)'s pecl command: +See the [online markdown reference](https://mdref.m6w6.name/pq). - # pecl install pq +Known issues are listed in [BUGS](./BUGS) and future ideas can be found in [TODO](./TODO). -Also, watch out for self-installing [pharext](https://github.com/m6w6/pharext) packages attached to [releases](https://github.com/m6w6/ext-pq/releases). +## Installing + +### PECL + + pecl install pq + +Watch out for [PECL replicates](https://replicator.pharext.org?pq) +and pharext packages attached to [releases](./releases). + +### PHARext + +Watch out for [PECL replicates](https://replicator.pharext.org?pq) +and pharext packages attached to [releases](./releases). + +### Checkout + + git clone github.com:m6w6/ext-pq + cd ext-pq + /path/to/phpize + ./configure --with-php-config=/path/to/php-config + make + sudo make install ## Dependencies: @@ -32,7 +53,19 @@ It optionally depends on the following extensions: * [json](http://php.net/json) +## ChangeLog + +A comprehensive list of changes can be obtained from the +[PECL website](https://pecl.php.net/package-changelog.php?package=pq). + +## License + +ext-pq is licensed under the 2-Clause-BSD license, which can be found in +the accompanying [LICENSE](./LICENSE) file. + +## Contributing -## Documentation: +All forms of contribution are welcome! Please see the bundled +[CONTRIBUTING](./CONTRIBUTING.md) note for the general principles followed. -Documentation is available at http://devel-m6w6.rhcloud.com/mdref/pq/ +The list of past and current contributors is maintained in [THANKS](./THANKS).