silverstripe/vendor-plugin

Allows vendor modules to expose directories to the webroot

1.0.1 2017-10-20 03:03 UTC

README

When installing SilverStripe modules in the vendor directory it may also be necessary to ensure certain module assets are exposed to the webroot, as the 'vendor' url prefix is blocked from web-access by default.

Example

For example, given the below module composer.json:

{
    "name": "tractorcow/anothermodule",
    "description": "a test module",
    "type": "silverstripe-vendormodule",
    "extra": {
        "expose": [
            "client"
        ]
    },
    "require": {
        "silverstripe/vendor-plugin": "^1.0",
        "silverstripe/framework": "^4.0"
    }
}

This will be installed into the vendor/tractorcow/anothermodule folder, and a symlink will be created in resources/tractorcow/anothermodule/client, allowing the web server to serve resources from the vendor folder without exposing any code or other internal server files.

Note: The module type silverstripe-vendormodule is mandatory, as this behaviour is not enabled for libraries of other types.

Customising behaviour

By default the plugin will attempt to perform a symlink, failing back to a full filesystem copy.

If necessary, you can force the behaviour to one of the below using the SS_VENDOR_METHOD environment variable (set in your system environment prior to install):

  • none - Disables all symlink / copy
  • copy - Performs a copy only
  • symlink - Performs a symlink only
  • auto -> Perfrm symlink, but fail over to copy.

Any other value will be treated as auto