functions.php

<?php
/*
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at https://mozilla.org/MPL/2.0/.
 */
/**
 * Italix Session - Helper Functions
 *
 * @package Italix\Session
 * @license MPL-2.0
 */

declare(strict_types=1);

namespace Italix\Session;

/**
 * Describe the cookie the identifier travels in.
 *
 *     cookie_spec('__Host-session')
 *         ->secure()->http_only()->same_site('Strict')->path('/');
 *
 * Defaults are the safe ones — `HttpOnly` on, `SameSite=Lax`, a session cookie
 * rather than a persistent one — because the measurement that produced this
 * library was a production application running on PHP's defaults, where every
 * one of those was off and nobody had noticed.
 */
function cookie_spec(string $name_c): CookieSpec
{
    return new CookieSpec($name_c);
}

/**
 * Describe how long a session lives, in the three senses that differ.
 *
 *     session_policy()->idle_ttl(600)->absolute_ttl(28800);
 *
 * For applications with a container, prefer registering the policy as a service
 * and injecting it — this helper is for scripts, tests and configuration files,
 * where wiring a container would be more ceremony than the job deserves.
 */
function session_policy(): SessionPolicy
{
    return new SessionPolicy();
}