bayfrontmedia / php-cookies
Helper class to easily work with cookies.
Requires
- php: ^8.0
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Helper class to easily and safely work with cookies.
License
This project is open source and available under the MIT License.
Author
Requirements
- PHP
^8.0(Tested up to8.4)
Installation
composer require bayfrontmedia/php-cookies
Usage
get
Description:
Returns value of single $_COOKIE array key or entire array, with optional default value.
Parameters:
$key = NULL(string|null)$default = NULL(mixed): Default value to return if the array key is not found
Returns:
- (mixed)
Example:
use Bayfront\Cookies\Cookie;
print_r(Cookie::get());
has
Description:
Checks if $_COOKIE array key exists.
Parameters:
$key(string)
Returns:
- (bool)
Example:
use Bayfront\Cookies\Cookie;
if (Cookie::has('cart_id')) {
// Do something
}
set
Description:
Creates a cookie.
See: https://www.php.net/manual/en/function.setcookie.php
Parameters:
$name(string): Cookie name$value(string): Cookie value$minutes = 0(int): Minutes from now until the cookie expires$path = '/'(string): Path on the server in which the cookie will be available$domain = ''(string): Domain/subdomain that the cookie is available to$secure = true(bool): Transmit the cookie only over a secure https connection$http_only = true(bool): Accessible only through the http protocol$same_site = 'Lax'(string): Acceptable values ofNone,LaxorStrict
Returns:
- (bool)
Example:
use Bayfront\Cookies\Cookie;
Cookie::set('cart_id', 'abc123', 60);
forget
Description:
Removes validity of cookie.
Parameters:
$name(string)$path = '/'(string): Path on the server for the cookie to be removed$domain = ''(string): Same value that the cookie was set with$secure = true(bool): Same value that the cookie was set with$http_only = true(bool): Same value that the cookie was set with$same_site = 'Lax'(string): Same value that the cookie was set with. Acceptable values ofNone,LaxorStrict
Returns:
- (void)
Example:
use Bayfront\Cookies\Cookie;
Cookie::forget('cart_id');
forgetAll
Description:
Removes the validity of all cookies.
NOTE: This will not delete cookies set with custom path, domain, secure, http_only or same_site.
Parameters:
- None
Returns:
- (void)
Example:
use Bayfront\Cookies\Cookie;
Cookie::forgetAll();