Download the PHP package tbbc/money-bundle without Composer

On this page you can find all versions of the php package tbbc/money-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

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 PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • 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.
Please rate this library. Is it a good library?

Informations about the package money-bundle

TbbcMoneyBundle

Build Status PHP Symfony Downloads Latest Stable Version license

SensioLabsInsight

This bundle is used to integrate the Money library into a Symfony project.

This library is based on Fowler's Money pattern

Quick Start

Features

Table of contents

Installation

Use Composer and install with

Add the bundle to config/bundles.php (if it was not automatically added during the installation of the package):

Create a file like config/packages/tbbc_money.yml and add it there:

In your config.yml or config/packages/tbbc_money.yml, add the form fields presentations:

You should also register custom Doctrine Money type:

Usage

Money Library integration

Form integration

You have 3 new form types (under Tbbc\MoneyBundle\Form\Type namespace):

Example :

Manipulating the form

With MoneyType you can manipulate the form elements with

amount_options for the amount field, and currency_options for the currency field, fx if you want to change the label.

With CurrencyType only currency_options can be used, and with SimpleMoneyType only amount_options can be used.

Saving Money with Doctrine

Solution 1 : two fields in the database

Note that there are 2 columns in the DB table : $priceAmount and $priceCurrency and only one getter/setter : getPrice and setPrice.

The get/setPrice methods are dealing with these two columns transparently.

Solution 2 : use Doctrine type

There is only one string column in your DB table. The money object is manually serialized by the new Doctrine type.

1.25€ is serialized in your DB by 'EUR 125'. This format is stable. It won't change in future releases..

The new Doctrine type name is "money".

Conversion manager

Convert an amount into another currency

Save a conversion value in a DB

Money formatter

Twig integration

Fetching ratio values from remote provider

Change the ratio provider

The ratio provider by default is base on the service tbbc_money.ratio_provider.ecb.

You can write your own ratio provider by creating and custom class that implements the RatioProviderInterface interface.

You can change the service to use in the config/packages/tbbc_money.yaml file :

Additional rate providers from Exchanger

This project integrates https://github.com/florianv/exchanger library to work with currency exchange rates from various services.

Installation:

Configuration:

First, you need to add services you would like to use into your services.yml file, e.g:

Second, you need to update ratio provider used by MoneyBundle on your config.yml file:

Recommended:

Some providers focus on a limited set of currencies, but give better data. You can use several rate providers seamlessly on your project by bundling them into the chain. If some provider does not support certain currency, next provider in the chain would be attempted.

Example of chained providers:

As you can see here 4 providers would be attempted one after another until conversion rate is found. Check this page for a fill list of supported services and their configurations: https://github.com/florianv/exchanger/blob/master/doc/readme.md#supported-services

And then you need to assign rate provider on your config.yml file:

Create your own ratio provider

A ratio provider is a service that implements the Tbbc\MoneyBundle\Pair\RatioProviderInterface. I recommend that you read the PHP doc of the interface to understand how to implement a new ratio provider.

The new ratio provider has to be registered as a service.

To use the new ratio provider, you should set the service to use in the config.yml by giving the service name.

automatic currency ratio fetch

Add to your crontab :

MoneyManager : create a money object from a float

Create a money object from a float can be a bit tricky because of rounding issues.

history of currency ratio with the pairHistoryManager

Doctrine is required to use this feature.

In order to get the ratio history, you have to enable it in the configuration and to use Doctrine.

Then you can use the service :

RatioStorage

Three storages for storing ratios are available : CSV File (csv), Doctrine ORM (doctrine), or MongoDB (document)

By default, TbbcMoneyBundle is configured with CSV File.

If you want to switch to a Doctrine storage, edit your config.yml

Update your database schema:

If you're using DoctrineMigrationsBundle (recommended way):

Without DoctrineMigrationsBundle:

With the Doctrine storage, currency ratio will use the default entity manager and will store data inside the tbbc_money_doctrine_storage_ratios

Custom NumberFormatter in MoneyFormatter

The MoneyFormatter::localizedFormatMoney ( service 'tbbc_money.formatter.money_formatter' ) use the php NumberFormatter class ( http://www.php.net/manual/en/numberformatter.formatcurrency.php ) to format money.

You can :

Using the TbbcMoneyBundle without Doctrine ORM or MongoDB

You have to disable the pair history service in order to use the TbbcMoneyBundle without Doctrine ORM or MongoDB.

Note : you can imagine to code your own PairHistoryManager for Propel, it is very easy to do. Don't hesitate to submit a PR with your code and your tests.

Optimizations

In your config.yml, you can :

Contributing

  1. Take a look at the list of issues.
  2. Fork
  3. Write a test (for either new feature or bug)
  4. Optional: Start MongoDB in Docker for local testing

  5. Make a PR

Authors

Philippe Le Van - kitpages.fr - twitter : @plv
Thomas Tourlourat - Wozbe - twitter: @armetiz

Status

Stable

what is functional:


All versions of money-bundle with dependencies

PHP Build Version
Package Version
Requires php Version ^8.0
ext-curl Version *
ext-intl Version *
ext-simplexml Version *
moneyphp/money Version ^3.0|^4.0
symfony/form Version ^5.4|^6.0|^7.0
symfony/twig-bundle Version ^5.4|^6.0|^7.0
symfony/console Version ^5.4|^6.0|^7.0
symfony/dom-crawler Version ^5.4|^6.0|^7.0
symfony/event-dispatcher Version ^5.4|^6.0|^7.0
symfony/templating Version ^5.4|^6.0|^7.0
symfony/http-client Version ^5.4|^6.0|^7.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package tbbc/money-bundle contains the following files

Loading the files please wait ....