NAME

HTTP::DAV::Nginx - Client library for Nginx WebDAV server

SYNOPSIS

  use HTTP::DAV::Nginx;
  
  $dav = HTTP::DAV::Nginx -> new('http://host.org:8080/dav/');
  or
  $dav = HTTP::DAV::Nginx -> new('http://host.org:8080/dav/', die_on_errors => 1);
  
  unless ($dav -> mkcol('/test'))
  {
    print "ERROR:" . $dav -> err;
  }
  
  $dav -> put('/test/123', data => 'Hello');

  $dav -> copy('/test/123', '/test2/12345');
  
  $dav -> move('/test/123', '/test3/123456');
  
  $dav -> delete('/test2/12345');
  
  $ua = $dav -> useragent;

DESCRIPTION

NGINX "supports" WebDAV by means of a module, but this support is incomplete: it only handles the WebDAV methods PUT, DELETE, MKCOL, COPY, and MOVE, and leaves the necessary OPTIONS and PROPFIND (and the optional LOCK, UNLOCK, and PROPPATCH) methods unimplemented.

This module doesn't uses PROPFIND and OPTIONS commands for work.

METHODS

new(URI, [PARAMS])

Create a new HTTP::DAV::Nginx object;

    my $dav = HTTP::DAV::Nginx -> new('http://host.org:8080/dav/');
    or 
    HTTP::DAV::Nginx -> new('http://host.org:8080/dav/', die_on_errors => 1);

PARAMS:

die_on_errors - die if error

warn_on_errors - warn if error

mkcol(URI)

creates a new dir at the location specified by the URI

copy(SRC_URI, DEST_URI)

creates a duplicate of the source resource identified by URI

    $dav -> copy('/uri', '/uri2');

SRC_URI - source URI

DEST_URI - destination URI

PARAMS:

depth - copy depth (0, infinity)

owerwrite - overwrite existing files (1 - overwrite, 0 - don't)

move(SRC_URI, DEST_URI, [PARAMS])

used to move a resource to the location specified by a URI

    $dav -> move('/uri', '/uri2');
    $dav -> move('/uri', '/uri2', overwrite => 1);

SRC_URI - source URI

DEST_URI - destination URI

PARAMS:

depth - move depth (0, infinity)

overwrite - overwrite existing files (1 - overwrite, 0 - don't)

put(URI, DATA_TYPE => DATA)

used to put data in a new resource specified by a URI

    $dav -> put('/uri', data => 'Hello');
    $dav -> put('/uri', file => '/etc/passwd');
    $dav -> put('/uri', fh => $fh);

DATA_TYPE - type of data:

data - scalar data

file - filename

fh - filehandle

DATA - scalar data or filename or filehandle

delete(URI, [PARAMS])

deletes a resource at the specified

    $dav -> delete('/uri');
    $dav -> delete('uri', depth => 'infinity');

useragent

return LWP::UserAgent object for custom options (i.e. proxy, cookie etc)

err

return last error string

SEE ALSO

LWP::UserAgent

AUTHOR

Dmitry Kosenkov, <d.kosenkov AT rambler-co.ru>, <junker AT front.ru>

COPYRIGHT AND LICENSE

Copyright (C) 2011 by Dmitry Kosenkov

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.14.1 or, at your option, any later version of Perl 5 you may have available.