Skip to content

Commit 3500281

Browse files
committed
Added README file (NEXWAY-1)
1 parent c180f78 commit 3500281

File tree

1 file changed

+33
-0
lines changed

1 file changed

+33
-0
lines changed

README.md

+33
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
# Nexway API implementation in PHP (by Shahriyar Imanov at Audith Softworks) #
2+
3+
This library implements Nexway's WSDL/SOAP powered API interface, using PHP's OOP facilities.
4+
5+
6+
## What is this repository for? ##
7+
8+
* Before being able to use this library, you need working Test configuration access token to [Nexway](http://www.nexway.com) WebServices interface. For production environment, you will need the Live configuration token as well.
9+
* Once Nexway's access tokens have been acquired, enter them in ```/src/Audith/Providers/Nexway/config.ini``` file, in appropriate sections.
10+
* Check out Unit-tests in ```/unit-tests``` folder for use-cases.
11+
12+
13+
## How to run Unit-tests? ##
14+
15+
Composer configuration file includes ```phpunit/phpunit``` package for development purposes. Once ```composer install``` has been executed, PHPUnit library files will be fetched.
16+
17+
Run following command to execute unit-tests: ```./vendor/phpunit/phpunit/phpunit --verbose --colors --strict --debug unit-tests/```
18+
19+
20+
## How to build Documentation using PHPDocumentor? ##
21+
22+
Again, as in the case of PHPUnit, we also have included PHPDocumentor in Composer configuration file. Once libraries are installed, run following command to build Documentation:
23+
24+
```./vendor/phpdocumentor/phpdocumentor/bin/phpdoc.php -d ./src```
25+
26+
Although data-layer of source-code isn't well-documented (i.e. PhpDoc summaries are missing, which are totally not necessary), the *Class Hierarchy Diagram* can prove useful.
27+
28+
**Note:** Please make sure you have PHP's ```xsl``` extension installed. It's required for PHPDocumentor libraries. If you don't want PHPDocumentor included with your installation, please remove it from ```composer.json``` file's ```require-dev``` list, before running ```composer install```.
29+
30+
31+
## Where to report bugs? ##
32+
33+
Use our [JIRA](https://audith.atlassian.net/browse/NEXWAY) instance to report possible bugs.

0 commit comments

Comments
 (0)