{"id":26208180,"url":"https://github.com/douxxtech/remote-php","last_synced_at":"2025-09-18T22:47:40.610Z","repository":{"id":279644257,"uuid":"939487761","full_name":"douxxtech/remote-php","owner":"douxxtech","description":"A remote shell connexion made with php and nodejs","archived":false,"fork":false,"pushed_at":"2025-02-26T16:11:25.000Z","size":20,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-28T19:44:40.883Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/douxxtech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-26T16:10:04.000Z","updated_at":"2025-03-11T15:45:22.000Z","dependencies_parsed_at":"2025-02-26T16:56:35.476Z","dependency_job_id":"553bc6c5-fd73-492e-a8f8-bf103c46a348","html_url":"https://github.com/douxxtech/remote-php","commit_stats":null,"previous_names":["douxxtech/remote-php"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douxxtech%2Fremote-php","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douxxtech%2Fremote-php/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douxxtech%2Fremote-php/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douxxtech%2Fremote-php/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/douxxtech","download_url":"https://codeload.github.com/douxxtech/remote-php/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249066674,"owners_count":21207392,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-12T06:19:57.446Z","updated_at":"2025-09-18T22:47:35.575Z","avatar_url":"https://github.com/douxxtech.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Remote-php\r\n\r\nRemote-php is a simple command-line tool that allows you to execute commands remotely on a PHP server through an interactive terminal interface. It consists of two components:\r\n\r\n1. **remote.php** - The PHP script that runs on your server and executes the commands.\r\n2. **rp** - The Node.js client that connects to the remote PHP server.\r\n\r\n## Features\r\n\r\n- Secure connection using password authentication.\r\n- Supports basic shell commands, including `cd` to change directories.\r\n- Ability to execute shell commands on the remote server.\r\n- Automatically handles the `exit` command to close the session.\r\n- Can be easily set up on any PHP-enabled server.\r\n\r\n## Requirements\r\n\r\n- A server with PHP installed.\r\n- Node.js (for the client-side functionality).\r\n\r\n## Installation\r\n\r\n### 1. Set up the PHP server script:\r\n\r\n- Download the `remote.php` script from the repository or use the provided setup commands.\r\n\r\n### 1. Set up the Node.js client:\r\n\r\n- Ensure you have **Node.js** installed on your local machine.\r\n- Install dependencies by running:\r\n\r\n```bash\r\nnpm install -g remote-php\r\n```\r\n\r\n### 2. Setup the remote.php file\r\n\r\n\u003e You can also use \"remote-php\" instead of \"rp\"\r\n\r\nTo run the server-side script, you'll need to download the remote.php file with the command\r\n```bash\r\nrp server\r\n```\r\n\r\n\r\n- Upload `remote.php` to your server (for example, `http(s)://your-server/remote.php`).\r\n- Set the correct permissions for the file on your server.\r\n- Ensure your server is running PHP and has the required environment for executing the script.\r\n\r\n\r\n### 3. Run the client:\r\n\r\nTo connect to the remote PHP server, run the `remote-php` client with the format:\r\n\r\n```bash\r\nrp \u003cpassword@url\u003e\r\n```\r\n\r\nFor example:\r\n\r\n```bash\r\nnode rp mysecretpassword@http://your-server/remote.php\r\n```\r\n\r\n## Usage\r\n\r\n### Command-Line Interface (CLI)\r\n\r\nOnce connected to the remote PHP server, you can execute shell commands in the terminal. The interface provides:\r\n\r\n- **Password authentication**: You'll need to provide the correct password for the remote connection.\r\n- **Directory navigation**: Use `cd \u003cdirectory\u003e` to change directories on the server.\r\n- **Command execution**: Execute any command that is allowed by the PHP server.\r\n- **Exit**: Type `exit` to close the session.\r\n\r\n### Setting up the remote PHP server\r\n\r\nIf you'd like to download and configure the `remote.php` script, use the following command:\r\n\r\n```bash\r\nrp server\r\n```\r\n\r\nYou will be prompted to enter a password for the server setup, and the script will automatically download and configure the remote.php file for you.\r\n\r\n## Example:\r\n\r\n1. **Run the client:**\r\n\r\n```bash\r\nrp mysecretpassword@http://your-server/remote.php\r\n```\r\n\r\n2. **Execute commands:**\r\n\r\n```bash\r\n[mysecretpassword@remote-php /]$\r\n\u003e ls\r\n```\r\n\r\n3. **Change directory:**\r\n\r\n```bash\r\n[mysecretpassword@remote-php /]$\r\n\u003e cd /var/www\r\n```\r\n\r\n4. **Exit the session:**\r\n\r\n```bash\r\n[mysecretpassword@remote-php /]$\r\n\u003e exit\r\n```\r\n\r\n## License\r\n\r\nThis project is licensed under the **GPL-3.0 License**. See the [LICENSE](LICENSE) file for more details.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdouxxtech%2Fremote-php","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdouxxtech%2Fremote-php","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdouxxtech%2Fremote-php/lists"}