Template::doDamageTypeReductionDisplay() - Code Metrics - Inspection of "Merge pull request #1508 from hemberger/phpstan7" - smrealms/smr - Measure and Improve Code Quality continuously with Scrutinizer

Failed Conditions

Push — main ( d9cfb9...10f5c7 )

by Dan

created 2023-01-08 22:19 UTC

Template::doDamageTypeReductionDisplay() A

↳ Parent: Template

Complexity

Conditions	3
Paths	3

Size

Total Lines	7
Code Lines	5

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
cc	3
eloc	5
nc	3
nop	1
dl	0
loc	7
rs	10
c	0
b	0
f	0

<?php declare(strict_types=1);

namespace Smr;

use DOMDocument;
use DOMElement;
use DOMNode;
use DOMXPath;
use Exception;
use Smr\Container\DiContainer;

class Template {

	/** @var array<string, mixed> */
	private array $data = [];
	private int $nestedIncludes = 0;
	/** @var array<string, mixed> */
	private array $ajaxJS = [];
	/** @var array<string> */
	protected array $jsAlerts = [];
	/** @var array<string> */
	protected array $jsSources = [];

	/**
	 * Defines a listjs_include.js function to call at the end of the HTML body.
	 */
	public ?string $listjsInclude = null;

	/**
	 * Return the Smr\Template in the DI container.
	 * If one does not exist yet, it will be created.
	 * This is the intended way to construct this class.
	 */
	public static function getInstance(): self {
		return DiContainer::get(self::class);
	}

	public function hasTemplateVar(string $var): bool {
		return isset($this->data[$var]);
	}

	public function assign(string $var, mixed $value): void {
		if (!isset($this->data[$var])) {
			$this->data[$var] = $value;
		} else {
			// We insist that template variables not change once they are set
			throw new Exception("Cannot re-assign template variable '$var'!");
		}
	}

	public function unassign(string $var): void {
		unset($this->data[$var]);
	}

	/**
	 * Displays the template HTML. Stores any ajax-enabled elements for future
	 * comparison, and outputs modified elements in XML for ajax if requested.
	 */
	public function display(string $templateName, bool $outputXml = false): void {
		// If we already started output buffering before calling `display`,
		// we may have unwanted content in the buffer that we need to remove
		// before we send the Content-Type headers below.
		// Skip this for debug builds to help discover offending output.
		if (!ENABLE_DEBUG) {
			if (ob_get_length() > 0) {
				ob_clean();
			}
		}
		ob_start();
		$this->includeTemplate($templateName);
		$output = ob_get_clean();
		if ($output === false) {
			throw new Exception('Output buffering is not active!');
		}

		$ajaxEnabled = ($this->data['AJAX_ENABLE_REFRESH'] ?? false) !== false;
		if ($ajaxEnabled) {
			$ajaxXml = $this->convertHtmlToAjaxXml($output, $outputXml);
			if ($outputXml) {
				/* Left out for size: <?xml version="1.0" encoding="ISO-8859-1"?>*/
				$output = '<all>' . $ajaxXml . '</all>';
			}
			$session = Session::getInstance();
			$session->saveAjaxReturns();
		}

		// Now that we are completely done processing, we can output
		if ($outputXml) {
			header('Content-Type: text/xml; charset=utf-8');
		} else {
			header('Content-Type: text/html; charset=utf-8');
		}
		echo $output;
	}


	protected function getTemplateLocation(string $templateName): string {
		if (isset($this->data['ThisAccount'])) {
			$templateDir = $this->data['ThisAccount']->getTemplate() . '/';
		} else {
			$templateDir = 'Default/';
		}
		$templateDirs = array_unique([$templateDir, 'Default/']);

		foreach ($templateDirs as $templateDir) {
			$filePath = TEMPLATES . $templateDir . 'engine/Default/' . $templateName;
			if (is_file($filePath)) {
				return $filePath;
			}
		}
		foreach ($templateDirs as $templateDir) {
			$filePath = TEMPLATES . $templateDir . $templateName;
			if (is_file($filePath)) {
				return $filePath;
			}
		}
		throw new Exception('No template found for ' . $templateName);
	}

	/**
	 * @param array<string, mixed> $assignVars
	 */
	protected function includeTemplate(string $templateName, array $assignVars = null): void {
		if ($this->nestedIncludes > 15) {
			throw new Exception('Nested more than 15 template includes, is something wrong?');
		}
		foreach ($this->data as $key => $value) {
			$$key = $value;
		}
		if ($assignVars !== null) {
			foreach ($assignVars as $key => $value) {
				$$key = $value;
			}
		}
		$this->nestedIncludes++;
		require($this->getTemplateLocation($templateName));
		$this->nestedIncludes--;
	}

	/**
	 * Check if the HTML includes input elements where the user is able to
	 * input data (i.e. we don't want to AJAX update a form that they may
	 * have already started filling out).
	 */
	protected function checkDisableAJAX(string $html): bool {
		return preg_match('/<input (?![^>]*(submit|hidden|image))/i', $html) != 0;
	}

	protected function doDamageTypeReductionDisplay(int &$damageTypes): void {
		if ($damageTypes == 3) {
			echo ', ';
		} elseif ($damageTypes == 2) {
			echo ' and ';
		}
		$damageTypes--;
	}

	protected function doAn(string $wordAfter): string {
		$char = strtoupper($wordAfter[0]);
		return str_contains('AEIOU', $char) ? 'an' : 'a';
	}

	/*
	 * EVAL is special (well, will be when needed and implemented in the javascript).
	 */
	public function addJavascriptForAjax(string $varName, mixed $obj): string {
		if ($varName == 'EVAL') {
			if (!isset($this->ajaxJS['EVAL'])) {
				return $this->ajaxJS['EVAL'] = $obj;
			}
			return $this->ajaxJS['EVAL'] .= ';' . $obj;
		}

		if (isset($this->ajaxJS[$varName])) {
			throw new Exception('Trying to set javascript val twice: ' . $varName);
		}
		$json = json_encode($obj);
		if ($json === false) {
			throw new Exception('Failed to encode to json: ' . $varName);
		}
		return $this->ajaxJS[$varName] = $json;
	}

	protected function addJavascriptAlert(string $string): void {
		$session = Session::getInstance();
		if (!$session->addAjaxReturns('ALERT:' . $string, $string)) {
			$this->jsAlerts[] = $string;
		}
	}

	/**
	 * Registers a JS target for inclusion at the end of the HTML body.
	 */
	protected function addJavascriptSource(string $src): void {
		$this->jsSources[] = $src;
	}

	protected function convertHtmlToAjaxXml(string $str, bool $returnXml): string {
		if (empty($str)) {
			return '';
		}

		$session = Session::getInstance();

		$getInnerHTML = function(DOMNode $node): string {
			$innerHTML = '';
			foreach ($node->childNodes as $child) {
				$innerHTML .= $child->ownerDocument->saveHTML($child);
			}
			return $innerHTML;
		};

		// Helper function to canonicalize making an XML element,
		// with its inner content properly escaped.
		$xmlify = function(string $id, string $str): string {
			return '<' . $id . '>' . htmlspecialchars($str, ENT_XML1, 'utf-8') . '</' . $id . '>';
		};

		$xml = '';
		$dom = new DOMDocument();
		$dom->loadHTML($str);
		$xpath = new DOMXPath($dom);

		// Use relative xpath selectors so that they can be reused when we
		// pass the middle panel as the xpath query's context node.
		$ajaxSelectors = ['.//span[@id]', './/*[contains(@class,"ajax")]'];

		foreach ($ajaxSelectors as $selector) {
			$matchNodes = $xpath->query($selector);
			if ($matchNodes === false) {
				throw new Exception('XPath query failed for selector: ' . $selector);
			}
			foreach ($matchNodes as $node) {
				if (!($node instanceof DOMElement)) {
					throw new Exception('XPath query returned unexpected DOMNode type: ' . $node->nodeType);
				}
				$id = $node->getAttribute('id');
				$inner = $getInnerHTML($node);
				if (!$session->addAjaxReturns($id, $inner) && $returnXml) {
					$xml .= $xmlify($id, $inner);
				}
			}
		}

		// Determine if we should do ajax updates on the middle panel div
		$mid = $dom->getElementById('middle_panel');
		$doAjaxMiddle = true;
		if ($mid === null) {
			// Skip if there is no middle_panel.
			$doAjaxMiddle = false;
		} else {
			// Skip if middle_panel has ajax-enabled children.
			foreach ($ajaxSelectors as $selector) {
				$matchNodes = $xpath->query($selector, $mid);
				if ($matchNodes === false) {
					throw new Exception('XPath query failed for selector: ' . $selector);
				}
				if (count($matchNodes) > 0) {
					$doAjaxMiddle = false;
					break;
				}
			}
		}

		if ($doAjaxMiddle) {
			$inner = $getInnerHTML($mid);
			if (!$this->checkDisableAJAX($inner)) {
				$id = $mid->getAttribute('id');
				if (!$session->addAjaxReturns($id, $inner) && $returnXml) {
					$xml .= $xmlify($id, $inner);
				}
			}
		}

		$js = '';
		foreach ($this->ajaxJS as $varName => $JSON) {
			if (!$session->addAjaxReturns('JS:' . $varName, $JSON) && $returnXml) {
				$js .= $xmlify($varName, $JSON);
			}
		}
		if ($returnXml && count($this->jsAlerts) > 0) {
			$js = '<ALERT>' . json_encode($this->jsAlerts) . '</ALERT>';
		}
		if (strlen($js) > 0) {
			$xml .= '<JS>' . $js . '</JS>';
		}
		return $xml;
	}

}


1			<?php declare(strict_types=1);
2
3			namespace Smr;
4
5			use DOMDocument;
6			use DOMElement;
7			use DOMNode;
8			use DOMXPath;
9			use Exception;
10			use Smr\Container\DiContainer;
11
12			class Template {
13
14			/** @var array<string, mixed> */
15			private array $data = [];
16			private int $nestedIncludes = 0;
17			/** @var array<string, mixed> */
18			private array $ajaxJS = [];
19			/** @var array<string> */
20			protected array $jsAlerts = [];
21			/** @var array<string> */
22			protected array $jsSources = [];
23
24			/**
25			* Defines a listjs_include.js function to call at the end of the HTML body.
26			*/
27			public ?string $listjsInclude = null;
28
29			/**
30			* Return the Smr\Template in the DI container.
31			* If one does not exist yet, it will be created.
32			* This is the intended way to construct this class.
33			*/
34			public static function getInstance(): self {
35			return DiContainer::get(self::class);
36			}
37
38			public function hasTemplateVar(string $var): bool {
39			return isset($this->data[$var]);
40			}
41
42			public function assign(string $var, mixed $value): void {
43			if (!isset($this->data[$var])) {
44			$this->data[$var] = $value;
45			} else {
46			// We insist that template variables not change once they are set
47			throw new Exception("Cannot re-assign template variable '$var'!");
48			}
49			}
50
51			public function unassign(string $var): void {
52			unset($this->data[$var]);
53			}
54
55			/**
56			* Displays the template HTML. Stores any ajax-enabled elements for future
57			* comparison, and outputs modified elements in XML for ajax if requested.
58			*/
59			public function display(string $templateName, bool $outputXml = false): void {
60			// If we already started output buffering before calling `display`,
61			// we may have unwanted content in the buffer that we need to remove
62			// before we send the Content-Type headers below.
63			// Skip this for debug builds to help discover offending output.
64			if (!ENABLE_DEBUG) {
65			if (ob_get_length() > 0) {
66			ob_clean();
67			}
68			}
69			ob_start();
70			$this->includeTemplate($templateName);
71			$output = ob_get_clean();
72			if ($output === false) {
73			throw new Exception('Output buffering is not active!');
74			}
75
76			$ajaxEnabled = ($this->data['AJAX_ENABLE_REFRESH'] ?? false) !== false;
77			if ($ajaxEnabled) {
78			$ajaxXml = $this->convertHtmlToAjaxXml($output, $outputXml);
79			if ($outputXml) {
80			/* Left out for size: <?xml version="1.0" encoding="ISO-8859-1"?>*/
81			$output = '<all>' . $ajaxXml . '</all>';
82			}
83			$session = Session::getInstance();
84			$session->saveAjaxReturns();
85			}
86
87			// Now that we are completely done processing, we can output
88			if ($outputXml) {
89			header('Content-Type: text/xml; charset=utf-8');
90			} else {
91			header('Content-Type: text/html; charset=utf-8');
92			}
93			echo $output;
94			}
95
96
97			protected function getTemplateLocation(string $templateName): string {
98			if (isset($this->data['ThisAccount'])) {
99			$templateDir = $this->data['ThisAccount']->getTemplate() . '/';
100			} else {
101			$templateDir = 'Default/';
102			}
103			$templateDirs = array_unique([$templateDir, 'Default/']);
104
105			foreach ($templateDirs as $templateDir) {
106			$filePath = TEMPLATES . $templateDir . 'engine/Default/' . $templateName;
107			if (is_file($filePath)) {
108			return $filePath;
109			}
110			}
111			foreach ($templateDirs as $templateDir) {
112			$filePath = TEMPLATES . $templateDir . $templateName;
113			if (is_file($filePath)) {
114			return $filePath;
115			}
116			}
117			throw new Exception('No template found for ' . $templateName);
118			}
119
120			/**
121			* @param array<string, mixed> $assignVars
122			*/
123			protected function includeTemplate(string $templateName, array $assignVars = null): void {
124			if ($this->nestedIncludes > 15) {
125			throw new Exception('Nested more than 15 template includes, is something wrong?');
126			}
127			foreach ($this->data as $key => $value) {
128			$$key = $value;
129			}
130			if ($assignVars !== null) {
131			foreach ($assignVars as $key => $value) {
132			$$key = $value;
133			}
134			}
135			$this->nestedIncludes++;
136			require($this->getTemplateLocation($templateName));
137			$this->nestedIncludes--;
138			}
139
140			/**
141			* Check if the HTML includes input elements where the user is able to
142			* input data (i.e. we don't want to AJAX update a form that they may
143			* have already started filling out).
144			*/
145			protected function checkDisableAJAX(string $html): bool {
146			return preg_match('/<input (?![^>]*(submit\|hidden\|image))/i', $html) != 0;
147			}
148
149			protected function doDamageTypeReductionDisplay(int &$damageTypes): void {
150			if ($damageTypes == 3) {
151			echo ', ';
152			} elseif ($damageTypes == 2) {
153			echo ' and ';
154			}
155			$damageTypes--;
156			}
157
158			protected function doAn(string $wordAfter): string {
159			$char = strtoupper($wordAfter[0]);
160			return str_contains('AEIOU', $char) ? 'an' : 'a';
161			}
162
163			/*
164			* EVAL is special (well, will be when needed and implemented in the javascript).
165			*/
166			public function addJavascriptForAjax(string $varName, mixed $obj): string {
167			if ($varName == 'EVAL') {
168			if (!isset($this->ajaxJS['EVAL'])) {
169			return $this->ajaxJS['EVAL'] = $obj;
170			}
171			return $this->ajaxJS['EVAL'] .= ';' . $obj;
172			}
173
174			if (isset($this->ajaxJS[$varName])) {
175			throw new Exception('Trying to set javascript val twice: ' . $varName);
176			}
177			$json = json_encode($obj);
178			if ($json === false) {
179			throw new Exception('Failed to encode to json: ' . $varName);
180			}
181			return $this->ajaxJS[$varName] = $json;
182			}
183
184			protected function addJavascriptAlert(string $string): void {
185			$session = Session::getInstance();
186			if (!$session->addAjaxReturns('ALERT:' . $string, $string)) {
187			$this->jsAlerts[] = $string;
188			}
189			}
190
191			/**
192			* Registers a JS target for inclusion at the end of the HTML body.
193			*/
194			protected function addJavascriptSource(string $src): void {
195			$this->jsSources[] = $src;
196			}
197
198			protected function convertHtmlToAjaxXml(string $str, bool $returnXml): string {
199			if (empty($str)) {
200			return '';
201			}
202
203			$session = Session::getInstance();
204
205			$getInnerHTML = function(DOMNode $node): string {
206			$innerHTML = '';
207			foreach ($node->childNodes as $child) {
208			$innerHTML .= $child->ownerDocument->saveHTML($child);
209			}
210			return $innerHTML;
211			};
212
213			// Helper function to canonicalize making an XML element,
214			// with its inner content properly escaped.
215			$xmlify = function(string $id, string $str): string {
216			return '<' . $id . '>' . htmlspecialchars($str, ENT_XML1, 'utf-8') . '</' . $id . '>';
217			};
218
219			$xml = '';
220			$dom = new DOMDocument();
221			$dom->loadHTML($str);
222			$xpath = new DOMXPath($dom);
223
224			// Use relative xpath selectors so that they can be reused when we
225			// pass the middle panel as the xpath query's context node.
226			$ajaxSelectors = ['.//span[@id]', './/*[contains(@class,"ajax")]'];
227
228			foreach ($ajaxSelectors as $selector) {
229			$matchNodes = $xpath->query($selector);
230			if ($matchNodes === false) {
231			throw new Exception('XPath query failed for selector: ' . $selector);
232			}
233			foreach ($matchNodes as $node) {
234			if (!($node instanceof DOMElement)) {
235			throw new Exception('XPath query returned unexpected DOMNode type: ' . $node->nodeType);
236			}
237			$id = $node->getAttribute('id');
238			$inner = $getInnerHTML($node);
239			if (!$session->addAjaxReturns($id, $inner) && $returnXml) {
240			$xml .= $xmlify($id, $inner);
241			}
242			}
243			}
244
245			// Determine if we should do ajax updates on the middle panel div
246			$mid = $dom->getElementById('middle_panel');
247			$doAjaxMiddle = true;
248			if ($mid === null) {
249			// Skip if there is no middle_panel.
250			$doAjaxMiddle = false;
251			} else {
252			// Skip if middle_panel has ajax-enabled children.
253			foreach ($ajaxSelectors as $selector) {
254			$matchNodes = $xpath->query($selector, $mid);
255			if ($matchNodes === false) {
256			throw new Exception('XPath query failed for selector: ' . $selector);
257			}
258			if (count($matchNodes) > 0) {
259			$doAjaxMiddle = false;
260			break;
261			}
262			}
263			}
264
265			if ($doAjaxMiddle) {
266			$inner = $getInnerHTML($mid);
267			if (!$this->checkDisableAJAX($inner)) {
268			$id = $mid->getAttribute('id');
269			if (!$session->addAjaxReturns($id, $inner) && $returnXml) {
270			$xml .= $xmlify($id, $inner);
271			}
272			}
273			}
274
275			$js = '';
276			foreach ($this->ajaxJS as $varName => $JSON) {
277			if (!$session->addAjaxReturns('JS:' . $varName, $JSON) && $returnXml) {
278			$js .= $xmlify($varName, $JSON);
279			}
280			}
281			if ($returnXml && count($this->jsAlerts) > 0) {
282			$js = '<ALERT>' . json_encode($this->jsAlerts) . '</ALERT>';
283			}
284			if (strlen($js) > 0) {
285			$xml .= '<JS>' . $js . '</JS>';
286			}
287			return $xml;
288			}
289
290			}
291

smrealms / smr

Scrutinizer GitHub App not installed

Push — main ( d9cfb9...10f5c7 )

Template::doDamageTypeReductionDisplay() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like