Download the PHP package grantholle/laravel-timezone without Composer
On this page you can find all versions of the php package grantholle/laravel-timezone. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download grantholle/laravel-timezone
More information about grantholle/laravel-timezone
Files in grantholle/laravel-timezone
Package laravel-timezone
Short Description User timezone helpers for Laravel.
License MIT
Homepage https://github.com/grantholle/laravel-timezone
Informations about the package laravel-timezone
Laravel Timezone
This package detects and sets a user's timezone and provides some helpers to convert dates into a user's timezone.
Installation
You can install the package via composer:
You can publish and run the migrations with:
Note If you use multiple models that authenticate, you will want to add a column to each of them.
You can publish the config file with:
Usage
The package will automatically set a timezone
property to the user logging in to the app. If the overwite
option is set in the timezone
config, it will check each time the user logs in. Under the hood, this package relies on the stevebauman/location package to detect where the user is based on IP address and the appropriate timezone. Under its hood, it's relying on Laravel's request()->ip()
function, which relies on Symfony's Request
object to detect IP addresses. If you're experiencing issues of detecting the wrong timezones and therefore wrong IP address, it's likely due to trusted proxy configuration issues. Check out that documentation for more details.
You can change which events the timezone is set or opt out of this feature by changing the config's events
option.
To ignore this feature, set events
to be empty.
Aside from timezone detection, you can use several helpers around dates for the authenticated user.
Suggested configuration
The functions that return date objects return CarbonImmutable objects. To save yourself a lot of headaches, you should use them in your application, too.
In your AppServiceProvider
's boot function,
Cheatsheet
Below is a set of examples using the facade and available helper functions.
Testing
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
- Grant Holle
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of laravel-timezone with dependencies
ext-intl Version *
illuminate/contracts Version ^9.0|^10.0|^11.0|^12.0
illuminate/support Version ^9.0|^10.0|^11.0|^12.0
spatie/laravel-package-tools Version ^1.14.0
stevebauman/location Version ^7.0