balanced/balanced

Client for Balanced API

Saturday, January 10, 2015
by aipp
Repository
11 Watchers
72 Stars
298,587 Installations

PHP
2 Dependents
0 Suggesters
38 Forks
7 Open issues
31 Versions
1 % Grown

The README.md

Balanced

Online Marketplace Payments, _(*1)

, _(*2)

The design of this library was heavily influenced by Httpful., _(*3)

v1.x requires Balanced API 1.1. Use v0.x for Balanced API 1.0., _(*4)

v0.x requires Balanced API 1.0., _(*5)

ATTN COMPOSER USERS

In the past this README incorrectly communicated specifying * for the version of balanced. master, 1.x, requires Balanced API v1.1 and will require updates to your application. Applications using * to specify the balanced version obtained via Composer will automatically pick up the latest version and will cause issues for applications that have not been updated to use balanced-php 1.x. If your application is configured in the manner, we advise you to pin your balanced version at 0.*, or something more specific such as 0.7.5.0, to ensure your application continues to function normally using Balanced API v1.0 until you're able to upgrade to the latest version., _(*6)

Requirements

PHP >= 5.3 with cURL
RESTful >= 1.0.x
Httpful >= 0.2.x

Issues

Please use appropriately tagged github issues to request features or report bugs., _(*7)

Installation

You can install using composer or from source. Note that Balanced is PSR-0 compliant:, _(*8)

Composer

If you don't have Composer install it:, _(*9)

$ curl -s https://getcomposer.org/installer | php

Require balanced in your composer.json:, _(*10)

{
    "require": {
        "balanced/balanced": "1.*"
    }
}

NOTE: You may also define a more specific version if desired, e.g. 1.0.1, _(*11)

Refresh your dependencies:, _(*12)

$ php composer.phar update

Then make sure to require the autoloader and initialize all:, _(*13)

<?php
require(__DIR__ . '/vendor/autoload.php');

\Httpful\Bootstrap::init();
\RESTful\Bootstrap::init();
\Balanced\Bootstrap::init();
...

Source

Download Httpful source:, _(*14)

$ curl -s -L -o httpful.zip https://github.com/nategood/httpful/zipball/v0.2.3;
$ unzip httpful.zip; mv nategood-httpful* httpful; rm httpful.zip

Download RESTful source:, _(*15)

$ curl -s -L -o restful.zip https://github.com/matthewfl/restful/zipball/master;
$ unzip restful.zip; mv matthewfl-restful* restful; rm restful.zip

Download the Balanced source:, _(*16)

$ curl -s -L -o balanced.zip https://github.com/balanced/balanced-php/zipball/master
$ unzip balanced.zip; mv balanced-balanced-php-* balanced; rm balanced.zip

And then require all bootstrap files:, _(*17)

<?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();
...

Quickstart

Refer to the Quickstart guide in the Balanced Documentation., _(*18)

Usage

See https://docs.balancedpayments.com/overview?language=php for guides and documentation., _(*19)

Testing

$ phpunit --bootstrap vendor/autoload.php tests/

Or if you'd like to skip network calls:, _(*20)

$ phpunit --exclude-group suite --bootstrap vendor/autoload.php tests/

Publishing

Ensure that all tests pass
Increment minor VERSION in src/Balanced/Settings and composer.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

Contributing

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

Documentation scenarios

Each scenario lives in the scenarios directory and is comprised of the following:, _(*21)

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., _(*22)

Contributors

The Versions

10/01 2015

dev-master

9999999-dev http://github.com/balanced/balanced-php

Client for Balanced API

library balanced

Client for Balanced API

balanced/balanced

The README.md

Balanced

ATTN COMPOSER USERS

Requirements

Issues

Installation

Composer

Source

Quickstart

Usage

Testing

Publishing

Contributing

Documentation scenarios

Contributors

The Versions

dev-master

The Requires

The Development Requires

by Balanced

dev-fix_scenarios

The Requires

The Development Requires

by Balanced

1.3.0

The Requires

The Development Requires

by Balanced

dev-orders-all-the-things

The Requires

The Development Requires

by Balanced

dev-snippets

The Requires

The Development Requires

by Balanced

1.2.0

The Requires

The Development Requires

by Balanced

1.1.2

The Requires

The Development Requires

by Balanced

1.1.0

The Requires

The Development Requires

by Balanced

1.0.1

The Requires

The Development Requires

by Balanced

1.0

The Requires

The Development Requires

by Balanced

dev-rev1

The Requires

The Development Requires

by Balanced

dev-rev0

The Requires

The Development Requires

by Balanced

0.7.5.0

The Requires

The Development Requires

by Balanced

0.7.4.1

The Requires

The Development Requires

by Balanced

0.7.4

The Requires

The Development Requires

by Balanced

0.7.3.1