X-Git-Url: https://git.m6w6.name/?p=m6w6%2Fext-pq;a=blobdiff_plain;f=README.md;h=8aa9c32c99558054d2658192ad161d22b0909a76;hp=e6aa78e86b95fb014406a8d2bc3b901074c2c4e6;hb=1e1d31873ad4283bd9acc3349107585f88161ea2;hpb=1e2615005272bb2347820bccb38c94b9caccafb8 diff --git a/README.md b/README.md index e6aa78e..8aa9c32 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # pecl/pq -[![Build Status](https://travis-ci.org/m6w6/ext-pq.svg?branch=phpng)](https://travis-ci.org/m6w6/ext-pq) +[![Build Status](https://travis-ci.org/m6w6/ext-pq.svg?branch=master)](https://travis-ci.org/m6w6/ext-pq) ## About: @@ -8,18 +8,36 @@ This is a modern binding to the mature [libpq](http://www.postgresql.org/docs/cu ### Highlights: -* 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). +* 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 + +### PHARext + +Watch out for [PECL replicates](https://replicator.pharext.org?pq) +and pharext packages attached to [releases](https://github.com/m6w6/ext-pq/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 +50,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 https://mdref.m6w6.name/pq +The list of past and current contributors is maintained in [THANKS](./THANKS).