Download the PHP package codeheures/laravel-utils without Composer

laravel-utils

Laravel-utils is a toolbox that allow:

• API to get geolocation informations of client by ip. Usable for server-side processing
• PHP tool to get a valid public IP (useful on a devel environment)
• PHP tool to get browser infos
• PHP tool to get database enum list, or get count items with a reusable mutiple where (=) clause
• Middleware to to share config('runtime.ip') variable (base on PHP tool to get valid public IP)
• Middleware to obtain automatically the best locale for your client and share it on your application by a config('runtime.locale') variable. You can use {lang} for route param to force set locale
• Middleware to obtain automatically the best currency for your client and share it on your application by a config('runtime.currency') variable

API: Geolocation Informations by Ip

This API allow you to serve geolocation infos to client (useful for xhtmlrequests). \ You can also use static function for a server side processing.

Get complete informations

with Ip on URL without Ip : try first to use your public Ip. If not public, try to use config('codeheuresUtils.ipTest'). If not available Ip finally use a static IP

Get only LOC [latitutde, longitude] informations

With or without IP on url (see above)

Get only Country informations

With or without IP on url (see above)

If error

`

PHP Tool: Geolocation Informations by Ip

You can use statics class for a side-server processing

PHP Tool: Get valid public IP

with only request: return your IP if public or the static class var Ip with a second param: return your IP if public, or param if public IP, or finally the static class var Ip

PHP Tool: Get the Browser Name

PHP Tool: Get Database Infos

get list of enum values for a column of a table

Example: get the enum values of the currencies column of the priceTable

get easy count elem on a table with multiple count where

The where clauses is a equal clauses

PHP Tool: Locale Tools

Locale Tools allow you to obtain various information of locales. This suite of tools is used in a powerful middleware to find the best locale adapted to the user. When the middleware find the best locale, this is shared in a config('runtime.locale') variable accessible throughout the application. You can use it to translate your application for the user.

Array of locales availables on the server

without restriction of availables languages (find in codeheuresUtils.availableLocales config file): with restriction:

Boolean test if a locale is an available locale

Test if a locale is an valid locale and return locale or null

Get the first possible locale by a country code

Compose a locale and return if exist, null if don't exist

Get default Locale within env('DEFAULT_LOCALE') or static var $last_fall_locale

PHP Tool: Currencies Tools

Currencies Tools allow you to obtain various information of currencies. It use MoneyPhp and config('runtime.locale') This suite of tools is used in a powerful middleware to find the best currency adapted to the user. When the middleware find the best currency, this is shared in a config('runtime.currency') variable accessible throughout the application. You can use it to manage prices in your application.

Test if a currency exist

Get subunit of a currency (if exist else return 0)

Get list of currencies with symbol according to a locale

Get symbol by currency code and locale

Get default money by a compose local (the second param is a fallback currency)

Get default Currency within env('DEFAULT_CURRENCY') or static var $last_fall_currency

Middleware: config('runtime.ip'), config('runtime.locale') & config('runtime.currency')

Installation of middlawares allow you to use config('runtime.ip'), config('runtime.locale') & config('runtime.currency') all over the application controllers ans views.

config('runtime.locale') & config('runtime.currency') can be saved and read in User attribute 'locale' & 'currency'

``

Installation

• Add laravel-utils to your composer.json file to require laravel-utils :

• Update Composer :

• add the service provider to config/app.php :

• add middlewares to web routes in app/Http/kernel.php (respect order IP->Locale->Currency). Middleware SetLocaleByRuntime is optionnal and allow you to set your app locale automatically base on the detect best locale.:

• Publish the config file config/codeheuresUtils.php:

In config file you can change

• routes uri,
• routes names
• routes middlwares (Add a admin type middleware to refreshDb is highly advised)
• value of Ip test
• list of availables locales

Optionnal: add "locale" and/or "currency" attribute to User to manage saving preferences locale in your app

Before first use we update maxmind db

Congratulations, you have successfully installed laravel-utils !

Copyright and Licence

This product includes GeoLite2 data created by MaxMind, available from http://www.maxmind.com.

This product use GeoIp2 on apache2 Licence https://github.com/maxmind/GeoIP2-php.

This product use Moneyphp on MIT Licence https://github.com/moneyphp/money.

This software is provided "as is" without warranty of any kind, either express or implied, regarding the software package, its merchantability, or its fitness for any particular purpose.

This is free software, licensed under the Apache License, Version 2.0.