<?php

[0] Fix | Delete

[1] Fix | Delete

// SPDX-FileCopyrightText: 2004-2023 Ryan Parman, Sam Sneddon, Ryan McCue

[2] Fix | Delete

// SPDX-License-Identifier: BSD-3-Clause

[3] Fix | Delete

[4] Fix | Delete

declare(strict_types=1);

[5] Fix | Delete

[6] Fix | Delete

namespace SimplePie\XML\Declaration;

[7] Fix | Delete

[8] Fix | Delete

/**

[9] Fix | Delete

* Parses the XML Declaration

[10] Fix | Delete

*/

[11] Fix | Delete

class Parser

[12] Fix | Delete

{

[13] Fix | Delete

/**

[14] Fix | Delete

* XML Version

[15] Fix | Delete

*

[16] Fix | Delete

* @access public

[17] Fix | Delete

* @var string

[18] Fix | Delete

*/

[19] Fix | Delete

public $version = '1.0';

[20] Fix | Delete

[21] Fix | Delete

/**

[22] Fix | Delete

* Encoding

[23] Fix | Delete

*

[24] Fix | Delete

* @access public

[25] Fix | Delete

* @var string

[26] Fix | Delete

*/

[27] Fix | Delete

public $encoding = 'UTF-8';

[28] Fix | Delete

[29] Fix | Delete

/**

[30] Fix | Delete

* Standalone

[31] Fix | Delete

*

[32] Fix | Delete

* @access public

[33] Fix | Delete

* @var bool

[34] Fix | Delete

*/

[35] Fix | Delete

public $standalone = false;

[36] Fix | Delete

[37] Fix | Delete

private const STATE_BEFORE_VERSION_NAME = 'before_version_name';

[38] Fix | Delete

[39] Fix | Delete

private const STATE_VERSION_NAME = 'version_name';

[40] Fix | Delete

[41] Fix | Delete

private const STATE_VERSION_EQUALS = 'version_equals';

[42] Fix | Delete

[43] Fix | Delete

private const STATE_VERSION_VALUE = 'version_value';

[44] Fix | Delete

[45] Fix | Delete

private const STATE_ENCODING_NAME = 'encoding_name';

[46] Fix | Delete

[47] Fix | Delete

private const STATE_EMIT = 'emit';

[48] Fix | Delete

[49] Fix | Delete

private const STATE_ENCODING_EQUALS = 'encoding_equals';

[50] Fix | Delete

[51] Fix | Delete

private const STATE_STANDALONE_NAME = 'standalone_name';

[52] Fix | Delete

[53] Fix | Delete

private const STATE_ENCODING_VALUE = 'encoding_value';

[54] Fix | Delete

[55] Fix | Delete

private const STATE_STANDALONE_EQUALS = 'standalone_equals';

[56] Fix | Delete

[57] Fix | Delete

private const STATE_STANDALONE_VALUE = 'standalone_value';

[58] Fix | Delete

[59] Fix | Delete

private const STATE_ERROR = false;

[60] Fix | Delete

[61] Fix | Delete

/**

[62] Fix | Delete

* Current state of the state machine

[63] Fix | Delete

*

[64] Fix | Delete

* @access private

[65] Fix | Delete

* @var self::STATE_*

[66] Fix | Delete

*/

[67] Fix | Delete

public $state = self::STATE_BEFORE_VERSION_NAME;

[68] Fix | Delete

[69] Fix | Delete

/**

[70] Fix | Delete

* Input data

[71] Fix | Delete

*

[72] Fix | Delete

* @access private

[73] Fix | Delete

* @var string

[74] Fix | Delete

*/

[75] Fix | Delete

public $data = '';

[76] Fix | Delete

[77] Fix | Delete

/**

[78] Fix | Delete

* Input data length (to avoid calling strlen() everytime this is needed)

[79] Fix | Delete

*

[80] Fix | Delete

* @access private

[81] Fix | Delete

* @var int

[82] Fix | Delete

*/

[83] Fix | Delete

public $data_length = 0;

[84] Fix | Delete

[85] Fix | Delete

/**

[86] Fix | Delete

* Current position of the pointer

[87] Fix | Delete

*

[88] Fix | Delete

* @var int

[89] Fix | Delete

* @access private

[90] Fix | Delete

*/

[91] Fix | Delete

public $position = 0;

[92] Fix | Delete

[93] Fix | Delete

/**

[94] Fix | Delete

* Create an instance of the class with the input data

[95] Fix | Delete

*

[96] Fix | Delete

* @access public

[97] Fix | Delete

* @param string $data Input data

[98] Fix | Delete

*/

[99] Fix | Delete

public function __construct(string $data)

[100] Fix | Delete

{

[101] Fix | Delete

$this->data = $data;

[102] Fix | Delete

$this->data_length = strlen($this->data);

[103] Fix | Delete

}

[104] Fix | Delete

[105] Fix | Delete

/**

[106] Fix | Delete

* Parse the input data

[107] Fix | Delete

*

[108] Fix | Delete

* @access public

[109] Fix | Delete

* @return bool true on success, false on failure

[110] Fix | Delete

*/

[111] Fix | Delete

public function parse(): bool

[112] Fix | Delete

{

[113] Fix | Delete

while ($this->state && $this->state !== self::STATE_EMIT && $this->has_data()) {

[114] Fix | Delete

$state = $this->state;

[115] Fix | Delete

$this->$state();

[116] Fix | Delete

}

[117] Fix | Delete

$this->data = '';

[118] Fix | Delete

if ($this->state === self::STATE_EMIT) {

[119] Fix | Delete

return true;

[120] Fix | Delete

}

[121] Fix | Delete

[122] Fix | Delete

// Reset the parser state.

[123] Fix | Delete

$this->version = '1.0';

[124] Fix | Delete

$this->encoding = 'UTF-8';

[125] Fix | Delete

$this->standalone = false;

[126] Fix | Delete

return false;

[127] Fix | Delete

}

[128] Fix | Delete

[129] Fix | Delete

/**

[130] Fix | Delete

* Check whether there is data beyond the pointer

[131] Fix | Delete

*

[132] Fix | Delete

* @access private

[133] Fix | Delete

* @return bool true if there is further data, false if not

[134] Fix | Delete

*/

[135] Fix | Delete

public function has_data(): bool

[136] Fix | Delete

{

[137] Fix | Delete

return (bool) ($this->position < $this->data_length);

[138] Fix | Delete

}

[139] Fix | Delete

[140] Fix | Delete

/**

[141] Fix | Delete

* Advance past any whitespace

[142] Fix | Delete

*

[143] Fix | Delete

* @return int Number of whitespace characters passed

[144] Fix | Delete

*/

[145] Fix | Delete

public function skip_whitespace()

[146] Fix | Delete

{

[147] Fix | Delete

$whitespace = strspn($this->data, "\x09\x0A\x0D\x20", $this->position);

[148] Fix | Delete

$this->position += $whitespace;

[149] Fix | Delete

return $whitespace;

[150] Fix | Delete

}

[151] Fix | Delete

[152] Fix | Delete

/**

[153] Fix | Delete

* Read value

[154] Fix | Delete

*

[155] Fix | Delete

* @return string|false

[156] Fix | Delete

*/

[157] Fix | Delete

public function get_value()

[158] Fix | Delete

{

[159] Fix | Delete

$quote = substr($this->data, $this->position, 1);

[160] Fix | Delete

if ($quote === '"' || $quote === "'") {

[161] Fix | Delete

$this->position++;

[162] Fix | Delete

$len = strcspn($this->data, $quote, $this->position);

[163] Fix | Delete

if ($this->has_data()) {

[164] Fix | Delete

$value = substr($this->data, $this->position, $len);

[165] Fix | Delete

$this->position += $len + 1;

[166] Fix | Delete

return $value;

[167] Fix | Delete

}

[168] Fix | Delete

}

[169] Fix | Delete

return false;

[170] Fix | Delete

}

[171] Fix | Delete

[172] Fix | Delete

public function before_version_name(): void

[173] Fix | Delete

{

[174] Fix | Delete

if ($this->skip_whitespace()) {

[175] Fix | Delete

$this->state = self::STATE_VERSION_NAME;

[176] Fix | Delete

} else {

[177] Fix | Delete

$this->state = self::STATE_ERROR;

[178] Fix | Delete

}

[179] Fix | Delete

}

[180] Fix | Delete

[181] Fix | Delete

public function version_name(): void

[182] Fix | Delete

{

[183] Fix | Delete

if (substr($this->data, $this->position, 7) === 'version') {

[184] Fix | Delete

$this->position += 7;

[185] Fix | Delete

$this->skip_whitespace();

[186] Fix | Delete

$this->state = self::STATE_VERSION_EQUALS;

[187] Fix | Delete

} else {

[188] Fix | Delete

$this->state = self::STATE_ERROR;

[189] Fix | Delete

}

[190] Fix | Delete

}

[191] Fix | Delete

[192] Fix | Delete

public function version_equals(): void

[193] Fix | Delete

{

[194] Fix | Delete

if (substr($this->data, $this->position, 1) === '=') {

[195] Fix | Delete

$this->position++;

[196] Fix | Delete

$this->skip_whitespace();

[197] Fix | Delete

$this->state = self::STATE_VERSION_VALUE;

[198] Fix | Delete

} else {

[199] Fix | Delete

$this->state = self::STATE_ERROR;

[200] Fix | Delete

}

[201] Fix | Delete

}

[202] Fix | Delete

[203] Fix | Delete

public function version_value(): void

[204] Fix | Delete

{

[205] Fix | Delete

if ($version = $this->get_value()) {

[206] Fix | Delete

$this->version = $version;

[207] Fix | Delete

$this->skip_whitespace();

[208] Fix | Delete

if ($this->has_data()) {

[209] Fix | Delete

$this->state = self::STATE_ENCODING_NAME;

[210] Fix | Delete

} else {

[211] Fix | Delete

$this->state = self::STATE_EMIT;

[212] Fix | Delete

}

[213] Fix | Delete

} else {

[214] Fix | Delete

$this->state = self::STATE_ERROR;

[215] Fix | Delete

}

[216] Fix | Delete

}

[217] Fix | Delete

[218] Fix | Delete

public function encoding_name(): void

[219] Fix | Delete

{

[220] Fix | Delete

if (substr($this->data, $this->position, 8) === 'encoding') {

[221] Fix | Delete

$this->position += 8;

[222] Fix | Delete

$this->skip_whitespace();

[223] Fix | Delete

$this->state = self::STATE_ENCODING_EQUALS;

[224] Fix | Delete

} else {

[225] Fix | Delete

$this->state = self::STATE_STANDALONE_NAME;

[226] Fix | Delete

}

[227] Fix | Delete

}

[228] Fix | Delete

[229] Fix | Delete

public function encoding_equals(): void

[230] Fix | Delete

{

[231] Fix | Delete

if (substr($this->data, $this->position, 1) === '=') {

[232] Fix | Delete

$this->position++;

[233] Fix | Delete

$this->skip_whitespace();

[234] Fix | Delete

$this->state = self::STATE_ENCODING_VALUE;

[235] Fix | Delete

} else {

[236] Fix | Delete

$this->state = self::STATE_ERROR;

[237] Fix | Delete

}

[238] Fix | Delete

}

[239] Fix | Delete

[240] Fix | Delete

public function encoding_value(): void

[241] Fix | Delete

{

[242] Fix | Delete

if ($encoding = $this->get_value()) {

[243] Fix | Delete

$this->encoding = $encoding;

[244] Fix | Delete

$this->skip_whitespace();

[245] Fix | Delete

if ($this->has_data()) {

[246] Fix | Delete

$this->state = self::STATE_STANDALONE_NAME;

[247] Fix | Delete

} else {

[248] Fix | Delete

$this->state = self::STATE_EMIT;

[249] Fix | Delete

}

[250] Fix | Delete

} else {

[251] Fix | Delete

$this->state = self::STATE_ERROR;

[252] Fix | Delete

}

[253] Fix | Delete

}

[254] Fix | Delete

[255] Fix | Delete

public function standalone_name(): void

[256] Fix | Delete

{

[257] Fix | Delete

if (substr($this->data, $this->position, 10) === 'standalone') {

[258] Fix | Delete

$this->position += 10;

[259] Fix | Delete

$this->skip_whitespace();

[260] Fix | Delete

$this->state = self::STATE_STANDALONE_EQUALS;

[261] Fix | Delete

} else {

[262] Fix | Delete

$this->state = self::STATE_ERROR;

[263] Fix | Delete

}

[264] Fix | Delete

}

[265] Fix | Delete

[266] Fix | Delete

public function standalone_equals(): void

[267] Fix | Delete

{

[268] Fix | Delete

if (substr($this->data, $this->position, 1) === '=') {

[269] Fix | Delete

$this->position++;

[270] Fix | Delete

$this->skip_whitespace();

[271] Fix | Delete

$this->state = self::STATE_STANDALONE_VALUE;

[272] Fix | Delete

} else {

[273] Fix | Delete

$this->state = self::STATE_ERROR;

[274] Fix | Delete

}

[275] Fix | Delete

}

[276] Fix | Delete

[277] Fix | Delete

public function standalone_value(): void

[278] Fix | Delete

{

[279] Fix | Delete

if ($standalone = $this->get_value()) {

[280] Fix | Delete

switch ($standalone) {

[281] Fix | Delete

case 'yes':

[282] Fix | Delete

$this->standalone = true;

[283] Fix | Delete

break;

[284] Fix | Delete

[285] Fix | Delete

case 'no':

[286] Fix | Delete

$this->standalone = false;

[287] Fix | Delete

break;

[288] Fix | Delete

[289] Fix | Delete

default:

[290] Fix | Delete

$this->state = self::STATE_ERROR;

[291] Fix | Delete

return;

[292] Fix | Delete

}

[293] Fix | Delete

[294] Fix | Delete

$this->skip_whitespace();

[295] Fix | Delete

if ($this->has_data()) {

[296] Fix | Delete

$this->state = self::STATE_ERROR;

[297] Fix | Delete

} else {

[298] Fix | Delete

$this->state = self::STATE_EMIT;

[299] Fix | Delete

}

[300] Fix | Delete

} else {

[301] Fix | Delete

$this->state = self::STATE_ERROR;

[302] Fix | Delete

}

[303] Fix | Delete

}

[304] Fix | Delete

}

[305] Fix | Delete

[306] Fix | Delete

class_alias('SimplePie\XML\Declaration\Parser', 'SimplePie_XML_Declaration_Parser');

[307] Fix | Delete

[308] Fix | Delete