Difference between revisions of "PhpWebFtp"

From SME Server
Jump to navigationJump to search
m (Commented out bugs section, as not available)
(29 intermediate revisions by 5 users not shown)
Line 1: Line 1:
== phpWebFTP for SME Server ==
 
 
 
=== Maintainer ===
 
=== Maintainer ===
 
[mailto:jean-paul@leclere.org jpl]
 
[mailto:jean-paul@leclere.org jpl]
 +
 +
=== Version ===
 +
{{ #smeversion: smeserver-phpwebftp}}
 +
  
 
=== Description ===
 
=== Description ===
Line 10: Line 12:
  
 
Access to the FTP frontend is only possible via https (http requests are redirected as https requests). You must provide your SME login and password.
 
Access to the FTP frontend is only possible via https (http requests are redirected as https requests). You must provide your SME login and password.
 +
 +
[[Image:smeserver-phpwebftp2.png]]
  
 
Two params can be set in the webftp record of the SME configuration db :
 
Two params can be set in the webftp record of the SME configuration db :
Line 18: Line 22:
  
 
=== Requirements ===
 
=== Requirements ===
You need nothing else than smeserver-phpwebftp package.
+
 
 +
{{Note box|The FTP service has to be enabled in your installation '''(Default is disabled)''', either in the [[SME_Server:Documentation:Administration_Manual:Chapter11#FTP|server-manager]] or by the command line below}}
 +
 
 +
config setprop ftp status enabled LoginAccess private access private
 +
signal-event remoteaccess-update
  
 
=== Installation ===
 
=== Installation ===
This contrib is currently held in jpl's smecontribs repository, so the following commands will install on your smeserver.
+
This contrib is held in smecontribs repository, so the following commands will install on your smeserver.
  
yum install http://mirror.contribs.org/smeserver/contribs/jpl/smecontribs/phpwebftp/smeserver-phpwebftp-4.0-1.noarch.rpm
+
  yum install --enablerepo=smecontribs smeserver-phpwebftp
  
 
You will then need to activate the database changes etc.
 
You will then need to activate the database changes etc.
Line 30: Line 38:
 
  signal-event post-upgrade;  signal-event reboot
 
  signal-event post-upgrade;  signal-event reboot
  
 +
or
 +
expand-template /home/httpd/html/webftp/config.inc.php
 +
expand-template /etc/httpd/conf/httpd.conf
 +
service httpd-e-smith restart
  
 
=== Uninstall ===
 
=== Uninstall ===
 
  yum remove smeserver-phpwebftp
 
  yum remove smeserver-phpwebftp
 +
 +
 +
=== Configuration ===
 +
thanks to config setprop webftp **** you will be able to change some options:
 +
 +
config show webftp
 +
webftp=configuration
 +
    ForceFtpVirtualLocalhost=yes
 +
    MaxFileSize=20000000
 +
    ResumeDownload=true
 +
    status=enabled
 +
 +
 +
'''ForceFtpVirtualLocalhost''' default yes
 +
config setprop webftp ForceFtpVirtualLocalhost yes
 +
 +
yes: will override DefaultRoot directive defined for each users <br />
 +
 +
no : will allow ftp connection as if an external ftp client were used: with respect to DefaultRoot directive
 +
 +
'''MaxFileSize''' default 20000000
 +
config setprop webftp MaxFileSize 20000000
 +
max size in octets you will allow to transfer thanks to php web ftp  . Be carrefull you are also limited to PHP    PostMaxSize and  UploadMaxFilesize directives.
 +
 +
 +
'''ResumeDownload''' default true
 +
config setprop webftp ResumeDownload true
 +
true: allow resume download
 +
false: do not allow resuming
 +
 +
'''status''' default enabled
 +
config setprop webftp status enabled
 +
enabled: allow php webftp to work<br />
 +
 +
disabled : prevents access to phpwebftp
 +
 +
=== Chroot of users  ===
 +
 +
you can chroot users in their home if you do not want they can see folder they don't own. For that you can install the [[Remoteuseraccess|remote-user-access contribs]]
 +
 +
see [[Remoteuseraccess#Global_Settings]] '''if the contribs is already installed'''
 +
 +
You can globally set FTP chroot with the following
 +
 +
You can chroot all users to their home directory with the command.
 +
config setprop ftp ChrootDir home
 +
 +
 +
to return to default settings of /home/e-smith/files/
 +
config delprop ftp ChrootDir
 +
 +
then enable
 +
expand-template /etc/proftpd.conf
 +
 +
=== known problems and bugs ====
 +
after installation : "Invalid language entered. Exiting script error when trying to connect".
 +
 +
solution :
 +
expand-template /home/httpd/html/webftp/config.inc.php
  
 
=== Source ===
 
=== Source ===
''The source for this contrib can be found in the smeserver [http://smeserver.cvs.sourceforge.net/smeserver/smeserver-foo/ CVS] on sourceforge.''Not already available
+
The source for this contrib can be found in the smeserver [http://fisheye1.atlassian.com/browse/smecontribs/rpms/smeserver-phpwebftp/ CVS] .
<!---=== Bugs ===
+
 
''Please raise bugs under the SME-Contribs section in [http://bugs.contribs.org/enter_bug.cgi bugzilla]
+
=== Bugs ===
and select the smeserver-phpwebftp component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-phpwebftp|title=this link}}.''
+
Please raise bugs under the SME-Contribs section in [http://bugs.contribs.org/enter_bug.cgi?product=SME%20Contribs bugzilla]
--->
+
and select the smeserver-phpwebftp component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-phpwebftp|title=this link}}.
<noinclude>[[Category: Contrib]]</noinclude>
+
{{#bugzilla:columns=id,product,version,status,summary |sort=id |order=desc |component=smeserver-phpwebftp|noresultsmessage="No open bugs found."}}
 +
 
 +
 
 +
===Changelog===
 +
Only released version in smecontrib are listed here.
 +
 
 +
{{ #smechangelog: smeserver-phpwebftp}}
 +
 
 +
<noinclude>[[Category: Contrib]] [[Category:Administration:Remote Access]]</noinclude>

Revision as of 10:36, 26 May 2016

Maintainer

jpl

Version

Contrib 9:
smeserver-phpwebftp
The latest version of smeserver-phpwebftp is available in the SME repository, click on the version number(s) for more information.



Description

This contribution for smeserver adds a web frontend which provides FTP connection with your SME server based upon the php GNU GPL application phpwebftp.

You can access your SME server FTP panel with your browser at url https://myserver.mydomain/webftp/

Access to the FTP frontend is only possible via https (http requests are redirected as https requests). You must provide your SME login and password.

Smeserver-phpwebftp2.png

Two params can be set in the webftp record of the SME configuration db :

MaxFilesSize nnnnnn : sets the maximum size in bytes of transferred files (default is 20000000)

ResumeDownload true|false : to enable/disable resuming of transferred files (default is true)

Requirements

Important.png Note:
The FTP service has to be enabled in your installation (Default is disabled), either in the server-manager or by the command line below


config setprop ftp status enabled LoginAccess private access private
signal-event remoteaccess-update

Installation

This contrib is held in smecontribs repository, so the following commands will install on your smeserver.

 yum install --enablerepo=smecontribs smeserver-phpwebftp

You will then need to activate the database changes etc. The 'official' way is to perform

signal-event post-upgrade;  signal-event reboot

or

expand-template /home/httpd/html/webftp/config.inc.php
expand-template /etc/httpd/conf/httpd.conf
service httpd-e-smith restart

Uninstall

yum remove smeserver-phpwebftp


Configuration

thanks to config setprop webftp **** you will be able to change some options:

config show webftp
webftp=configuration
   ForceFtpVirtualLocalhost=yes
   MaxFileSize=20000000
   ResumeDownload=true
   status=enabled


ForceFtpVirtualLocalhost default yes

config setprop webftp ForceFtpVirtualLocalhost yes

yes: will override DefaultRoot directive defined for each users

no : will allow ftp connection as if an external ftp client were used: with respect to DefaultRoot directive

MaxFileSize default 20000000

config setprop webftp MaxFileSize 20000000

max size in octets you will allow to transfer thanks to php web ftp . Be carrefull you are also limited to PHP PostMaxSize and UploadMaxFilesize directives.


ResumeDownload default true

config setprop webftp ResumeDownload true

true: allow resume download false: do not allow resuming

status default enabled

config setprop webftp status enabled

enabled: allow php webftp to work

disabled : prevents access to phpwebftp

Chroot of users

you can chroot users in their home if you do not want they can see folder they don't own. For that you can install the remote-user-access contribs

see Remoteuseraccess#Global_Settings if the contribs is already installed

You can globally set FTP chroot with the following

You can chroot all users to their home directory with the command.

config setprop ftp ChrootDir home


to return to default settings of /home/e-smith/files/

config delprop ftp ChrootDir

then enable

expand-template /etc/proftpd.conf

known problems and bugs =

after installation : "Invalid language entered. Exiting script error when trying to connect".

solution :

expand-template /home/httpd/html/webftp/config.inc.php

Source

The source for this contrib can be found in the smeserver CVS .

Bugs

Please raise bugs under the SME-Contribs section in bugzilla and select the smeserver-phpwebftp component or use this link .

IDProductVersionStatusSummary
10437SME Contribs9.2CONFIRMEDalternative to unmaintained phpwebftp script


Changelog

Only released version in smecontrib are listed here.