<?php
namespace GemSecurity;

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * The one place the plugin resolves where WordPress keeps things.
 *
 * Content, plugin, must-use and upload folders can each be moved
 * independently, so every lookup goes through WordPress' own constants and
 * functions here instead of being assembled from the content folder. Paths
 * are normalised (forward slashes) and returned without a trailing slash,
 * except {@see root()}, which keeps it so root-relative paths append cleanly.
 */
class Paths {

	/** WordPress install root (where core lives), normalised, trailing slash. */
	public static function root() {
		return trailingslashit( wp_normalize_path( ABSPATH ) );
	}

	/** The content folder — where WordPress loads drop-ins from. */
	public static function content() {
		return untrailingslashit( wp_normalize_path( WP_CONTENT_DIR ) );
	}

	/**
	 * The plugins folder: the parent of this plugin's own folder, so it follows
	 * wherever the site keeps its plugins.
	 */
	public static function plugins() {
		return untrailingslashit( wp_normalize_path( dirname( untrailingslashit( GEMSECURITY_ROOT_DIR_PATH ) ) ) );
	}

	/**
	 * WordPress' own includes folder, found from where core defines one of its
	 * functions rather than from a constant or a hard-coded folder name.
	 */
	public static function includes() {
		static $dir = null;
		if ( null === $dir ) {
			$file = function_exists( 'wp_die' ) ? ( new \ReflectionFunction( 'wp_die' ) )->getFileName() : false;
			$dir  = untrailingslashit( wp_normalize_path( $file ? dirname( $file ) : self::root() . 'wp-includes' ) );
		}
		return $dir;
	}

	/** The must-use plugins folder. */
	public static function mu() {
		return untrailingslashit( wp_normalize_path( WPMU_PLUGIN_DIR ) );
	}

	/** The uploads base folder (not created if missing). */
	public static function uploads() {
		return untrailingslashit( wp_normalize_path( wp_upload_dir( null, false )['basedir'] ) );
	}

	/**
	 * Root-relative, forward-slashed form of an absolute path.
	 *
	 * @param string $path
	 * @return string
	 */
	public static function relative( $path ) {
		return str_replace( self::root(), '', wp_normalize_path( (string) $path ) );
	}
}