Revision: 29 http://svn.sourceforge.net/phpshell/?rev=29&view=rev Author: mgeisler Date: 2007-03-17 08:43:42 -0700 (Sat, 17 Mar 2007)
Log Message: ----------- Added a basic webpage for PHP Shell. This is currently just a copy of the page at mgeisler.net. Important: use the push-to-sf.sh script to sync the live page at SourceForge after updating it in SVN. Added Paths: ----------- web/ web/htdocs/ web/htdocs/index.html web/htdocs/style.css web/push-to-sf.sh Added: web/htdocs/index.html =================================================================== --- web/htdocs/index.html (rev 0) +++ web/htdocs/index.html 2007-03-17 15:43:42 UTC (rev 29) @@ -0,0 +1,169 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE html + PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" > + +<head> + <title>PHP Shell</title> + <link href="style.css" type="text/css" rel="stylesheet" /> +</head> + +<body> + + <h1>PHP Shell</h1> + + <p>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.</p> + + <p>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.</p> + + <h2>Limitations</h2> + + <p>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 launched.</p> + + <p>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.</p> + + <p>But you can rely on all the normal shell-functionality, like + pipes, output and input redirection, etc… (There is no + <tab>-completion, though :-)</p> + + <h3>Safe Mode</h3> + + <p>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 <tt>SECURITY</tt> file included in the + PHP Shell distribution.</p> + + + <h2>Installation</h2> + + <p>PHP Shell is easy to install — download it and unpack it and + configure the password. This is done in <tt>config.php</tt>. Please + read the included <tt>INSTALL</tt> file for detailed + information.</p> + + + <h2>How to Use PHP Shell</h2> + + <p>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 <tt>INSTALL</tt> for information about adding a + user.</p> + + <p>You’re back? Good. Enter your username and password and press + “Login”.</p> + + <p>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.</p> + + <p>Write a command and press <tt>RET</tt> — 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.</p> + + <p>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.</p> + + <p>The commands are executed relative to a current working + directory, which is written at the top. You change this by the + normal ‘<tt>cd</tt>’ command.</p> + + + <h2>Donations</h2> + + <p>Please consider donating if you have found PHP Shell useful: <a + href="http://sourceforge.net/donate/index.php?group_id=156638"><img + src="http://images.sourceforge.net/images/project-support.jpg" + alt="Support PHP Shell" border="0" height="32" width="88" /></a></p> + + + <h2>Download</h2> + + <p>The latest version of PHP Shell is <b>2.1</b> from <b>December + 27, 2005</b>. Download it as</p> + + <ul> + <li><a href="http://prdownloads.sourceforge.net/phpshell/phpshell-2.1.tar.bz2?download">phpshell-2.1.tar.bz2</a></li> + <li><a href="http://prdownloads.sourceforge.net/phpshell/phpshell-2.1.zip?download">phpshell-2.1.zip</a></li> + </ul> + + <p>The tarball/zipfile contains these files:</p> + + <ul> + <li> + <p><tt>phpshell.php</tt>: This is the script you run when you + use PHP Shell.</p> + </li> + + <li> + <p><tt>config.php</tt>: Configuration file in the INI + format.</p> + </li> + + <li> + <p><tt>pwhash.php</tt>: Password hashing script. This is used to + generate secure hashed passwords which you should use to prevent + others from getting to know your password by reading the + config.php file.</p> + </li> + + <li> + <p><tt>ChangeLog</tt>: 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.</p> + </li> + + <li> + <p><tt>README</tt>: Approximately this page.</p> + </li> + + <li> + <p><tt>INSTALL</tt>: 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.</p> + + <p>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.</p> + </li> + + <li> + <p><tt>SECURITY</tt>: 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.</p> + </li> + + <li> + <p><tt>COPYING</tt>: Standard GNU GPL.</p> + </li> + + </ul> + + <p>PHP Shell is kindly hosted by SourceForge: <a + href="http://sourceforge.net"><img + src="http://sflogo.sourceforge.net/sflogo.php?group_id=156638&type=4" + alt="SourceForge.net Logo" border="0" height="37" width="125" + /></a></p> + +</body> + +</html> Added: web/htdocs/style.css =================================================================== --- web/htdocs/style.css (rev 0) +++ web/htdocs/style.css 2007-03-17 15:43:42 UTC (rev 29) @@ -0,0 +1,26 @@ + +html { + background-color: darkred; +} + +body { + background-color: white; + font-family: sans-serif; + margin: 0em 5em 0em 5em; + padding: 2em; + text-align: justify; +} + +h1 { + border-bottom: thick solid red; + margin-bottom: 0.1em; +} + + +h2 { + border-bottom: medium solid red; +} + +a { + color: darkred; +} Added: web/push-to-sf.sh =================================================================== --- web/push-to-sf.sh (rev 0) +++ web/push-to-sf.sh 2007-03-17 15:43:42 UTC (rev 29) @@ -0,0 +1,28 @@ +#!/bin/sh +# +# PHP Shell. A shell for command execution on your webserver. +# +# Copyright (C) 2007 Martin Geisler. +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program in the file COPYING; if not, write to the +# Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, +# Boston, MA 02110-1301 USA + +# $Id: push-to-sf.sh 456 2006-11-18 00:08:06Z mgeisler $ + + +# This script logs into SourceForge with SSH and updates the +# Subversion checkout holding the PHP Shell homepage. + +ssh shell.sourceforge.net 'svn update /home/groups/p/ph/phpshell' This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. ------------------------------------------------------------------------- Take Surveys. Earn Cash. Influence the Future of IT Join SourceForge.net's Techsay panel and you'll get the chance to share your opinions on IT & business topics through brief surveys-and earn cash http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV _______________________________________________ phpshell-commits mailing list phpshell-commits@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/phpshell-commits