Download the PHP package bag2/cookie without Composer
On this page you can find all versions of the php package bag2/cookie. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package cookie
Short Description Cookie functions over PSR-7 and setcookie() function.
License Apache-2.0
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 cookie
Bag2\Cookie
Installation
Motivation
We have some problems with HTTP Set-Cookie response header in PHP.
- PHP's
setcookie()function started supporting 'SameSite' cookie attribute from 7.3.0 - Sending
SameSitecookies under PHP 7.3.0 requires an unusual hack - PSR-7 does not provide high-level functions for Cookies
- The
setcookie()function is useless for the era of PSR-7
This package provides common features whether your project is PSR-7 based or vanilla PHP (direct call to setcookie() function).
Examples
Create Cookie Oven
Oven is an object that can hold multiple Set-Cookie entries. Use CookieOvenBuilder to create an Oven object. The value specified in the constructor or the "with" method builds the default value for the option added to the Set-Cookie.
Oven manages cookies by key-value. Please note that CookieOven can only have one cookie with the same name.
$default_options passed to the Oven constructor is combined with $option passed to the CookieOven::add() method.
The $options received in the 3rd argument is compatible with setcookie() function added in PHP 7.3. Pleese see PHP: setcookie - Manual. All option names are lowercase.
PSR-7
PSR-7 is a HTTP message interfaces defined by PHP-FIG.
PSR-7 HTTP message objects are immutable. If you are writing code on a PSR-7 compatible framework, you will probably just return this value.
Tips for unit testing: Oven::appendTo() and Oven::setTo() receive unixtime of the current time for SetCookie::compileHeaderLine(). The reason is that the current time affects the cookie output. The argument is optional, but if you want strict output value validation, inject the time externally.
PHP setcookie() wrapper
If your project allows you to call the setcookie(), header() functions directly, it is a kind of vanilla PHP.
Inside this function, the Emitter for the PHP version is selected, and the setcookie() function that matches the version specification is called.
Legacy style setcookie()
If you don't like the new style of setcookie() with associative arrays, use Bag2\Cookie\setcookie().
Copyright
This package is licenced under Apache License 2.0.
Copyright 2020 Baguette HQ
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
