NAME

       WebCommon::setKayaUploadDir - Set a temporary directory for Kaya file uploads.

SYNOPSIS

       Void setKayaUploadDir( String newdir )

ARGUMENTS

       newdir The temporary directory.

DESCRIPTION

       User  file  uploads  are  placed  in  a  temporary directory. The default directory is the
       current directory for the CGI  program  or  webapp,  which  is  strongly  discouraged  for
       production  use.  There  are  two  ways  to  set the new temporary directory, which should
       ideally be an otherwise empty directory outside the  public  website,  only  readable  and
       writeable by the user the program runs as.

       Firstly, calling this function from within the CGI or webapp's webconfig function will set
       the directory. (Calls from any other location have no effect, because the  uploaded  files
       have already been saved to the temporary location by then!)

       Secondly,  if  this  function  has  not  been  used,  the HTTP_KAYA_UPLOAD_DIR environment
       variable (consult your webserver documentation for setting environment variables), will be
       read  and  used. This feature should not be used by application developers, who should use
       this function and provide an installer-configurable way to  set  the  directory  -  it  is
       intended  to provide a means for Kaya application users to deal with applications which do
       not use this function.

    webapp example;

    import Webapp;
    import HTMLDocument;

    Void webconfig() {
        allowFileUploads();
        setKayaUploadDir("/users/kaya/tmp");
    }

    HTMLDocument webmain() {
        // program goes here!
    }

       Note that  Kaya  (from  0.2.4  onwards)  will  not  accept  file  uploads  at  all  unless
       WebCommon.allowFileUploads (3kaya) is called first, so you don't need to use this function
       in applications that do not require file uploads unless your  Kaya  version  is  0.2.2  or
       0.2.3

AUTHORS

       Kaya  standard  library  by  Edwin Brady, Chris Morris and others (kaya@kayalang.org). For
       further information see http://kayalang.org/

LICENSE

       The Kaya standard library is free software; you can redistribute it and/or modify it under
       the  terms  of the GNU Lesser General Public License (version 2.1 or any later version) as
       published by the Free Software Foundation.

RELATED

       WebCommon.allowFileUploads (3kaya)
       WebCommon.setKayaMaxPost (3kaya)