Menu
▾
▴
SF.net SVN: phpshell: [29] web
|
From: <mge...@us...> - 2007-03-18 13:35:03
|
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.
|
