aboutsummaryrefslogtreecommitdiffstats
path: root/vendor/sabre/http/lib/Auth/AbstractAuth.php
blob: 07f451bc098d57b41d4f9b07a3d10ae9f246066f (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
<?php

declare(strict_types=1);

namespace Sabre\HTTP\Auth;

use Sabre\HTTP\RequestInterface;
use Sabre\HTTP\ResponseInterface;

/**
 * HTTP Authentication base class.
 *
 * This class provides some common functionality for the various base classes.
 *
 * @copyright Copyright (C) fruux GmbH (https://fruux.com/)
 * @author Evert Pot (http://evertpot.com/)
 * @license http://sabre.io/license/ Modified BSD License
 */
abstract class AbstractAuth
{
    /**
     * Authentication realm.
     *
     * @var string
     */
    protected $realm;

    /**
     * Request object.
     *
     * @var RequestInterface
     */
    protected $request;

    /**
     * Response object.
     *
     * @var ResponseInterface
     */
    protected $response;

    /**
     * Creates the object.
     */
    public function __construct(string $realm, RequestInterface $request, ResponseInterface $response)
    {
        $this->realm = $realm;
        $this->request = $request;
        $this->response = $response;
    }

    /**
     * This method sends the needed HTTP header and status code (401) to force
     * the user to login.
     */
    abstract public function requireLogin();

    /**
     * Returns the HTTP realm.
     */
    public function getRealm(): string
    {
        return $this->realm;
    }
}