PageIndexerRequest::setAuthorizationCredentials() - Code Metrics - Inspection of "[TASK] Remove constant TYPO3_user_agent (#1801)" - TYPO3-Solr/ext-solr - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — master ( c00acb...6ee2a7 )

by Timo

created 2018-01-04 15:40 UTC

PageIndexerRequest::setAuthorizationCredentials() A

↳ Parent: PageIndexerRequest

Complexity

Conditions	1
Paths	1

Size

Total Lines	5
Code Lines	3

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	1
CRAP Score	1

Importance

Changes

Metric	Value
dl	0
loc	5
ccs	1
cts	1
cp	1
rs	9.4285
c	0
b	0
f	0
cc	1
eloc	3
nc	1
nop	2
crap	1

<?php
namespace ApacheSolrForTypo3\Solr\IndexQueue;

/***************************************************************
 *  Copyright notice
 *
 *  (c) 2010-2015 Ingo Renner <[email protected]>
 *  All rights reserved
 *
 *  This script is part of the TYPO3 project. The TYPO3 project is
 *  free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 3 of the License, or
 *  (at your option) any later version.
 *
 *  The GNU General Public License can be found at
 *  http://www.gnu.org/copyleft/gpl.html.
 *
 *  This script is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  This copyright notice MUST APPEAR in all copies of the script!
 ***************************************************************/

use ApacheSolrForTypo3\Solr\System\Configuration\ExtensionConfiguration;
use ApacheSolrForTypo3\Solr\System\Logging\SolrLogManager;
use TYPO3\CMS\Core\Utility\GeneralUtility;

/**
 * Index Queue Page Indexer request with details about which actions to perform.
 *
 * @author Ingo Renner <[email protected]>
 */
class PageIndexerRequest
{

    /**
     * List of actions to perform during page rendering.
     *
     * @var array
     */
    protected $actions = [];

    /**
     * Parameters as sent from the Index Queue page indexer.
     *
     * @var array
     */
    protected $parameters = [];

    /**
     * Headers as sent from the Index Queue page indexer.
     *
     * @var array
     */
    protected $header = [];

    /**
     * Unique request ID.
     *
     * @var string
     */
    protected $requestId;

    /**
     * Username to use for basic auth protected URLs.
     *
     * @var string
     */
    protected $username = '';

    /**
     * Password to use for basic auth protected URLs.
     *
     * @var string
     */
    protected $password = '';

    /**
     * An Index Queue item related to this request.
     *
     * @var Item
     */
    protected $indexQueueItem = null;

    /**
     * Request timeout in seconds
     *
     * @var float
     */
    protected $timeout;

    /**
     * @var \ApacheSolrForTypo3\Solr\System\Logging\SolrLogManager
     */
    protected $logger = null;

    /**
     * @var ExtensionConfiguration
     */
    protected $extensionConfiguration;

    /**
     * PageIndexerRequest constructor.
     *
     * @param string $jsonEncodedParameters json encoded header
     * @param SolrLogManager|null $solrLogManager
     * @param ExtensionConfiguration|null $extensionConfiguration
     */
    public function __construct($jsonEncodedParameters = null, SolrLogManager $solrLogManager = null, ExtensionConfiguration $extensionConfiguration = null)
    {
        $this->requestId = uniqid();
        $this->timeout = (float)ini_get('default_socket_timeout');

        $this->logger = is_null($solrLogManager) ? GeneralUtility::makeInstance(SolrLogManager::class, __CLASS__) : $solrLogManager;
        $this->extensionConfiguration = is_null($extensionConfiguration) ? GeneralUtility::makeInstance(ExtensionConfiguration::class) : $extensionConfiguration;

        if (is_null($jsonEncodedParameters)) {
            return;
        }

        $this->parameters = (array)json_decode($jsonEncodedParameters, true);
        $this->requestId = $this->parameters['requestId'];
        unset($this->parameters['requestId']);

        $actions = explode(',', $this->parameters['actions']);
        foreach ($actions as $action) {
            $this->addAction($action);
        }
        unset($this->parameters['actions']);
    }

    /**
     * Adds an action to perform during page rendering.
     *
     * @param string $action Action name.
     */
    public function addAction($action)
    {
        $this->actions[] = $action;
    }

    /**
     * Executes the request.
     *
     * Uses headers to submit additional data and avoiding to have these
     * arguments integrated into the URL when created by RealURL.
     *
     * @param string $url The URL to request.
     * @return PageIndexerResponse Response
     */
    public function send($url)
    {
        /** @var $response PageIndexerResponse */
        $response = GeneralUtility::makeInstance(PageIndexerResponse::class);
        $decodedResponse = $this->getUrlAndDecodeResponse($url, $response);

        if ($decodedResponse['requestId'] != $this->requestId) {
            throw new \RuntimeException(
                'Request ID mismatch. Request ID was ' . $this->requestId . ', received ' . $decodedResponse['requestId'] . '. Are requests cached?',
                1351260655
            );
        }

        $response->setRequestId($decodedResponse['requestId']);

        if (!is_array($decodedResponse['actionResults'])) {
            // nothing to parse
            return $response;
        }

        foreach ($decodedResponse['actionResults'] as $action => $actionResult) {
            $response->addActionResult($action, $actionResult);
        }

        return $response;
    }

    /**
     * This method is used to retrieve an url from the frontend and decode the response.
     *
     * @param string $url
     * @param PageIndexerResponse $response
     * @return mixed
     */
    protected function getUrlAndDecodeResponse($url, PageIndexerResponse $response)
    {
        $headers = $this->getHeaders();
        $rawResponse = $this->getUrl($url, $headers, $this->timeout);
        // convert JSON response to response object properties
        $decodedResponse = $response->getResultsFromJson($rawResponse);

        if ($rawResponse === false || $decodedResponse === false) {
            $this->logger->log(
                SolrLogManager::ERROR,
                'Failed to execute Page Indexer Request. Request ID: ' . $this->requestId,
                [
                    'request ID' => $this->requestId,
                    'request url' => $url,
                    'request headers' => $headers,
                    'response headers' => $http_response_header, // automatically defined by file_get_contents()
                    'raw response body' => $rawResponse
                ]
            );

            throw new \RuntimeException('Failed to execute Page Indexer Request. See log for details. Request ID: ' . $this->requestId, 1319116885);
        }
        return $decodedResponse;
    }

    /**
     * Generates the headers to be send with the request.
     *
     * @return string[] Array of HTTP headers.
     */
    public function getHeaders()
    {
        $headers = $this->header;
        $headers[] = $this->getUserAgent();
        $itemId = $this->indexQueueItem->getIndexQueueUid();
        $pageId = $this->indexQueueItem->getRecordPageId();

        $indexerRequestData = [
            'requestId' => $this->requestId,
            'item' => $itemId,
            'page' => $pageId,
            'actions' => implode(',', $this->actions),
            'hash' => md5(
                $itemId . '|' .
                $pageId . '|' .
                $GLOBALS['TYPO3_CONF_VARS']['SYS']['encryptionKey']
            )
        ];

        $indexerRequestData = array_merge($indexerRequestData, $this->parameters);
        $headers[] = 'X-Tx-Solr-Iq: ' . json_encode($indexerRequestData);

        if (!empty($this->username) && !empty($this->password)) {
            $headers[] = 'Authorization: Basic ' . base64_encode($this->username . ':' . $this->password);
        }

        return $headers;
    }

    /**
     * @return string
     */
    protected function getUserAgent()
    {
        return $GLOBALS['TYPO3_CONF_VARS']['HTTP']['headers']['User-Agent'] ?? 'TYPO3';
    }

    /**
     * Adds an HTTP header to be send with the request.
     *
     * @param string $header HTTP header
     */
    public function addHeader($header)
    {
        $this->header[] = $header;
    }

    /**
     * Checks whether this is a legitimate request coming from the Index Queue
     * page indexer worker task.
     *
     * @return bool TRUE if it's a legitimate request, FALSE otherwise.
     */
    public function isAuthenticated()
    {
        $authenticated = false;

        if (is_null($this->parameters)) {
            return $authenticated;
        }

        $calculatedHash = md5(
            $this->parameters['item'] . '|' .
            $this->parameters['page'] . '|' .
            $GLOBALS['TYPO3_CONF_VARS']['SYS']['encryptionKey']
        );

        if ($this->parameters['hash'] === $calculatedHash) {
            $authenticated = true;
        }

        return $authenticated;
    }

    /**
     * Gets the list of actions to perform during page rendering.
     *
     * @return array List of actions
     */
    public function getActions()
    {
        return $this->actions;
    }

    /**
     * Gets the request's parameters.
     *
     * @return array Request parameters.
     */
    public function getParameters()
    {
        return $this->parameters;
    }

    /**
     * Gets the request's unique ID.
     *
     * @return string Unique request ID.
     */
    public function getRequestId()
    {
        return $this->requestId;
    }

    /**
     * Gets a specific parameter's value.
     *
     * @param string $parameterName The parameter to retrieve.
     * @return mixed NULL if a parameter was not set or it's value otherwise.
     */
    public function getParameter($parameterName)
    {
        return isset($this->parameters[$parameterName]) ? $this->parameters[$parameterName] : null;
    }

    /**
     * Sets a request's parameter and its value.
     *
     * @param string $parameter Parameter name
     * @param string $value Parameter value.
     */
    public function setParameter($parameter, $value)
    {
        if (is_bool($value)) {
            $value = $value ? '1' : '0';
        }

        $this->parameters[$parameter] = $value;
    }

    /**
     * Sets username and password to be used for a basic auth request header.
     *
     * @param string $username username.
     * @param string $password password.
     */
    public function setAuthorizationCredentials($username, $password)
    {
        $this->username = $username;
        $this->password = $password;
    }

    /**
     * Sets the Index Queue item this request is related to.
     *
     * @param Item $item Related Index Queue item.
     */
    public function setIndexQueueItem(Item $item)
    {
        $this->indexQueueItem = $item;
    }

    /**
     * Returns the request timeout in seconds
     *
     * @return float
     */
    public function getTimeout()
    {
        return $this->timeout;
    }

    /**
     * Sets the request timeout in seconds
     *
     * @param float $timeout Timeout seconds
     */
    public function setTimeout($timeout)
    {
        $this->timeout = (float)$timeout;
    }

    /**
     * Fetches a page by sending the configured headers.
     *
     * @param string $url
     * @param string[] $headers
     * @param float $timeout
     * @return string
     */
    protected function getUrl($url, $headers, $timeout)
    {
        $options = [
            'http' => [
                'header' => implode(CRLF, $headers),
                'timeout' => $timeout
            ],
        ];

        if ($this->extensionConfiguration->getIsSelfSignedCertificatesEnabled()) {
            $options['ssl'] = [
                'verify_peer' => false,
                'allow_self_signed'=> true
            ];
        }

        $context = stream_context_create($options);
        $rawResponse = file_get_contents($url, false, $context);
        return $rawResponse;
    }
}


1		<?php
2		namespace ApacheSolrForTypo3\Solr\IndexQueue;
3
4		/***************************************************************
5		* Copyright notice
6		*
7		* (c) 2010-2015 Ingo Renner <[email protected]>
8		* All rights reserved
9		*
10		* This script is part of the TYPO3 project. The TYPO3 project is
11		* free software; you can redistribute it and/or modify
12		* it under the terms of the GNU General Public License as published by
13		* the Free Software Foundation; either version 3 of the License, or
14		* (at your option) any later version.
15		*
16		* The GNU General Public License can be found at
17		* http://www.gnu.org/copyleft/gpl.html.
18		*
19		* This script is distributed in the hope that it will be useful,
20		* but WITHOUT ANY WARRANTY; without even the implied warranty of
21		* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22		* GNU General Public License for more details.
23		*
24		* This copyright notice MUST APPEAR in all copies of the script!
25		***************************************************************/
26
27		use ApacheSolrForTypo3\Solr\System\Configuration\ExtensionConfiguration;
28		use ApacheSolrForTypo3\Solr\System\Logging\SolrLogManager;
29		use TYPO3\CMS\Core\Utility\GeneralUtility;
30
31		/**
32		* Index Queue Page Indexer request with details about which actions to perform.
33		*
34		* @author Ingo Renner <[email protected]>
35		*/
36		class PageIndexerRequest
37		{
38
39		/**
40		* List of actions to perform during page rendering.
41		*
42		* @var array
43		*/
44		protected $actions = [];
45
46		/**
47		* Parameters as sent from the Index Queue page indexer.
48		*
49		* @var array
50		*/
51		protected $parameters = [];
52
53		/**
54		* Headers as sent from the Index Queue page indexer.
55		*
56		* @var array
57		*/
58		protected $header = [];
59
60		/**
61		* Unique request ID.
62		*
63		* @var string
64		*/
65		protected $requestId;
66
67		/**
68		* Username to use for basic auth protected URLs.
69		*
70		* @var string
71		*/
72		protected $username = '';
73
74		/**
75		* Password to use for basic auth protected URLs.
76		*
77		* @var string
78		*/
79		protected $password = '';
80
81		/**
82		* An Index Queue item related to this request.
83		*
84		* @var Item
85		*/
86		protected $indexQueueItem = null;
87
88		/**
89		* Request timeout in seconds
90		*
91		* @var float
92		*/
93		protected $timeout;
94
95		/**
96		* @var \ApacheSolrForTypo3\Solr\System\Logging\SolrLogManager
97		*/
98		protected $logger = null;
99
100		/**
101		* @var ExtensionConfiguration
102		*/
103		protected $extensionConfiguration;
104
105		/**
106		* PageIndexerRequest constructor.
107		*
108		* @param string $jsonEncodedParameters json encoded header
109		* @param SolrLogManager\|null $solrLogManager
110		* @param ExtensionConfiguration\|null $extensionConfiguration
111		*/
112	21	public function __construct($jsonEncodedParameters = null, SolrLogManager $solrLogManager = null, ExtensionConfiguration $extensionConfiguration = null)
113		{
114	21	$this->requestId = uniqid();
115	21	$this->timeout = (float)ini_get('default_socket_timeout');
116
117	21	$this->logger = is_null($solrLogManager) ? GeneralUtility::makeInstance(SolrLogManager::class, __CLASS__) : $solrLogManager;
118	21	$this->extensionConfiguration = is_null($extensionConfiguration) ? GeneralUtility::makeInstance(ExtensionConfiguration::class) : $extensionConfiguration;
119
120	21	if (is_null($jsonEncodedParameters)) {
121	14	return;
122		}
123
124	7	$this->parameters = (array)json_decode($jsonEncodedParameters, true);
125	7	$this->requestId = $this->parameters['requestId'];
126	7	unset($this->parameters['requestId']);
127
128	7	$actions = explode(',', $this->parameters['actions']);
129	7	foreach ($actions as $action) {
130	7	$this->addAction($action);
131		}
132	7	unset($this->parameters['actions']);
133	7	}
134
135		/**
136		* Adds an action to perform during page rendering.
137		*
138		* @param string $action Action name.
139		*/
140	8	public function addAction($action)
141		{
142	8	$this->actions[] = $action;
143	8	}
144
145		/**
146		* Executes the request.
147		*
148		* Uses headers to submit additional data and avoiding to have these
149		* arguments integrated into the URL when created by RealURL.
150		*
151		* @param string $url The URL to request.
152		* @return PageIndexerResponse Response
153		*/
154	5	public function send($url)
155		{
156		/** @var $response PageIndexerResponse */
157	5	$response = GeneralUtility::makeInstance(PageIndexerResponse::class);
158	5	$decodedResponse = $this->getUrlAndDecodeResponse($url, $response);
159
160	4	if ($decodedResponse['requestId'] != $this->requestId) {
161	1	throw new \RuntimeException(
162	1	'Request ID mismatch. Request ID was ' . $this->requestId . ', received ' . $decodedResponse['requestId'] . '. Are requests cached?',
163	1	1351260655
164		);
165		}
166
167	3	$response->setRequestId($decodedResponse['requestId']);
168
169	3	if (!is_array($decodedResponse['actionResults'])) {
170		// nothing to parse
171		return $response;
172		}
173
174	3	foreach ($decodedResponse['actionResults'] as $action => $actionResult) {
175	3	$response->addActionResult($action, $actionResult);
176		}
177
178	3	return $response;
179		}
180
181		/**
182		* This method is used to retrieve an url from the frontend and decode the response.
183		*
184		* @param string $url
185		* @param PageIndexerResponse $response
186		* @return mixed
187		*/
188	5	protected function getUrlAndDecodeResponse($url, PageIndexerResponse $response)
189		{
190	5	$headers = $this->getHeaders();
191	5	$rawResponse = $this->getUrl($url, $headers, $this->timeout);
192		// convert JSON response to response object properties
193	5	$decodedResponse = $response->getResultsFromJson($rawResponse);
194
195	5	if ($rawResponse === false \|\| $decodedResponse === false) {
196	1	$this->logger->log(
197	1	SolrLogManager::ERROR,
198	1	'Failed to execute Page Indexer Request. Request ID: ' . $this->requestId,
199		[
200	1	'request ID' => $this->requestId,
201	1	'request url' => $url,
202	1	'request headers' => $headers,
203	1	'response headers' => $http_response_header, // automatically defined by file_get_contents()
204	1	'raw response body' => $rawResponse
205		]
206		);
207
208	1	throw new \RuntimeException('Failed to execute Page Indexer Request. See log for details. Request ID: ' . $this->requestId, 1319116885);
209		}
210	4	return $decodedResponse;
211		}
212
213		/**
214		* Generates the headers to be send with the request.
215		*
216		* @return string[] Array of HTTP headers.
217		*/
218	6	public function getHeaders()
219		{
220	6	$headers = $this->header;
221	6	$headers[] = $this->getUserAgent();
222	6	$itemId = $this->indexQueueItem->getIndexQueueUid();
223	6	$pageId = $this->indexQueueItem->getRecordPageId();
224
225		$indexerRequestData = [
226	6	'requestId' => $this->requestId,
227	6	'item' => $itemId,
228	6	'page' => $pageId,
229	6	'actions' => implode(',', $this->actions),
230	6	'hash' => md5(
231	6	$itemId . '\|' .
232	6	$pageId . '\|' .
233	6	$GLOBALS['TYPO3_CONF_VARS']['SYS']['encryptionKey']
234		)
235		];
236
237	6	$indexerRequestData = array_merge($indexerRequestData, $this->parameters);
238	6	$headers[] = 'X-Tx-Solr-Iq: ' . json_encode($indexerRequestData);
239
240	6	if (!empty($this->username) && !empty($this->password)) {
241	1	$headers[] = 'Authorization: Basic ' . base64_encode($this->username . ':' . $this->password);
242		}
243
244	6	return $headers;
245		}
246
247		/**
248		* @return string
249		*/
250		protected function getUserAgent()
251		{
252		return $GLOBALS['TYPO3_CONF_VARS']['HTTP']['headers']['User-Agent'] ?? 'TYPO3';
253		}
254
255		/**
256		* Adds an HTTP header to be send with the request.
257		*
258		* @param string $header HTTP header
259		*/
260		public function addHeader($header)
261		{
262		$this->header[] = $header;
263	2	}
264
265	2	/**
266		* Checks whether this is a legitimate request coming from the Index Queue
267	2	* page indexer worker task.
268		*
269		* @return bool TRUE if it's a legitimate request, FALSE otherwise.
270		*/
271	2	public function isAuthenticated()
272	2	{
273	2	$authenticated = false;
274	2
275		if (is_null($this->parameters)) {
276		return $authenticated;
277	2	}
278	1
279		$calculatedHash = md5(
280		$this->parameters['item'] . '\|' .
281	2	$this->parameters['page'] . '\|' .
282		$GLOBALS['TYPO3_CONF_VARS']['SYS']['encryptionKey']
283		);
284
285		if ($this->parameters['hash'] === $calculatedHash) {
286		$authenticated = true;
287		}
288
289		return $authenticated;
290		}
291
292		/**
293		* Gets the list of actions to perform during page rendering.
294		*
295		* @return array List of actions
296		*/
297		public function getActions()
298		{
299		return $this->actions;
300		}
301
302		/**
303		* Gets the request's parameters.
304		*
305		* @return array Request parameters.
306		*/
307		public function getParameters()
308		{
309	3	return $this->parameters;
310		}
311	3
312		/**
313		* Gets the request's unique ID.
314		*
315		* @return string Unique request ID.
316		*/
317		public function getRequestId()
318		{
319		return $this->requestId;
320	11	}
321
322	11	/**
323		* Gets a specific parameter's value.
324		*
325		* @param string $parameterName The parameter to retrieve.
326		* @return mixed NULL if a parameter was not set or it's value otherwise.
327		*/
328		public function getParameter($parameterName)
329		{
330		return isset($this->parameters[$parameterName]) ? $this->parameters[$parameterName] : null;
331	12	}
332
333	12	/**
334	1	* Sets a request's parameter and its value.
335		*
336		* @param string $parameter Parameter name
337	12	* @param string $value Parameter value.
338	12	*/
339		public function setParameter($parameter, $value)
340		{
341		if (is_bool($value)) {
342		$value = $value ? '1' : '0';
343		}
344
345		$this->parameters[$parameter] = $value;
346	1	}
347
348	1	/**
349	1	* Sets username and password to be used for a basic auth request header.
350	1	*
351		* @param string $username username.
352		* @param string $password password.
353		*/
354		public function setAuthorizationCredentials($username, $password)
355		{
356		$this->username = $username;
357	6	$this->password = $password;
358		}
359	6
360	6	/**
361		* Sets the Index Queue item this request is related to.
362		*
363		* @param Item $item Related Index Queue item.
364		*/
365		public function setIndexQueueItem(Item $item)
366		{
367	1	$this->indexQueueItem = $item;
368		}
369	1
370		/**
371		* Returns the request timeout in seconds
372		*
373		* @return float
374		*/
375		public function getTimeout()
376		{
377		return $this->timeout;
378		}
379
380		/**
381		* Sets the request timeout in seconds
382		*
383		* @param float $timeout Timeout seconds
384		*/
385		public function setTimeout($timeout)
386		{
387		$this->timeout = (float)$timeout;
388		}
389
390	1	/**
391		* Fetches a page by sending the configured headers.
392		*
393		* @param string $url
394	1	* @param string[] $headers
395	1	* @param float $timeout
396		* @return string
397		*/
398		protected function getUrl($url, $headers, $timeout)
399	1	{
400		$options = [
401		'http' => [
402		'header' => implode(CRLF, $headers),
403		'timeout' => $timeout
404		],
405		];
406	1
407	1	if ($this->extensionConfiguration->getIsSelfSignedCertificatesEnabled()) {
408	1	$options['ssl'] = [
409		'verify_peer' => false,
410		'allow_self_signed'=> true
411		];
412		}
413
414		$context = stream_context_create($options);
415		$rawResponse = file_get_contents($url, false, $context);
416		return $rawResponse;
417		}
418		}
419

TYPO3-Solr / ext-solr

Push — master ( c00acb...6ee2a7 )

PageIndexerRequest::setAuthorizationCredentials() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like