silverstripe-framework/src/Core/Manifest/ModuleResource.php

<?php

namespace SilverStripe\Core\Manifest;

use InvalidArgumentException;
use SilverStripe\Core\Injector\Injector;

/**
 * This object represents a single resource file attached to a module, and can be used
 * as a reference to this to be later turned into either a URL or file path.
 */
class ModuleResource
{
    /**
     * @var Module
     */
    protected $module = null;

    /**
     * Path to this resource relative to the module (no leading slash)
     *
     * @var string
     */
    protected $relativePath = null;

    /**
     * ModuleResource constructor.
     *
     * @param Module $module
     * @param string $relativePath
     */
    public function __construct(Module $module, $relativePath)
    {
        $this->module = $module;
        $this->relativePath = ltrim($relativePath, Module::TRIM_CHARS);
        if (empty($this->relativePath)) {
            throw new InvalidArgumentException("Resource cannot have empty path");
        }
    }

    /**
     * Return the full filesystem path to this resource.
     *
     * Note: In the case that this resource is mapped to the `resources` folder, this will
     * return the original rather than the copy / symlink.
     *
     * @return string Path with no trailing slash E.g. /var/www/module
     */
    public function getPath()
    {
        return $this->module->getPath() . '/' . $this->relativePath;
    }

    /**
     * Get the path of this resource relative to the base path.
     *
     * Note: In the case that this resource is mapped to the `resources` folder, this will
     * return the original rather than the copy / symlink.
     *
     * @return string Relative path (no leading /)
     */
    public function getRelativePath()
    {
        $path = $this->module->getRelativePath() . '/' . $this->relativePath;
        return ltrim($path, Module::TRIM_CHARS);
    }

    /**
     * Public URL to this resource.
     * Note: May be either absolute url, or root-relative url
     *
     * In the case that this resource is mapped to the `resources` folder this
     * will be the mapped url rather than the original path.
     *
     * @return string
     */
    public function getURL()
    {
        /** @var ResourceURLGenerator $generator */
        $generator = Injector::inst()->get(ResourceURLGenerator::class);
        return $generator->urlForResource($this->getRelativePath());
    }

    /**
     * Synonym for getURL() for APIs that expect a Link method
     *
     * @return mixed
     */
    public function Link()
    {
        return $this->getURL();
    }

    /**
     * Determine if this resource exists
     *
     * @return bool
     */
    public function exists()
    {
        return file_exists($this->getPath());
    }

    /**
     * Get relative path
     *
     * @return string
     */
    public function __toString()
    {
        return $this->getRelativePath();
    }

    /**
     * @return Module
     */
    public function getModule()
    {
        return $this->module;
    }
}