Online Marketplace Payments
The design of this library was heavily influenced by Httpful.
Please use appropriately tagged github issues to request features or report bugs.
You can install using composer or from source. Note that Balanced is PSR-0 compliant:
If you don't have Composer install it:
$ curl -s https://getcomposer.org/installer | php
Add this to your composer.json:
{
"require": {
"balanced/balanced": "*"
}
}Refresh your dependencies:
$ php composer.phar updateThen make sure to require the autoloader and initialize all:
<?php
require(__DIR__ . '/vendor/autoload.php');
\Httpful\Bootstrap::init();
\RESTful\Bootstrap::init();
\Balanced\Bootstrap::init();
...Download Httpful source:
$ curl -s -L -o httpful.zip https://github.com/nategood/httpful/zipball/master;
$ unzip httpful.zip; mv nategood-httpful* httpful; rm httpful.zipDownload RESTful source:
$ curl -s -L -o restful.zip https://github.com/bninja/restful/zipball/master;
$ unzip restful.zip; mv bninja-restful* restful; rm restful.zipsDownload the Balanced source:
$ curl -s -L -o balanced.zip https://github.com/balanced/balanced-php/zipball/master
$ unzip balanced.zip; mv balanced-balanced-php-* balanced; rm balanced.zipAnd then require all bootstrap files:
<?php
require(__DIR__ . "/httpful/bootstrap.php")
require(__DIR__ . "/restful/bootstrap.php")
require(__DIR__ . "/balanced/bootstrap.php")
\Httpful\Bootstrap::init();
\RESTful\Bootstrap::init();
\Balanced\Bootstrap::init();
...curl -s http://getcomposer.org/installer | php
echo '
{
"require": {
"balanced/balanced": "*"
}
}
' > composer.json
php composer.phar install
curl https://raw.github.com/balanced/balanced-php/master/example/example.php > example.php
php example.php
curl https://raw.github.com/balanced/balanced-php/master/example/buyer-example.php > buyer-example.php
php -S 127.0.0.1:9321 buyer-example.php
# now open a browser and go to http://127.0.0.1:9321/ to view how to tokenize cards and add to a buyerSee https://www.balancedpayments.com/docs/overview?language=php for tutorials and documentation.
$ phpunit --bootstrap vendor/autoload.php tests/
Or if you'd like to skip network calls:
$ phpunit --exclude-group suite --bootstrap vendor/autoload.php tests/
- Ensure that all tests pass
- Increment minor
VERSIONinsrc/Balanced/Settingsandcomposer.json(git commit -am 'v{VERSION} release') - Tag it (
git tag -a v{VERSION} -m 'v{VERSION} release') - Push the tag (
git push --tag) - Packagist will see the new tag and take it from there
- Fork it
- Create your feature branch (
git checkout -b my-new-feature) - Write your code and tests
- Ensure all tests still pass (
phpunit --bootstrap vendor/autoload.php tests/) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create new pull request
Each scenario lives in the scenarios directory and is comprised of the following:
- definition.php - Method definition
- request.php - Scenario code
- executable.php - Processed request.php. Can be executed directly in PHP. Generated by render_scenarios.php.
- php.mako - Documentation template to be consumed by balanced-docs. Generated by - render_scenarios.php.
Scenarios can be validated by running validate_scenarios.php from within the scenarios folder.