singlequote/laravel-webdav

1.1.1 2024-06-07 12:41 UTC

This package is auto-updated.

Last update: 2024-10-10 08:14:26 UTC


README

A webdav driver for laravel filesystem

Latest Version on Packagist Total Downloads

Installation

composer require singlequote/laravel-webdav

Usage

Add the new entries to your .env

WEBDAV_BASEURL=""
WEBDAV_USERNAME=
WEBDAV_PASSWORD=

# Optional
WEBDAV_PROXY=
WEBDAV_PATHPREFIX=""
WEBDAV_AUTHTYPE=
WEBDAV_ENCODING=

Add the new entries to the config

config/filesystems.php

'disks' => [
	...
	'webdav' => [
	    'driver'     => 'webdav',
	    'baseUri'    => env("WEBDAV_BASEURL"),
	    'userName'   => env("WEBDAV_USERNAME"),
	    'password'   => env("WEBDAV_PASSWORD"),
	    'pathPrefix' => env("WEBDAV_PATHPREFIX", ''),

	    // Optional prameters
	    // 'proxy'      => env("WEBDAV_PROXY", 'locahost:8888'),
	    // 'authType'   => env("WEBDAV_AUTHTYPE", null),
	    // 'encoding'   => env("WEBDAV_ENCODING", null),
	],
	...
];

After adding the config entry you can use it in your storage driver.

Laravel filesystem

Storage::disk('webdav')->files('...')

Config

Proxy

When using your webdav server behind a proxy, use the proxy config parameter to set our proxy url

'webdav' => [
	...
	'proxy'      => env("WEBDAV_PROXY", 'locahost:8888'),
]

AuthType

If you know which authentication method will be used, it's recommended to set it, as it will save a great deal of requests to 'discover' this information.

'webdav' => [
	...
	'authType'      => env("WEBDAV_AUTHTYPE", 1), // 1 = Uses Basic authentication
]

Possible authTypes listed below

Encoding

This wil set the encoding parameter.

'webdav' => [
	...
	'encoding'      => env("WEBDAV_ENCODING", 1), // 1 = Uses Identity encoding
]

Possible encoding types listed below

Contributing

Please see CONTRIBUTING for details.

Postcardware

You're free to use this package, but if it makes it to your production environment we highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using.

Our address is: Quotec, Traktieweg 8c 8304 BA, Emmeloord, Netherlands.

Credits

License

The MIT License (MIT). Please see License File for more information.