Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/getdnsapi/getdns-php-bindings

A PHP language binding for the getdns API
https://github.com/getdnsapi/getdns-php-bindings

Last synced: about 2 months ago
JSON representation

A PHP language binding for the getdns API

Awesome Lists containing this project

README

        

getdns-php
==========

A PHP language binding for the getdns API, version 0.11.0.
This implementation is licensed under the New BSD License (BSD-new).

NOTE: THIS IS A BETA RELEASE!

Dependencies:

* PHP 5.x (PHP 5.6.8 was used for development and testing)
* libgetdns 0.9.*
* getdns library header files

The configure script will confirm that the dependencies have been met,
but it will not check version numbers.

To build:

$ phpize
$ ./configure --enable-getdns
$ make
$ sudo make install

To clean:

$ make clean
$ phpize --clean

Note that the following getdns library functions are not
implemented in this extension:

* getdns_context_create_with_memory_functions()
* getdns_context_create_with_extended_memory_functions()
* getdns_context_set_eventloop()
* getdns_context_set_memory_functions()
* getdns_context_set_extended_memory_functions()
* getdns_dict_create_with_memory_functions()
* getdns_dict_create_with_extended_memory_functions()
* getdns_list_create_with_memory_functions()
* getdns_list_create_with_extended_memory_functions()
* getdns_pretty_snprint_dict()
* getdns_pretty_snprint_list()
* getdns_snprint_json_dict()
* getdns_snprint_json_list()

Each makes assumptions about memory management functions
that aren't directly applicable to PHP.

## Documentation

Documentation is written in the DocBook format preferred
by the PHP community. XML input files can be found in the
doc-in directory.

Documentation intended for human consumption is provided in
HTML format and can be found in the doc-out directory. The
documentation root can be found at
doc-out/php-chunked-xhtml/index.html.

## Regression Tests

A suite of regression tests (written in
[phpt](http://qa.php.net/write-test.php) format) is included
with the extension. Test cases can be found in the tests
directory. All of the tests can be executing by running
"make test" after building the extension as described
above. The test cases are written to validate positive
code paths that produce successful results.

## To Do

* Testing of error code paths.
* Fix bugs as they are uncovered by testing.