| 1 |
// $Id: INSTALL.txt,v 1.2 2008/05/08 09:52:46 arto Exp $
|
| 2 |
|
| 3 |
NOTE: This is experimental software meant for advanced users; assume nothing
|
| 4 |
works, and you may be pleasantly surprised. And when it breaks, you get to
|
| 5 |
keep both pieces.
|
| 6 |
|
| 7 |
REQUIREMENTS
|
| 8 |
------------
|
| 9 |
This module requires Drupal 6.x and PHP 5.2.x (or newer). Additional PEAR
|
| 10 |
library requirements are detailed below.
|
| 11 |
|
| 12 |
____________
|
| 13 |
To use the DAV server, you MUST have the prerequisite PEAR
|
| 14 |
HTTP_WebDAV_Server package [1] installed.
|
| 15 |
|
| 16 |
Due to licensing differences, PEAR packages can't be distributed directly
|
| 17 |
with Drupal modules. However, provided your server has the PEAR command line
|
| 18 |
tools available, HTTP_WebDAV_Server is easy enough to install. On Unix-like
|
| 19 |
servers, just run the following command as root to install the package and
|
| 20 |
make it available system-wide:
|
| 21 |
|
| 22 |
# pear install HTTP_WebDAV_Server
|
| 23 |
|
| 24 |
On older PEAR versions, you may instead need to specify the explicit package
|
| 25 |
URL as follows:
|
| 26 |
|
| 27 |
# pear install \
|
| 28 |
http://download.pear.php.net/package/HTTP_WebDAV_Server-1.0.0RC4.tgz
|
| 29 |
|
| 30 |
Failing system-wide installation (if you're on a shared server, for
|
| 31 |
instance), you can manually download the package from [1] and install the
|
| 32 |
files locally in your Drupal instance as follows (you only need these four
|
| 33 |
files, and they must be installed with the shown paths):
|
| 34 |
|
| 35 |
modules/dav/vendor/HTTP/WebDAV/Server.php
|
| 36 |
modules/dav/vendor/HTTP/WebDAV/Tools/_parse_propfind.php
|
| 37 |
modules/dav/vendor/HTTP/WebDAV/Tools/_parse_proppatch.php
|
| 38 |
modules/dav/vendor/HTTP/WebDAV/Tools/_parse_lockinfo.php
|
| 39 |
|
| 40 |
____________
|
| 41 |
To enable the included DAV client support, which allows PHP applications
|
| 42 |
(including other Drupal modules) to use the "webdav://" and "webdavs://"
|
| 43 |
protocol stream wrappers [2], you MUST have the PEAR HTTP_WebDAV_Client
|
| 44 |
package [3] installed.
|
| 45 |
|
| 46 |
Again, provided a properly working PEAR environment, installation is simple:
|
| 47 |
|
| 48 |
# pear install HTTP_WebDAV_Client
|
| 49 |
|
| 50 |
Or, on older PEAR versions:
|
| 51 |
|
| 52 |
# pear install \
|
| 53 |
http://download.pear.php.net/package/HTTP_WebDAV_Client-0.9.7.tgz
|
| 54 |
|
| 55 |
Manual installation would proceed similarly as for the DAV server (see
|
| 56 |
above), but involves several preliminary PEAR dependencies (at least
|
| 57 |
HTTP_Request, Net_URL, Net_Socket) and is left as an exercise for the
|
| 58 |
reader.
|
| 59 |
|
| 60 |
____________
|
| 61 |
[1] http://pear.php.net/package/HTTP_WebDAV_Server/ (1.0.0RC4 or later)
|
| 62 |
[2] http://php.net/stream
|
| 63 |
[3] http://pear.php.net/package/HTTP_WebDAV_Client/ (0.9.7 or later)
|
| 64 |
[4] http://pear.php.net/package/HTTP_Request/
|
| 65 |
|
| 66 |
|
| 67 |
INSTALLATION
|
| 68 |
------------
|
| 69 |
|
| 70 |
1. Copy all the module files into a subdirectory called modules/dav/
|
| 71 |
under your Drupal installation directory.
|
| 72 |
|
| 73 |
2. Go to Administer >> Site building >> Modules and enable the DAV API
|
| 74 |
and DAV FS modules.
|
| 75 |
|
| 76 |
3. Go to Administer >> Site configuration >> DAV settings to review and
|
| 77 |
change the configuration options to your liking (e.g. enable the DAV
|
| 78 |
server).
|