Files
yii2/tests/framework/web/ResponseTest.php
2025-06-13 04:54:54 -04:00

556 lines
18 KiB
PHP

<?php
/**
* @link https://www.yiiframework.com/
* @copyright Copyright (c) 2008 Yii Software LLC
* @license https://www.yiiframework.com/license/
*/
namespace yiiunit\framework\web;
use Error;
use Exception;
use RuntimeException;
use Yii;
use yii\helpers\StringHelper;
use yii\web\Cookie;
use yii\web\HttpException;
use yii\web\Response;
use yiiunit\framework\web\mocks\TestRequestComponent;
/**
* @group web
*/
class ResponseTest extends \yiiunit\TestCase
{
/**
* @var \yii\web\Response
*/
public $response;
protected function setUp(): void
{
parent::setUp();
$this->mockWebApplication([
'components' => [
'request' => [
'class' => TestRequestComponent::class,
],
],
]);
$this->response = new \yii\web\Response();
}
public static function rightRanges(): array
{
// TODO test more cases for range requests and check for rfc compatibility
// https://tools.ietf.org/html/rfc2616
return [
['0-5', '0-5', 6, '12ёж'],
['2-', '2-66', 65, 'ёжик3456798áèabcdefghijklmnopqrstuvwxyz!"§$%&/(ёжик)=?'],
['-12', '55-66', 12, '(ёжик)=?'],
];
}
/**
* @dataProvider rightRanges
*
* @param string $rangeHeader The range header.
* @param string $expectedHeader The expected header.
* @param int $length The length of the content.
* @param string $expectedContent The expected content.
*/
public function testSendFileRanges(
string $rangeHeader,
string $expectedHeader,
int $length,
string $expectedContent
): void {
$dataFile = Yii::getAlias('@yiiunit/data/web/data.txt');
$fullContent = file_get_contents($dataFile);
$_SERVER['HTTP_RANGE'] = 'bytes=' . $rangeHeader;
ob_start();
$this->response->sendFile($dataFile)->send();
$content = ob_get_clean();
$this->assertEquals($expectedContent, $content);
$this->assertEquals(206, $this->response->statusCode);
$headers = $this->response->headers;
$this->assertEquals('bytes', $headers->get('Accept-Ranges'));
$this->assertEquals(
'bytes ' . $expectedHeader . '/' . StringHelper::byteLength($fullContent),
$headers->get('Content-Range')
);
$this->assertEquals('text/plain', $headers->get('Content-Type'));
$this->assertEquals((string)$length, $headers->get('Content-Length'));
}
public static function wrongRanges(): array
{
// TODO test more cases for range requests and check for rfc compatibility
// https://tools.ietf.org/html/rfc2616
return [
['1-2,3-5,6-10'], // multiple range request not supported
['5-1'], // last-byte-pos value is less than its first-byte-pos value
['-100000'], // last-byte-pos bigger then content length
['10000-'], // first-byte-pos bigger then content length
];
}
/**
* @dataProvider wrongRanges
*
* @param string $rangeHeader the range header.
*/
public function testSendFileWrongRanges(string $rangeHeader): void
{
$this->expectException('yii\web\RangeNotSatisfiableHttpException');
$dataFile = Yii::getAlias('@yiiunit/data/web/data.txt');
$_SERVER['HTTP_RANGE'] = 'bytes=' . $rangeHeader;
$this->response->sendFile($dataFile);
}
protected function generateTestFileContent()
{
return '12ёжик3456798áèabcdefghijklmnopqrstuvwxyz!"§$%&/(ёжик)=?';
}
/**
* @see https://github.com/yiisoft/yii2/issues/7529
*/
public function testSendContentAsFile(): void
{
ob_start();
$this->response->sendContentAsFile('test', 'test.txt')->send();
$content = ob_get_clean();
static::assertEquals('test', $content);
static::assertEquals(200, $this->response->statusCode);
$headers = $this->response->headers;
static::assertEquals('application/octet-stream', $headers->get('Content-Type'));
static::assertEquals('attachment; filename="test.txt"', $headers->get('Content-Disposition'));
static::assertEquals(4, $headers->get('Content-Length'));
}
public function testRedirect(): void
{
$_SERVER['REQUEST_URI'] = 'http://test-domain.com/';
$this->assertEquals('/', $this->response->redirect('')->headers->get('location'));
$this->assertFalse($this->response->redirect(null)->headers->get('location'));
$this->assertEquals(
'http://some-external-domain.com',
$this->response->redirect('http://some-external-domain.com')->headers->get('location')
);
$this->assertEquals('/', $this->response->redirect('/')->headers->get('location'));
$this->assertEquals(
'/something-relative',
$this->response->redirect('/something-relative')->headers->get('location')
);
$this->assertEquals('/index.php?r=', $this->response->redirect(['/'])->headers->get('location'));
$this->assertEquals(
'/index.php?r=view',
$this->response->redirect(['view'])->headers->get('location')
);
$this->assertEquals(
'/index.php?r=controller',
$this->response->redirect(['/controller'])->headers->get('location')
);
$this->assertEquals(
'/index.php?r=controller%2Findex',
$this->response->redirect(['/controller/index'])->headers->get('location')
);
$this->assertEquals(
'/index.php?r=controller%2Findex',
$this->response->redirect(['//controller/index'])->headers->get('location')
);
$this->assertEquals(
'/index.php?r=controller%2Findex&id=3',
$this->response->redirect(['//controller/index', 'id' => 3])->headers->get('location')
);
$this->assertEquals(
'/index.php?r=controller%2Findex&id_1=3&id_2=4',
$this->response->redirect(['//controller/index', 'id_1' => 3, 'id_2' => 4])->headers->get('location')
);
$this->assertEquals(
'/index.php?r=controller%2Findex&slug=%C3%A4%C3%B6%C3%BC%C3%9F%21%22%C2%A7%24%25%26%2F%28%29',
$this->response->redirect(['//controller/index', 'slug' => 'äöüß!"§$%&/()'])->headers->get('location')
);
}
/**
* @see https://github.com/yiisoft/yii2/issues/19795
*/
public function testRedirectNewLine(): void
{
$this->expectException('yii\base\InvalidRouteException');
$this->response->redirect(urldecode('http://test-domain.com/gql.json;%0aa.html'));
}
/**
* @dataProvider dataProviderAjaxRedirectInternetExplorer11
*
* @param string $userAgent User agent string
* @param array $statusCodes Status codes
*/
public function testAjaxRedirectInternetExplorer11(string $userAgent, array $statusCodes): void
{
$_SERVER['REQUEST_URI'] = 'http://test-domain.com/';
$request= Yii::$app->request;
/** @var TestRequestComponent $request */
$request->getIssAjaxOverride = true;
$request->getUserAgentOverride = $userAgent;
foreach([true, false] as $pjaxOverride) {
$request->getIsPjaxOverride = $pjaxOverride;
foreach(['GET', 'POST'] as $methodOverride) {
$request->getMethodOverride = $methodOverride;
foreach($statusCodes as $statusCode => $expectStatusCode) {
$this->assertEquals($expectStatusCode, $this->response->redirect(['view'], $statusCode)->statusCode);
}
}
}
}
/**
* @link https://blogs.msdn.microsoft.com/ieinternals/2013/09/21/internet-explorer-11s-many-user-agent-strings/
* @link https://stackoverflow.com/questions/30591706/what-is-the-user-agent-string-name-for-microsoft-edge/31279980#31279980
* @link https://developers.whatismybrowser.com/useragents/explore/software_name/chrome/
* @link https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/User-Agent/Firefox
* @return array
*/
public static function dataProviderAjaxRedirectInternetExplorer11(): array
{
return [
['Mozilla/5.0 (Android 4.4; Mobile; rv:41.0) Gecko/41.0 Firefox/41.0', [301 => 301, 302 => 302]], // Firefox
['Mozilla/5.0 (Windows NT 6.3; Trident/7.0; rv:11.0) like Gecko', [301 => 200, 302 => 200]], // IE 11
[ // IE 11
'Mozilla/5.0 (Windows NT 6.3; Trident/7.0; .NET4.0E; .NET4.0C; rv:11.0) like Gecko',
[301 => 200, 302 => 200]
],
[ // Chrome
'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/74.0.3729.169 Safari/537.36',
[301 => 301, 302 => 302]
],
[ // Edge
'Mozilla/5.0 (Windows NT 10.0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/42.0.2311.135 Safari/537.36 Edge/12.10136',
[301 => 301, 302 => 302]
],
[ // special windows versions (for tablets or IoT devices)
'Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 6.2; WOW64; Trident/7.0; .NET4.0C; .NET4.0E; Tablet PC 2.0)',
[301 => 200, 302 => 200]
],
];
}
/**
* @dataProvider dataProviderSetStatusCodeByException
*
* @param Exception $exception The exception to set.
* @param int $statusCode The expected status code.
*/
public function testSetStatusCodeByException(Exception|Error $exception, int $statusCode): void
{
$this->response->setStatusCodeByException($exception);
$this->assertEquals($statusCode, $this->response->getStatusCode());
}
/**
* @see https://github.com/yiisoft/yii2/pull/18290
*/
public function testNonSeekableStream(): void
{
$stream = fopen('php://output', 'r+');
ob_start();
$this->response->sendStreamAsFile($stream, 'test-stream')->send();
ob_get_clean();
static::assertEquals(200, $this->response->statusCode);
}
public static function dataProviderSetStatusCodeByException(): array
{
$data = [
[
new Exception(),
500,
],
[
new RuntimeException(),
500,
],
[
new HttpException(500),
500,
],
[
new HttpException(403),
403,
],
[
new HttpException(404),
404,
],
[
new HttpException(301),
301,
],
[
new HttpException(200),
200,
],
];
if (class_exists('Error')) {
$data[] = [
new Error(),
500,
];
}
return $data;
}
public static function formatDataProvider(): array
{
return [
[Response::FORMAT_JSON, '{"value":1}'],
[Response::FORMAT_HTML, '<html><head><title>Test</title></head><body>Test Body</body></html>'],
[Response::FORMAT_XML, '<?xml ?><test></test>'],
[Response::FORMAT_RAW, 'Something'],
];
}
/**
* @dataProvider formatDataProvider
*
* @param string $format Response format.
* @param string $content Response content.
*/
public function testSkipFormatter(string $format, string $content): void
{
$response = new Response();
$response->format = $format;
$response->content = $content;
ob_start();
$response->send();
$actualContent = ob_get_clean();
$this->assertSame($content, $actualContent);
}
/**
* @see https://github.com/yiisoft/yii2/issues/17094
*/
public function testEmptyContentOn204(): void
{
$this->assertEmptyContentOn(204);
}
public function testSettingContentToNullOn204(): void
{
$this->assertEmptyContentOn(
204,
function (Response $response) {
$this->assertSame($response->content, '');
}
);
}
public function testSettingStreamToNullOn204(): void
{
$this->assertSettingStreamToNullOn(204);
}
/**
* @see https://github.com/yiisoft/yii2/issues/18199
*/
public function testEmptyContentOn304(): void
{
$this->assertEmptyContentOn(304);
}
/**
* @see https://github.com/yiisoft/yii2/issues/18199
*/
public function testSettingContentToNullOn304(): void
{
$this->assertEmptyContentOn(
304,
function (Response $response) {
$this->assertSame($response->content, '');
}
);
}
public function testSettingStreamToNullOn304(): void
{
$this->assertSettingStreamToNullOn(304);
}
public function testSendFileWithInvalidCharactersInFileName(): void
{
$response = new Response();
$dataFile = Yii::getAlias('@yiiunit/data/web/data.txt');
$response->sendFile($dataFile, "test\x7Ftest.txt");
$this->assertSame(
"attachment; filename=\"test_test.txt\"; filename*=utf-8''test%7Ftest.txt",
$response->headers['content-disposition']
);
}
/**
* @dataProvider cookiesTestProvider
*/
public function testCookies($cookieConfig, $expected): void
{
$response = new Response();
$response->cookies->add(new Cookie(array_merge(
[
'name' => 'test',
'value' => 'testValue',
],
$cookieConfig
)));
ob_start();
$response->send();
$content = ob_get_clean();
$cookies = $this->parseHeaderCookies();
if ($cookies === false) {
// Unable to resolve cookies, only way to test is that it doesn't create any errors
$this->assertEquals('', $content);
} else {
$testCookie = $cookies['test'];
$actual = array_intersect_key($testCookie, $expected);
ksort($actual);
ksort($expected);
$this->assertEquals($expected, $actual);
}
}
public function cookiesTestProvider()
{
$expireInt = time() + 3600;
$expireString = date('D, d-M-Y H:i:s', $expireInt) . ' GMT';
$testCases = [
'same-site' => [
['sameSite' => Cookie::SAME_SITE_STRICT],
['samesite' => Cookie::SAME_SITE_STRICT],
],
'expire-as-int' => [
['expire' => $expireInt],
['expires' => $expireString],
],
'expire-as-string' => [
['expire' => $expireString],
['expires' => $expireString],
],
];
if (version_compare(PHP_VERSION, '5.5.0', '>=')) {
$testCases = [...$testCases, 'expire-as-date_time' => [
['expire' => new \DateTime('@' . $expireInt)],
['expires' => $expireString],
], 'expire-as-date_time_immutable' => [
['expire' => new \DateTimeImmutable('@' . $expireInt)],
['expires' => $expireString],
]];
}
return $testCases;
}
/**
* Tries to parse cookies set in the response headers.
* When running PHP on the CLI headers are not available (the `headers_list()` function always returns an
* empty array). If possible use xDebug: http://xdebug.org/docs/all_functions#xdebug_get_headers
* @param $name
* @return array|false
*/
protected function parseHeaderCookies() {
if (!function_exists('xdebug_get_headers')) {
return false;
}
$cookies = [];
foreach(xdebug_get_headers() as $header) {
if (!str_starts_with((string) $header, 'Set-Cookie: ')) {
continue;
}
$name = null;
$params = [];
$pairs = explode(';', substr((string) $header, 12));
foreach ($pairs as $index => $pair) {
$pair = trim($pair);
if (!str_contains($pair, '=')) {
$params[strtolower($pair)] = true;
} else {
[$paramName, $paramValue] = explode('=', $pair, 2);
if ($index === 0) {
$name = $paramName;
$params['value'] = urldecode($paramValue);
} else {
$params[strtolower($paramName)] = urldecode($paramValue);
}
}
}
if ($name === null) {
throw new \Exception('Could not determine cookie name for header "' . $header . '".');
}
$cookies[$name] = $params;
}
return $cookies;
}
/**
* Asserts that given a status code, the response will have an empty content body. If the lambda is present, it will
* call the lambda what is supposed to handle other assertions.
*
* @param int $statusCode
* @param callable|null $callback lambda in charge to handle other assertions
* callable(\yii\web\Response $response):void
*/
protected function assertEmptyContentOn($statusCode, $callback = null)
{
$response = new Response();
$response->setStatusCode($statusCode);
$response->content = 'not empty content';
ob_start();
$response->send();
$content = ob_get_clean();
$this->assertSame($content, '');
if ($callback && is_callable($callback)) {
$callback($response);
}
}
/**
* Asserts that given a status code, the response will have an empty content body, no matter
* if the response is a stream as file
*
* @param int $statusCode
*/
protected function assertSettingStreamToNullOn($statusCode)
{
$response = new Response();
$dataFile = Yii::getAlias('@yiiunit/data/web/data.txt');
$response->sendFile($dataFile);
$response->setStatusCode($statusCode);
ob_start();
$response->send();
$content = ob_get_clean();
$this->assertSame($content, '');
$this->assertNull($response->stream);
}
}