Mini File Manager

Edit File

<?php

/**
 * @file plugins/generic/usageStats/UsageStatsLoader.php
 *
 * Copyright (c) 2013-2020 Simon Fraser University
 * Copyright (c) 2003-2020 John Willinsky
 * Distributed under the GNU GPL v3. For full terms see the file docs/COPYING.
 *
 * @class UsageStatsLoader
 * @ingroup plugins_generic_usageStats
 *
 * @brief Scheduled task to extract transform and load usage statistics data into database.
 */

import('lib.pkp.classes.task.FileLoader');

/** These are rules defined by the COUNTER project.
 * See https://www.projectcounter.org/code-of-practice-sections/data-processing/#returncodesandtimefilters */
define('COUNTER_DOUBLE_CLICK_TIME_FILTER_SECONDS_HTML', 10);
define('COUNTER_DOUBLE_CLICK_TIME_FILTER_SECONDS_OTHER', 30);

class UsageStatsLoader extends FileLoader {

/** @var A GeoLocationTool object instance to provide geo location based on ip. */
	var $_geoLocationTool;

/** @var $_plugin Plugin */
	var $_plugin;

/** @var $_contextsByPath array */
	var $_contextsByPath;

/** @var $_autoStage string */
	var $_autoStage;

/** @var $_externalLogFiles string */
	var $_externalLogFiles;

/**
	 * Constructor.
	 * @param $argv array task arguments
	 */
	function __construct($args) {
		$plugin = PluginRegistry::getPlugin('generic', 'usagestatsplugin'); /* @var $plugin UsageStatsPlugin */
		$this->_plugin = $plugin;

if ($plugin->getSetting(CONTEXT_ID_NONE, 'compressArchives')) {
			$this->setCompressArchives(true);
		}

$arg = current($args);

switch ($arg) {
			case 'autoStage':
				if ($plugin->getSetting(0, 'createLogFiles')) {
					$this->_autoStage = true;
				}
				break;
			case 'externalLogFiles':
				$this->_externalLogFiles = true;
				break;
		}

// Define the base filesystem path.
		$args[0] = $plugin->getFilesPath();

parent::__construct($args);

if ($plugin->getEnabled()) {
			// Load the metric type constant.
			PluginRegistry::loadCategory('reports');

import('classes.statistics.StatisticsHelper');
			$statsHelper = new StatisticsHelper();
			$geoLocationTool = $statsHelper->getGeoLocationTool();
			$this->_geoLocationTool = $geoLocationTool;

$plugin->import('UsageStatsTemporaryRecordDAO');
			$statsDao = new UsageStatsTemporaryRecordDAO();
			DAORegistry::registerDAO('UsageStatsTemporaryRecordDAO', $statsDao);

$contextDao = Application::getContextDAO(); /* @var $contextDao ContextDAO */
			$contextFactory = $contextDao->getAll(); /* @var $contextFactory DAOResultFactory */
			$contextsByPath = array();
			while ($context = $contextFactory->next()) { /* @var $context Context */
				$contextsByPath[$context->getPath()] = $context;
			}
			$this->_contextsByPath = $contextsByPath;

$this->checkFolderStructure(true);

}
	}

/**
	 * @copydoc FileLoader::getName()
	 */
	function getName() {
		return __('plugins.generic.usageStats.usageStatsLoaderName');
	}

/**
	* @copydoc FileLoader::executeActions()
	*/
	protected function executeActions() {
		$plugin = $this->_plugin;
		if (!$plugin->getEnabled()) {
			$this->addExecutionLogEntry(__('plugins.generic.usageStats.pluginNotEnabled'), SCHEDULED_TASK_MESSAGE_TYPE_WARNING);
			return false;
		}

// It's possible that the processing directory has files that
		// were being processed but the php process was stopped before
		// finishing the processing, or there may be a concurrent process running.
		// Warn the user if this is the case.
		$processingDirFiles = glob($this->getProcessingPath() . DIRECTORY_SEPARATOR . '*');
		$processingDirError = is_array($processingDirFiles) && count($processingDirFiles);
		if ($processingDirError) {
			$this->addExecutionLogEntry(__('plugins.generic.usageStats.processingPathNotEmpty', array('directory' => $this->getProcessingPath())), SCHEDULED_TASK_MESSAGE_TYPE_ERROR);
		}

if ($this->_autoStage) $this->autoStage();

return (parent::executeActions() && !$processingDirError);
	}

/**
	 * @copydoc FileLoader::processFile()
	 * The file must be a log file parsable by the regex in _getDataFromLogEntry()
	 * and the file's entries must be ordered by date-time to successfully identify double-clicks
	 */
	protected function processFile($filePath) {
		$fhandle = fopen($filePath, 'r');
		$geoTool = $this->_geoLocationTool;
		if (!$fhandle) {
			throw new Exception(__('plugins.generic.usageStats.openFileFailed', array('file' => $filePath)));
		}

$loadId = basename($filePath);
		$statsDao = DAORegistry::getDAO('UsageStatsTemporaryRecordDAO'); /* @var $statsDao UsageStatsTemporaryRecordDAO */

// Make sure we don't have any temporary records associated
		// with the current load id in database.
		$statsDao->deleteByLoadId($loadId);

$lastInsertedEntries = array();
		$lineNumber = 0;

while(!feof($fhandle)) {
			$lineNumber++;
			$line = trim(fgets($fhandle));
			if (empty($line) || substr($line, 0, 1) === "#") continue; // Spacing or comment lines.
			$entryData = $this->_getDataFromLogEntry($line);
			if (!$this->_isLogEntryValid($entryData, $lineNumber)) {
				throw new Exception(__('plugins.generic.usageStats.invalidLogEntry',
					array('file' => $filePath, 'lineNumber' => $lineNumber)));
			}

// Avoid internal apache requests.
			if ($entryData['url'] == '*') continue;

// Avoid non sucessful requests.
			$sucessfulReturnCodes = array(200, 304);
			if (!in_array($entryData['returnCode'], $sucessfulReturnCodes)) continue;

// Avoid bots.
			if (Core::isUserAgentBot($entryData['userAgent'])) continue;

list($assocType, $contextPaths, $page, $op, $args) = $this->_getUrlMatches($entryData['url'], $filePath, $lineNumber);
			if ($assocType && $contextPaths && $page && $op) {
				list($assocId, $assocType) = $this->getAssoc($assocType, $contextPaths, $page, $op, $args);
			} else {
				$assocId = $assocType = null;
			}

if(!$assocId || !$assocType) continue;

$countryCode = $cityName = $region = null;
			$plugin = $this->_plugin;
			if (!$plugin->getSetting(CONTEXT_ID_NONE, 'dataPrivacyOption')) {
				list($countryCode, $cityName, $region) = $geoTool ? $geoTool->getGeoLocation($entryData['ip']) : array(null, null, null);
				// Check optional columns setting.
				$optionalColumns = $plugin->getSetting(CONTEXT_ID_NONE, 'optionalColumns');
				if (!in_array(STATISTICS_DIMENSION_CITY, $optionalColumns)) $cityName = null;
				if (!in_array(STATISTICS_DIMENSION_REGION, $optionalColumns)) $cityName = $region = null;
			}
			$day = date('Ymd', $entryData['date']);

$type = $this->getFileTypeFromAssoc($assocType, $assocId);

// Implement double click filtering.
			$entryHash = $assocType . $assocId . $entryData['ip'];

// Clean the last inserted entries, removing the entries that have
			// no importance for the time between requests check.
			$biggestTimeFilter = COUNTER_DOUBLE_CLICK_TIME_FILTER_SECONDS_OTHER;
			foreach($lastInsertedEntries as $hash => $time) {
				if ($time + $biggestTimeFilter < $entryData['date']) {
					unset($lastInsertedEntries[$hash]);
				}
			}

// Time between requests check.
			if (isset($lastInsertedEntries[$entryHash])) {
				// Decide what time filter to use, depending on object type.
				if ($type == STATISTICS_FILE_TYPE_PDF || $type == STATISTICS_FILE_TYPE_OTHER) {
					$timeFilter = COUNTER_DOUBLE_CLICK_TIME_FILTER_SECONDS_OTHER;
				} else {
					$timeFilter = COUNTER_DOUBLE_CLICK_TIME_FILTER_SECONDS_HTML;
				}

$secondsBetweenRequests = $entryData['date'] - $lastInsertedEntries[$entryHash];
				if ($secondsBetweenRequests < $timeFilter) {
					// We have to store the last access,
					// so we delete the most recent one.
					$statsDao->deleteRecord($assocType, $assocId, $lastInsertedEntries[$entryHash], $loadId);
				}
			}

$lastInsertedEntries[$entryHash] = $entryData['date'];
			$statsDao->insert($assocType, $assocId, $day, $entryData['date'], $countryCode, $region, $cityName, $type, $loadId);
		}

fclose($fhandle);
		$loadResult = $this->_loadData($loadId);
		$statsDao->deleteByLoadId($loadId);

if (!$loadResult) {
			$this->addExecutionLogEntry(__('plugins.generic.usageStats.loadDataError',
				array('file' => $filePath)), SCHEDULED_TASK_MESSAGE_TYPE_ERROR);
			return FILE_LOADER_RETURN_TO_STAGING;
		} else {
			return true;
		}
	}

//
	// Protected methods.
	//
	/**
	 * Get metric type on which this loader process statistics.
	 */
	protected function getMetricType() {
		$application = Application::get();
		$applicationName = $application->getName();
		switch ($applicationName) {
			case 'ojs2':
				return OJS_METRIC_TYPE_COUNTER;
				break;
			case 'omp':
				return OMP_METRIC_TYPE_COUNTER;
				break;
			case 'ops':
				return OPS_METRIC_TYPE_COUNTER;
				break;
			default:
				assert(false);
		}
	}

//
	// Protected methods.
	//
	/**
	 * Auto stage usage stats log files, also moving files that
	 * might be in processing folder to stage folder.
	 */
	protected function autoStage() {
		$plugin = $this->_plugin;

// Copy all log files to stage directory, except the current day one.
		$fileMgr = new FileManager();
		$logFiles = array();
		$logsDirFiles =  glob($plugin->getUsageEventLogsPath() . DIRECTORY_SEPARATOR . '*');
		// It's possible that the processing directory have files that
		// were being processed but the php process was stopped before
		// finishing the processing. Just copy them to the stage directory too.
		$processingDirFiles = glob($this->getProcessingPath() . DIRECTORY_SEPARATOR . '*');
		if (is_array($logsDirFiles)) {
			$logFiles = array_merge($logFiles, $logsDirFiles);
		}

if (is_array($processingDirFiles)) {
			$logFiles = array_merge($logFiles, $processingDirFiles);
		}

foreach ($logFiles as $filePath) {
			// Make sure it's a file.
			if ($fileMgr->fileExists($filePath)) {
				// Avoid current day file.
				$filename = pathinfo($filePath, PATHINFO_BASENAME);
				$currentDayFilename = $plugin->getUsageEventCurrentDayLogName();
				if ($filename == $currentDayFilename) continue;
				$this->moveFile(pathinfo($filePath, PATHINFO_DIRNAME), $this->getStagePath(), $filename);
			}
		}
	}

/**
	* Based on the passed object data, get the file type.
	* @param $assocType int
	* @param $assocId int
	* @return mixed int|null Return one of the file types
	* constants STATISTICS_FILE_TYPE... if the
	* object is a file, if not, return null.
	*/
	protected function getFileTypeFromAssoc($assocType, $assocId) {
		// Check downloaded file type, if any.
		$file = null;
		$type = null;
		if ($assocType == ASSOC_TYPE_SUBMISSION_FILE || $assocType == ASSOC_TYPE_SUBMISSION_FILE_COUNTER_OTHER) {
			$file = Services::get('submissionFile')->get($assocId);
		}

if ($file) $type = $this->getFileTypeFromFile($file);

if (!$type) {
			$application = Application::get();
			$applicationName = $application->getName();
			switch ($applicationName) {
				case 'ojs2':
					$type = $this->getOJSFileTypeFromAssoc($assocType, $assocId);
					break;
			}
		}
		return $type;
	}

/**
	 * Based on the passed object data, get the OJS specific file type.
	 * @param $assocType int
	 * @param $assocId int
	 * @return mixed int|null Return one of the file types
	 * constants STATISTICS_FILE_TYPE... if the
	 * object is a file, if not, return null.
	 */
	function getOJSFileTypeFromAssoc($assocType, $assocId) {
		$type = null;
		switch ($assocType) {
			case ASSOC_TYPE_ISSUE_GALLEY:
				$issueGalleyDao = DAORegistry::getDAO('IssueGalleyDAO');
				$issueGalley = $issueGalleyDao->getById($assocId);
				$type = $this->getFileTypeFromFile($issueGalley);
				break;
		}
		return $type;
	}

/**
	 * Associate the passed file type with one of the file
	 * type statistics constants.
	 * @param $file PKPFile
	 * @return int One of the file type constants STATISTICS_FILE_TYPE...
	 */
	protected function getFileTypeFromFile($file) {
		if (is_a($file, 'SubmissionFile')) {
			$path = $file->getData('path');
			$mimetype = $file->getData('mimetype');
			$fileExtension = pathinfo($path, PATHINFO_EXTENSION);
		} elseif (is_a($file, 'PKPFile')) {
			$mimetype = $file->getFileType();
			$fileExtension = pathinfo($file->getOriginalFileName(), PATHINFO_EXTENSION);
		} else {
			throw new Exception('Wrong object type. Expected SubmissionFile or PKPFile. Got ' . get_class($file));
		}
		switch ($mimetype) {
			case 'application/pdf':
			case 'application/x-pdf':
			case 'text/pdf':
			case 'text/x-pdf':
				$type = STATISTICS_FILE_TYPE_PDF;
				break;
			case 'application/octet-stream':
				if ($fileExtension == 'pdf') {
					$type = STATISTICS_FILE_TYPE_PDF;
				} else {
					$type = STATISTICS_FILE_TYPE_OTHER;
				}
				break;
			case 'application/msword':
				$type = STATISTICS_FILE_TYPE_DOC;
				break;
			case 'application/zip':
				if ($fileExtension == 'docx') {
					$type = STATISTICS_FILE_TYPE_DOC;
				} else {
					$type = STATISTICS_FILE_TYPE_OTHER;
				}
				break;
			case 'text/html':
				$type = STATISTICS_FILE_TYPE_HTML;
				break;
			default:
				$type = STATISTICS_FILE_TYPE_OTHER;
		}

return $type;
	}

/**
	 * Get assoc type and id from the passed page, operation and
	 * arguments.
	 * @param $assocType ASSOC_TYPE_...
	 * @param $contextPaths array
	 * @param $page string
	 * @param $op string
	 * @param $args array
	 * @return array (assocId, assocType)
	 */
	protected function getAssoc($assocType, $contextPaths, $page, $op, $args) {
		$assocId = $assocTypeToReturn = null;
		switch ($assocType) {
			case ASSOC_TYPE_SUBMISSION:
				$publicationId = null;
				if (!isset($args[0])) break;
				// If the operation is 'view' and the arguments count > 1
				// the arguments must be: $submissionId/version/$publicationId.
				// Else, it is not considered hier, as submission abstract count.
				if ($op == 'view' && count($args) > 1) {
					if ($args[1] !== 'version') break;
					else if (count($args) != 3) break;
					$publicationId = (int) $args[2];
				}
				$submissionId = $args[0];
				$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /* @var $submissionDao SubmissionDAO */
				$submission = $submissionDao->getById($submissionId);
				if ($submission) {
					if ($publicationId) {
						$publicationDao = DAORegistry::getDAO('PublicationDAO'); /* @var $publicationDao PublicationDAO */
						$publicationExists = $publicationDao->exists($publicationId, $submissionId);
						if (!$publicationExists) break;
					}
					$assocId = $submission->getId();
					$assocTypeToReturn = $assocType;
				}
				break;
			case Application::getContextAssocType():
				$context = $this->getContextByPath($contextPaths);
				if ($context) {
					$assocId = $context->getId();
					$assocTypeToReturn = $assocType;
				}
				break;
		}

// Object not found, return no assoc info at all.
		if (!$assocId) $assocTypeToReturn = null;

if (!$assocId && !$assocTypeToReturn) {
			$application = Application::get();
			$applicationName = $application->getName();
			switch ($applicationName) {
				case 'ojs2':
					list($assocId, $assocTypeToReturn) = $this->getOJSAssoc($assocType, $contextPaths, $page, $op, $args);
					break;
				case 'omp':
					list($assocId, $assocTypeToReturn) = $this->getOMPAssoc($assocType, $contextPaths, $page, $op, $args);
					break;
				case 'ops':
					list($assocId, $assocTypeToReturn) = $this->getOPSAssoc($assocType, $contextPaths, $page, $op, $args);
					break;
			}
		}
		return array($assocId, $assocTypeToReturn);
	}

/**
	 * Get assoc type and id from the passed page, operation and
	 * arguments specific to OJS.
	 * @param $assocType ASSOC_TYPE_...
	 * @param $contextPaths array
	 * @param $page string
	 * @param $op string
	 * @param $args array
	 * @return array (assocId, assocType)
	 */
	protected function getOJSAssoc($assocType, $contextPaths, $page, $op, $args) {
		$assocId = $assocTypeToReturn = null;
		switch ($assocType) {
			case ASSOC_TYPE_SUBMISSION_FILE:
				if (!isset($args[0])) break;
				$submissionId = $args[0];
				$submissionDao = DAORegistry::getDAO('SubmissionDAO'); /* @var $submissionDao SubmissionDAO */
				$article = $submissionDao->getById($submissionId);
				if (!$article) break;

// consider this issue: https://github.com/pkp/pkp-lib/issues/6573
				// apache log files contain URL download/submissionId/galleyId, i.e. without third argument
				if (!isset($args[2])) {
					if (!isset($args[1])) break;
					$galleyId = $args[1];
					$galleyDao = DAORegistry::getDAO('ArticleGalleyDAO');
					$galley = $galleyDao->getById($galleyId);
					if (!$galley) break;
					$fileId = $galley->getData('submissionFileId');
					if (!$fileId) break;
				} else {
					$fileId = $args[2];
				}
				$articleFile = Services::get('submissionFile')->get($fileId);
				if (!$articleFile) break;

$assocId = $articleFile->getId();

// is the file article full text
				$genreDao = DAORegistry::getDAO('GenreDAO');
				$genre = $genreDao->getById($articleFile->getGenreId());
				if ($genre->getCategory() != GENRE_CATEGORY_DOCUMENT || $genre->getSupplementary() || $genre->getDependent()) {
					$assocTypeToReturn = ASSOC_TYPE_SUBMISSION_FILE_COUNTER_OTHER;
				} else {
					$assocTypeToReturn = $assocType;
				}
				break;
			case ASSOC_TYPE_ISSUE:
				// consider issue https://github.com/pkp/pkp-lib/issues/6611
				// apache log files contain both URLs for issue galley download:
				// issue/view/issueId/galleyId (that should not be considered here), as well as
				// issue/download/issueId/galleyId (that will be then considered below)
				if (!isset($args[0]) || count($args) != 1) break;
				$issueId = $args[0];
				$issueDao = DAORegistry::getDAO('IssueDAO');
				if (isset($this->_contextsByPath[current($contextPaths)])) {
					$context =  $this->_contextsByPath[current($contextPaths)];
					$issue = $issueDao->getById($issueId, $context->getId());
					if (!$issue) break;
					$assocId = $issue->getId();
					$assocTypeToReturn = $assocType;
				} else {
					break;
				}
				break;
			case ASSOC_TYPE_ISSUE_GALLEY:
				if (!isset($args[0]) || !isset($args[1])) break;
				$issueId = $args[0];
				$issueDao = DAORegistry::getDAO('IssueDAO');
				if (isset($this->_contextsByPath[current($contextPaths)])) {
					$context =  $this->_contextsByPath[current($contextPaths)];
					$issue = $issueDao->getById($issueId, $context->getId());
					if (!$issue) break;
				} else {
					break;
				}
				$issueGalleyId = $args[1];
				$issueGalleyDao = DAORegistry::getDAO('IssueGalleyDAO');
				$issueGalley = $issueGalleyDao->getById($issueGalleyId, $issue->getId());
				if (!$issueGalley) break;
				$assocId = $issueGalley->getId();
				$assocTypeToReturn = $assocType;
				break;
		}
		return array($assocId, $assocTypeToReturn);
	}

/**
	* @param $assocType ASSOC_TYPE_...
	* @param $contextPaths array
	* @param $page string
	* @param $op string
	* @param $args array
	* @return array (assocId, assocType)
	*/
	protected function getOMPAssoc($assocType, $contextPaths, $page, $op, $args) {
		$assocId = $assocTypeToReturn = null;
		switch ($assocType) {
			case ASSOC_TYPE_SUBMISSION_FILE:
				if (!isset($args[0])) break;
				$submission = Services::get('submission')->get($args[0]);
				if (!$submission) break;

if (!isset($args[2])) break;
				$fileId = $args[2];
				$file = Services::get('submissionFile')->get($fileId);
				if (!$file) break;
				if ($file) {
					$assocId = $file->getId();
				}

$assocTypeToReturn = $assocType;
				break;
			case ASSOC_TYPE_SERIES:
				if (!isset($args[0])) break;
				$seriesPath = $args[0];
				$seriesDao = Application::getSectionDAO(); /* @var $seriesDao SeriesDAO */
				if (isset($this->_contextsByPath[current($contextPaths)])) {
					$context =  $this->_contextsByPath[current($contextPaths)];
					$series = $seriesDao->getByPath($seriesPath, $context->getId());
					if ($series) {
						$assocId = $series->getId();
					}
				}

$assocTypeToReturn = $assocType;
				break;
		}

return array($assocId, $assocTypeToReturn);
	}

/**
	 * Get assoc type and id from the passed page, operation and
	 * arguments specific to OPS.
	 * @param $assocType ASSOC_TYPE_...
	 * @param $contextPaths array
	 * @param $page string
	 * @param $op string
	 * @param $args array
	 * @return array (assocId, assocType)
	 */
	protected function getOPSAssoc($assocType, $contextPaths, $page, $op, $args) {
		$assocId = $assocTypeToReturn = null;
		switch ($assocType) {
			case ASSOC_TYPE_SUBMISSION_FILE:
				if (!isset($args[0])) break;
				$submissionId = $args[0];
				$submissionDao = DAORegistry::getDAO('SubmissionDAO');
				$article = $submissionDao->getById($submissionId);
				if (!$article) break;

$assocId = $articleFile->getId();

/**
	 * Get the context object based on the context path
	 * array that's returned by Core::getContextPaths()
	 * @param $contextPaths array
	 * @return mixed null|Context
	 * @see Core::getContextPaths()
	 */
	protected function getContextByPath($contextPaths) {
		$application = Application::get();
		$deepestContextDepthIndex = $application->getContextDepth() - 1;
		$contextPath = $contextPaths[$deepestContextDepthIndex];

$context = null;
		if (isset($this->_contextsByPath[$contextPath])) {
			$context = $this->_contextsByPath[$contextPath];
		}

return $context;
	}

/**
	* Get the expected page and operation from the stats plugin.
	* They are grouped by the object type constant that
	* they give access to.
	* @return array
	*/
	protected function getExpectedPageAndOp() {
		$pageAndOp = array(
			Application::getContextAssocType() => array(
				'index/index'
			)
		);
		$application = Application::get();
		$applicationName = $application->getName();
		switch ($applicationName) {
			case 'ojs2':
				$pageAndOp = $pageAndOp + array(
					ASSOC_TYPE_SUBMISSION_FILE => array(
						'article/download'),
					ASSOC_TYPE_SUBMISSION => array(
						'article/view'),
					ASSOC_TYPE_ISSUE => array(
						'issue/view'),
					ASSOC_TYPE_ISSUE_GALLEY => array(
						'issue/download')
				);
				$pageAndOp[Application::getContextAssocType()][] = 'index';
				break;
			case 'omp':
				$pageAndOp = $pageAndOp + array(
					ASSOC_TYPE_SUBMISSION_FILE => array(
						'catalog/download'),
					ASSOC_TYPE_MONOGRAPH => array(
						'catalog/book'),
					ASSOC_TYPE_SERIES => array(
						'catalog/series')
				);
				$pageAndOp[Application::getContextAssocType()][] = 'catalog/index';
				break;
			case 'ops':
				$pageAndOp = $pageAndOp + array(
					ASSOC_TYPE_SUBMISSION_FILE => array(
						'preprint/download'),
					ASSOC_TYPE_SUBMISSION => array(
						'preprint/view')
				);
				$pageAndOp[Application::getContextAssocType()][] = 'index';
				break;
		}
		return $pageAndOp;
	}

//
	// Private helper methods.
	//
	/**
	 * Validate a access log entry.
	 * @param $entry array
	 * @param $lineNumber integer
	 * @return boolean
	 */
	private function _isLogEntryValid($entry, $lineNumber) {
		if (empty($entry)) {
			return false;
		}

$date = $entry['date'];
		if (!is_numeric($date) && $date <= 0) {
			return false;
		}

return true;
	}

/**
	 * Get data from the passed log entry.
	 * @param $entry string
	 * @return mixed array
	 */
	private function _getDataFromLogEntry($entry) {
		$plugin = $this->_plugin; /* @var $plugin Plugin */
		$createLogFiles = $plugin->getSetting(0, 'createLogFiles');
		if (!$createLogFiles || $this->_externalLogFiles) {
			// User wants to process log files that were not created by
			// the usage stats plugin. Try to get a user defined regex to
			// parse those external log files then.
			$parseRegex = $plugin->getSetting(0, 'accessLogFileParseRegex');
		} else {
			// Regex to parse this plugin's log access files.
			$parseRegex = '/^(?P<ip>\S+) \S+ \S+ "(?P<date>.*?)" (?P<url>\S+) (?P<returnCode>\S+) "(?P<userAgent>.*?)"/';
		}

// The default regex will parse only apache log files in combined format.
		if (!$parseRegex) $parseRegex = '/^(?P<ip>\S+) \S+ \S+ \[(?P<date>.*?)\] "\S+ (?P<url>\S+).*?" (?P<returnCode>\S+) \S+ ".*?" "(?P<userAgent>.*?)"/';

$returner = array();
		if (preg_match($parseRegex, $entry, $m)) {
			$associative = count(array_filter(array_keys($m), 'is_string')) > 0;
			$returner['ip'] = $associative ? $m['ip'] : $m[1];
			$returner['date'] = strtotime($associative ? $m['date'] : $m[2]);
			$returner['url'] = urldecode($associative ? $m['url'] : $m[3]);
			$returner['returnCode'] = $associative ? $m['returnCode'] : $m[4];
			$returner['userAgent'] = $associative ? $m['userAgent'] : $m[5];
		}

return $returner;
	}

/**
	 * Get assoc type, page. operation and args from
	 * the passed url, if it matches anyone that's defined
	 * in UsageStatsLoader::getExpectedPageAndOp().
	 * @param $url string
	 * @param $filePath string
	 * @param $lineNumber int
	 * @return array
	 * @see UsageStatsLoader::getExpectedPageAndOp()
	 */
	private function _getUrlMatches($url, $filePath, $lineNumber) {
		$noMatchesReturner = array(null, null, null, null, null);
		// Check the passed url.
		$expectedPageAndOp = $this->getExpectedPageAndOp();

$pathInfoDisabled = Config::getVar('general', 'disable_path_info');

// Apache and usage stats plugin log files comes with complete or partial
		// base url, remove it so system can retrieve path, page,
		// operation and args.
		$url = Core::removeBaseUrl($url);
		if ($url) {
			$contextPaths = Core::getContextPaths($url, !$pathInfoDisabled);
			$page = Core::getPage($url, !$pathInfoDisabled);
			$operation = Core::getOp($url, !$pathInfoDisabled);
			$args = Core::getArgs($url, !$pathInfoDisabled);
		} else {
			// Could not remove the base url, can't go on.
			$this->addExecutionLogEntry( __('plugins.generic.usageStats.removeUrlError',
				array('file' => $filePath, 'lineNumber' => $lineNumber)), SCHEDULED_TASK_MESSAGE_TYPE_WARNING);
			return $noMatchesReturner;
		}

// See bug #8698#.
		if (is_array($contextPaths) && !$page && $operation == 'index') {
			$page = 'index';
		}

if (empty($contextPaths) || !$page || !$operation) return $noMatchesReturner;

$pageAndOperation = $page . '/' . $operation;

$pageAndOpMatch = false;
		// It matches the expected ones?
		foreach ($expectedPageAndOp as $workingAssocType => $workingPageAndOps) {
			foreach($workingPageAndOps as $workingPageAndOp) {
				if ($pageAndOperation == $workingPageAndOp) {
					// Expected url, don't look any futher.
					$pageAndOpMatch = true;
					break 2;
				}
			}
		}

if ($pageAndOpMatch) {
			return array($workingAssocType, $contextPaths, $page, $operation, $args);
		} else {
			return $noMatchesReturner;
		}
	}

/**
	 * Load the entries inside the temporary database associated with
	 * the passed load id to the metrics table.
	 * @param $loadId string The current load id.
	 * file path.
	 * @return boolean Whether or not the process
	 * was successful.
	 */
	private function _loadData($loadId) {
		$statsDao = DAORegistry::getDAO('UsageStatsTemporaryRecordDAO'); /* @var $statsDao UsageStatsTemporaryRecordDAO */
		$metricsDao = DAORegistry::getDAO('MetricsDAO'); /* @var $metricsDao PKPMetricsDAO */
		$metricsDao->purgeLoadBatch($loadId);

$records = $statsDao->getByLoadId($loadId);
		foreach ($records as $record) {
			$record = (array) $record;
			$record['metric_type'] = $this->getMetricType();
			$metricsDao->insertRecord($record);
		}

return true;
	}

}