Code Coverage
 
Lines
Functions and Methods
Classes and Traits
Total
75.86% covered (warning)
75.86%
44 / 58
41.67% covered (danger)
41.67%
5 / 12
 CRAP
0.00% covered (danger)
0.00%
0 / 1
FauxResponse
75.86% covered (warning)
75.86%
44 / 58
41.67% covered (danger)
41.67%
5 / 12
 30.44
0.00% covered (danger)
0.00%
0 / 1
 header
63.64% covered (warning)
63.64%
7 / 11
0.00% covered (danger)
0.00%
0 / 1
 7.73
 statusHeader
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
 2
 headersSent
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
 2
 getHeader
100.00% covered (success)
100.00%
2 / 2
100.00% covered (success)
100.00%
1 / 1
 1
 getStatusCode
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
 1
 getCookieConfig
0.00% covered (danger)
0.00%
0 / 3
0.00% covered (danger)
0.00%
0 / 1
 6
 setCookieConfig
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
 2
 setCookie
90.62% covered (success)
90.62%
29 / 32
0.00% covered (danger)
0.00%
0 / 1
 5.02
 getCookie
100.00% covered (success)
100.00%
3 / 3
100.00% covered (success)
100.00%
1 / 1
 2
 getCookieData
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
 1
 getCookies
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
 1
 hasCookies
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
 2
1<?php
2
3/**
4 * Classes used to send headers and cookies back to the user
5 *
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License along
17 * with this program; if not, write to the Free Software Foundation, Inc.,
18 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
19 * http://www.gnu.org/copyleft/gpl.html
20 *
21 * @file
22 */
23
24namespace MediaWiki\Request;
25
26use MediaWiki\Config\Config;
27use MediaWiki\MainConfigNames;
28use MediaWiki\MediaWikiServices;
29
30/**
31 * @ingroup HTTP
32 */
33class FauxResponse extends WebResponse {
34    /** @var null|string[] */
35    private $headers;
36    /** @var array[] */
37    private $cookies = [];
38    /** @var int|null */
39    private $code;
40
41    /** @var ?Config */
42    private $cookieConfig = null;
43
44    /**
45     * Stores a HTTP header
46     * @param string $string Header to output
47     * @param bool $replace Replace current similar header
48     * @param null|int $http_response_code Forces the HTTP response code to the specified value.
49     */
50    public function header( $string, $replace = true, $http_response_code = null ) {
51        if ( $this->disableForPostSend ) {
52            return;
53        }
54
55        if ( str_starts_with( $string, 'HTTP/' ) ) {
56            $parts = explode( ' ', $string, 3 );
57            $this->code = intval( $parts[1] );
58        } else {
59            [ $key, $val ] = array_map( 'trim', explode( ":", $string, 2 ) );
60
61            $key = strtoupper( $key );
62
63            if ( $replace || !isset( $this->headers[$key] ) ) {
64                $this->headers[$key] = $val;
65            }
66        }
67
68        if ( $http_response_code ) {
69            $this->code = intval( $http_response_code );
70        }
71    }
72
73    /**
74     * @since 1.26
75     * @param int $code Status code
76     */
77    public function statusHeader( $code ) {
78        $this->code = intval( $code );
79    }
80
81    public function headersSent() {
82        return false;
83    }
84
85    /**
86     * @param string $key The name of the header to get (case insensitive).
87     * @return string|null The header value (if set); null otherwise.
88     */
89    public function getHeader( $key ) {
90        $key = strtoupper( $key );
91
92        return $this->headers[$key] ?? null;
93    }
94
95    /**
96     * Get the HTTP response code, null if not set
97     *
98     * @return int|null
99     */
100    public function getStatusCode() {
101        return $this->code;
102    }
103
104    private function getCookieConfig(): Config {
105        if ( !$this->cookieConfig ) {
106            $this->cookieConfig = MediaWikiServices::getInstance()->getMainConfig();
107        }
108        return $this->cookieConfig;
109    }
110
111    public function setCookieConfig( Config $cookieConfig ): void {
112        $this->cookieConfig = $cookieConfig;
113    }
114
115    /**
116     * @param string $name The name of the cookie.
117     * @param string $value The value to be stored in the cookie.
118     * @param int|null $expire Ignored in this faux subclass.
119     * @param array $options Ignored in this faux subclass.
120     */
121    public function setCookie( $name, $value, $expire = 0, $options = [] ) {
122        if ( $this->disableForPostSend ) {
123            return;
124        }
125
126        $cookieConfig = $this->getCookieConfig();
127        $cookiePath = $cookieConfig->get( MainConfigNames::CookiePath );
128        $cookiePrefix = $cookieConfig->get( MainConfigNames::CookiePrefix );
129        $cookieDomain = $cookieConfig->get( MainConfigNames::CookieDomain );
130        $cookieSecure = $cookieConfig->get( MainConfigNames::CookieSecure );
131        $cookieExpiration = $cookieConfig->get( MainConfigNames::CookieExpiration );
132        $cookieHttpOnly = $cookieConfig->get( MainConfigNames::CookieHttpOnly );
133        $options = array_filter( $options, static function ( $a ) {
134            return $a !== null;
135        } ) + [
136            'prefix' => $cookiePrefix,
137            'domain' => $cookieDomain,
138            'path' => $cookiePath,
139            'secure' => $cookieSecure,
140            'httpOnly' => $cookieHttpOnly,
141            'raw' => false,
142        ];
143
144        if ( $expire === null ) {
145            $expire = 0; // Session cookie
146        } elseif ( $expire == 0 && $cookieExpiration != 0 ) {
147            $expire = time() + $cookieExpiration;
148        }
149
150        $this->cookies[$options['prefix'] . $name] = [
151            'value' => (string)$value,
152            'expire' => (int)$expire,
153            'path' => (string)$options['path'],
154            'domain' => (string)$options['domain'],
155            'secure' => (bool)$options['secure'],
156            'httpOnly' => (bool)$options['httpOnly'],
157            'raw' => (bool)$options['raw'],
158        ];
159    }
160
161    /**
162     * @param string $name
163     * @return string|null
164     */
165    public function getCookie( $name ) {
166        if ( isset( $this->cookies[$name] ) ) {
167            return $this->cookies[$name]['value'];
168        }
169        return null;
170    }
171
172    /**
173     * @param string $name
174     * @return array|null
175     */
176    public function getCookieData( $name ) {
177        return $this->cookies[$name] ?? null;
178    }
179
180    /**
181     * @return array[]
182     */
183    public function getCookies() {
184        return $this->cookies;
185    }
186
187    /**
188     * @inheritDoc
189     */
190    public function hasCookies() {
191        return count( $this->cookies ) > 0;
192    }
193
194}