Webrouse\AssetMacro\Utils

Complexity

Total Complexity

7

Size/Duplication

Total Lines	53
Duplicated Lines	0 %

Coupling/Cohesion

Components	0
Dependencies	1

Test Coverage

Coverage

82.35%

Importance

Changes

0

2 Methods

Rating	Name	Duplication	Size	Complexity
A	normalizePath()	0	23	3
A	throwError()	0	11	4

<?php

namespace Webrouse\AssetMacro;

use Webrouse\AssetMacro\Exceptions\InvalidPathException;


class Utils
{

	/**
	 * @param string $path
	 * @param string $separator
	 * @return string
	 */
	public static function normalizePath($path, $separator = '\\/')
	{
		// Remove any kind of unicode whitespace
		$normalized = preg_replace('#\p{C}+|^\./#u', '', $path);

		// Path remove self referring paths ("/./").
		$normalized = preg_replace('#/\.(?=/)|^\./|\./$#', '', $normalized);

		// Regex for resolving relative paths
		$regex = '#\/*[^/\.]+/\.\.#Uu';

		while (preg_match($regex, $normalized)) {
			$normalized = preg_replace($regex, '', $normalized);
		}

		if (preg_match('#/\.{2}|\.{2}/#', $normalized)) {
			throw new InvalidPathException(
				sprintf("Path is outside of the defined root, path: '%s', resolved: '%s'.", $path, $normalized)
			);
		}

		return rtrim($normalized, $separator);
	}


	/**
	 * Throw exception, trigger error or ignore according of action
	 * @param \Exception $e
	 * @param string $action
	 * @param bool $need
	 * @throws \Exception
	 */
	public static function throwError(\Exception $e, $action = 'exception', $need = TRUE)
	{
		if ($need) {
			if ($action === 'exception') {
				throw $e;

			} elseif ($action === 'notice') {
				trigger_error($e->getMessage(), E_USER_NOTICE);
			}
		}
	}

}