Download the PHP package elliotwms/abacus without Composer
On this page you can find all versions of the php package elliotwms/abacus. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package abacus
Abacus
PHP currency manipulation package from the future. Still in very early development.
Usage
Once Abacus has been set up successfully, it can be used like so:
Installation
Install Abacus via Composer by either including it in your composer.json file:
Or by running:
Polling the API
Abacus depends on data retrieved from the Open Exchange Rates
API. In order to use Abacus fully, you must poll the API using your own API key. Abacus will look
for an environment variable named ABACUS_OPEN_EXCHANGE_KEY and can be polled in several ways.
I recommend setting up a CRON service to poll the Open Exchange hourly in order to keep an up to date record of the currency exchange rates. At the time of writing, the free tier of the Open Exchange Rates API allows for 1,000 calls per month and there are 744 hours in a month so you're sorted. It would be fruitless to poll more than once an hour on the free tier as the information is updated hourly.
If you want more up-to-the-minute exchange rates, I highly recommend signing up for a paid plan
Using the included script
Abacus includes a shell script to minimize the setup process.
You can call it like so (with absolute filepaths for your CRON service) from the root of your project directory:
php vendor/bin/abacusBy default it will use the ABACUS_OPEN_EXCHANGE_KEY environment variable, but if you need to
specify it manually you can pass it as an argument:
php vendor/bin/abacus my_super_secret_api_keyDoing it manually
Abacus will also accept an API key directly:
Contributing
Abacus uses test driven development, which means that in order to write a feature, you need to write a test for that feature. You're going to need to do a few things to get this up and running:
-
Install the development dependencies with
composer install -
Set your
ABACUS_OPEN_EXCHANGE_KEYas an environment variable. You can do this in a bash shell with: -
Poll the service with PHP to seed the exchange data:
You should see something similar to the following:
- Run PHPUnit. If something didn't pass then you may have not set up your exchange data correctly.
From here you can write tests and run PHPUnit to test them, and off you go!
