Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly
Sign up
Appearance settings

Commit 9e3238e

Browse files
author
R00t-Shell
authored
Update README.md
1 parent 74fe53c commit 9e3238e

File tree

1 file changed

+123
-2
lines changed

1 file changed

+123
-2
lines changed

‎README.md

Lines changed: 123 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,123 @@
1-
# Simple-PHP-Shell-A-Powerful-Yet-Lightweight-PHP-Shell-Script
2-
Discover Simple PHP Shell, a lightweight yet powerful PHP shell script for executing commands, managing files, viewing system info, and more. A detailed guide on installation, usage, and security.
1+
```markdown
2+
# Simple PHP Shell: A Comprehensive Guide
3+
4+
Simple PHP Shell is a lightweight yet powerful PHP script that provides essential shell functionalities directly from a web interface. Whether you need to view system information, manage files, or execute commands, this tool is designed for both beginners and advanced users.
5+
6+
---
7+
8+
## Table of Contents
9+
10+
- [Overview](#overview)
11+
- [Key Features](#key-features)
12+
- [Installation Guide](#installation-guide)
13+
- [Detailed Usage Instructions](#detailed-usage-instructions)
14+
- [1. Viewing System Information](#1-viewing-system-information)
15+
- [2. Directory Navigation & File Management](#2-directory-navigation--file-management)
16+
- [3. Executing Commands and Queries](#3-executing-commands-and-queries)
17+
- [4. Advanced Features](#4-advanced-features)
18+
- [Security Considerations](#security-considerations)
19+
- [License Information](#license-information)
20+
- [Conclusion](#conclusion)
21+
22+
---
23+
24+
## Overview
25+
26+
Simple PHP Shell is a versatile PHP script that allows you to:
27+
- Display the operating system type and PHP version.
28+
- View full PHP configuration using `phpinfo()`.
29+
- Navigate directories and manage files.
30+
- Upload, download, edit, or delete files.
31+
- Execute shell commands and run MySQL queries.
32+
33+
This guide covers everything from installation to secure usage, ensuring even first-time users can operate the tool confidently.
34+
35+
---
36+
37+
## Key Features
38+
39+
- **System Information**: Quickly see your OS type and PHP version.
40+
- **PHP Info Display**: Access a full overview of your PHP configuration.
41+
- **File & Directory Management**: Navigate directories, upload files, and more.
42+
- **Compression & Download**: Compress folders using GZIP and download them.
43+
- **Permission Management**: Easily change folder permissions (e.g., chmod to 777).
44+
- **Database File Highlighting**: Files interacting with databases are highlighted for quick identification.
45+
- **Command Execution**: Run shell commands and execute MySQL queries directly.
46+
47+
---
48+
49+
## Installation Guide
50+
51+
1. **Download the Script**
52+
Visit the [GitHub repository]([https://github.com/heiswayi/simple-php-shell](https://github.com/RootShelll/Simple-PHP-Shell-A-Powerful-Yet-Lightweight-PHP-Shell-Script)) and download the latest version.
53+
54+
2. **Upload to Your Server**
55+
Use FTP or your hosting control panel to upload the script files to a secure directory on your web server.
56+
57+
3. **Set Proper Permissions**
58+
Ensure the directories you wish to manage have the necessary write permissions. Although the script can set folder permissions to 777, use this feature with caution in trusted environments.
59+
60+
4. **Access via Browser**
61+
Open your browser and navigate to the script’s URL (e.g., `http://yourdomain.com/simple-php-shell.php`).
62+
63+
---
64+
65+
## Detailed Usage Instructions
66+
67+
### 1. Viewing System Information
68+
69+
- **Dashboard**: On launch, the interface displays the OS type and PHP version.
70+
- **PHP Info**: Click on the `phpinfo()` button to view detailed PHP configuration.
71+
72+
### 2. Directory Navigation & File Management
73+
74+
- **Directory Listing**: Easily navigate through folders on your server.
75+
- **File Operations**:
76+
- **Upload Files**: Add files to any directory.
77+
- **Download/Compress**: Download individual files or compress entire folders with GZIP.
78+
- **Edit/Delete**: Open files for editing or delete them directly from the interface.
79+
80+
### 3. Executing Commands and Queries
81+
82+
- **Shell Command Execution**: Run system commands directly from your web browser.
83+
- **MySQL Query Execution**: Input and run MySQL queries for database management.
84+
85+
### 4. Advanced Features
86+
87+
- **Database File Highlighting**: Files involved in database interactions are marked (typically in red) to facilitate quick identification.
88+
- **Permission Adjustments**: Use the built-in feature to change directory permissions when troubleshooting.
89+
90+
> **Note:** Always ensure you understand the commands and queries you execute. Improper use can lead to security vulnerabilities or server misconfigurations.
91+
92+
---
93+
94+
## Security Considerations
95+
96+
> **Warning:**
97+
> This script grants significant control over your server. To maintain security, consider the following:
98+
> - Deploy the script in a controlled, secure environment.
99+
> - Change default access credentials, if applicable.
100+
> - Restrict access using server-level protections like `.htaccess`.
101+
> - Disable or remove the script when not in active use.
102+
103+
---
104+
105+
## License Information
106+
107+
Simple PHP Shell is released into the public domain under the [Unlicense](http://unlicense.org). This means you are free to use, modify, and distribute the software for any purpose.
108+
109+
---
110+
111+
## Conclusion
112+
113+
Simple PHP Shell offers a powerful yet straightforward solution for remote server management. Whether you're a developer or system administrator, this tool simplifies file management, command execution, and system diagnostics—all from a user-friendly web interface.
114+
115+
For more details, updates, or to report issues, please visit the [GitHub repository]([https://github.com/heiswayi/simple-php-shell](https://github.com/RootShelll/Simple-PHP-Shell-A-Powerful-Yet-Lightweight-PHP-Shell-Script)).
116+
117+
---
118+
119+
<!-- SEO Meta (visible to crawlers, hidden from regular view) -->
120+
<div style="display:none">
121+
<p>Simple PHP Shell is an open-source PHP script for remote server management, file handling, and command execution. Perfect for developers and system administrators seeking lightweight yet powerful tools.</p>
122+
</div>
123+
```

0 commit comments

Comments
(0)

AltStyle によって変換されたページ (->オリジナル) /