Menu
▾
▴
phpshell README,1.9,1.10 AUTHORS,1.7,NONE COPYING,1.2,NONE ChangeLog,1.7,NONE INSTALL,1.8,NONE SECURITY,1.2,NONE config.php,1.3,NONE phpshell.php,1.9,NONE pwhash.php,1.2,NONE style.css,1.2,NONE
|
From: Martin G. <mge...@us...> - 2006-04-29 13:28:20
|
Update of /cvsroot/phpshell/phpshell In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv7926 Modified Files: README Removed Files: AUTHORS COPYING ChangeLog INSTALL SECURITY config.php phpshell.php pwhash.php style.css Log Message: Removed files after the switch to Subversion. Please delete any CVS working copies you have and do a new checkout from Subversion. More information can be found here: http://sourceforge.net/svn/?group_id=156638 --- COPYING DELETED --- --- ChangeLog DELETED --- --- AUTHORS DELETED --- Index: README =================================================================== RCS file: /cvsroot/phpshell/phpshell/README,v retrieving revision 1.9 retrieving revision 1.10 diff -u -d -r1.9 -r1.10 --- README 4 Feb 2006 15:10:13 -0000 1.9 +++ README 29 Apr 2006 13:28:12 -0000 1.10 @@ -1,135 +1,14 @@ -README file for PHP Shell @VERSION@ -Copyright (C) 2000-2006 Martin Geisler <mge...@mg...> -Licensed under the GNU GPL. See the file COPYING for details. - -What is PHP Shell? -================== - -PHP Shell is a shell wrapped in a PHP script. It's a tool you can use -to execute arbitrary shell-commands or browse the filesystem on your -remote webserver. This replaces, to a degree, a normal telnet -connection, and to a lesser degree a SSH connection. - -You use it for administration and maintenance of your website, which -is often much easier to do if you can work directly on the server. -For example, you could use PHP Shell to unpack and move big files -around. All the normal command line programs like ps, free, du, df, -etc... can be used. - - -Limitations -=========== - -There are some limitations on what kind of programs you can run. It -won't do no good if you start a graphical program like Firefox or even -a console based one like vi. All programs have to be strictly command -line programs, and they will have no chance of getting user input -after they have been lunched. - -They probably also have to terminate within 30 seconds, as this is the -default time-limit imposed unto all PHP scripts, to prevent them from -running in an infinite loop. Your ISP may have set this time-limit to -something else. - -But you can rely on all the normal shell-functionality, like pipes, -output and input redirection, etc... (There is no <tab>-completion, -though :-) - - -Safe Mode -========= - -Safe Mode is the nemisis of PHP Shell. If PHP is running in Safe Mode -then PHP Shell will normally not work --- sorry. Please read the -detailed explaination in the SECURITY file. +********************************************************************* +* CVS README for PHP Shell * +********************************************************************* -Who am I? -========= - -(Well, my name is Martin, but that's not the point :-) - -You may not be the same user when using PHP Shell, as you are when you -upload your files with FTP. On some systems you will be ``nobody``, -on other systems you will become ``httpd`` or ``www-data``. This is a -rather dangerous "feature" of the way PHP is run by the webserver. A -possible effect of this is that you might end up creating files using -PHP Shell which you cannot delete afterwards using FTP and maybe not -even using PHP Shell. Strange, but true :-) - -If you want to execute code as different user, then it's possible to -do so by using the Sudo program available from this address: - - http://www.courtesan.com/sudo/ - -The trick is to configure Sudo to allow the user running the webserver -to execute certain commands as a more privileged user. This will have -to be done by the administrator of the server. Please refer to the -documentation for Sudo for further information about doing this. - - -How to Use It -============= - -When you point your browser at PHP Shell you will be asked to -authenticate yourself. By default no username/password will work, so -please go read INSTALL for information about adding a user. - -You're back? Good. Enter your username and password and press the -"Login" button. - -You will then be presented with a rather simple page containing -nothing much except a big window with the cursor blinking at the -bottom, signaling that it's ready to obey your commands. - -Write a command and press RET --- or alternatively, press the 'Execute -Command' button if you really want. The command will be executed and -the result will be shows in the terminal. You can now enter another -command. - -To be more precise: the terminal is updated with the command line you -have just executed, the output of the command to standard out -(stdout), and following that any error output sent to stderr. - -The commands are executed relative to a current working directory, -which is written at the top. You change this by the normal 'cd' -command. - - -Download -======== - -You can download the newest version of PHP Shell from - - http://mgeisler.net/php-shell/ - -The tarball/zipfile contains these files: - -phpshell.php - This is the script you run when you use PHP Shell. - -ChangeLog - This file describe the changes I've made to PHP Shell. By reading - it you'll always know when I've added a new feature or made a - bugfix, and the nature of the feature/bugfix. - -README - This file! :-) - -INSTALL - Tells you how to install PHP Shell. Amoung other things, it - explains how to change the password protection so that you can use - PHP Shell. +As of April 29th 2006, PHP Shell has switched from CVS to Subversion. +Please checkout the Subversion repository instead. - Remember that it's very important to have PHP Shell password - protected, or else everybody will be able so snoop into your files - and perhaps also be able to delete them! Please take the time to - protect your installation of PHP Shell. +Information about accessing the new repository can be found here: -SECURITY - A separate guide about security with PHP in general and PHP Shell in - particular. Be sure to read this too, especially if you are getting - strange errors back from PHP Shell. + http://sourceforge.net/svn/?group_id=156638 -COPYING - Standard GNU GPL. +-- +Martin Geisler <mge...@mg...> --- config.php DELETED --- --- style.css DELETED --- --- INSTALL DELETED --- --- pwhash.php DELETED --- --- phpshell.php DELETED --- --- SECURITY DELETED --- |
