PHPackages                             futureplc/run-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI & Console](/categories/cli)
4. /
5. futureplc/run-php

AbandonedArchivedLibrary[CLI & Console](/categories/cli)

futureplc/run-php
=================

A PHP command to run PHP.

v1.0.1(1y ago)09MITPHPPHP ^8

Since Aug 30Pushed 1y ago4 watchersCompare

[ Source](https://github.com/futureplc/run-php)[ Packagist](https://packagist.org/packages/futureplc/run-php)[ Docs](https://github.com/futureplc/run-php)[ RSS](/packages/futureplc-run-php/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)DependenciesVersions (3)Used By (0)

Important

"Run PHP" is superceded by [cpx exec](https://github.com/imliam/cpx)

Run PHP
=======

[](#run-php)

[![Latest Version on Packagist](https://camo.githubusercontent.com/291d3e72f05bab489462e0b973f53f4b750068b7fe439223347f5a2e6305584f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f667574757265706c632f72756e2d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/futureplc/run-php)[![Total Downloads](https://camo.githubusercontent.com/b5ffbc88e9efa84655f9156a9cbdb6ab02b381153d76b2515cc2e73795d0b9a2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f667574757265706c632f72756e2d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/futureplc/run-php)

Run PHP is a single command to assist in executing PHP code in a file.

The intention is to make it easier to execute "scratch files" when writing quick-and-dirty code, simply to save a little bit of time. It has 2 primary features that make it more useful than running a plain PHP interpreter:

1. **Automatic Autoloaders** - When running a PHP file, it will automatically detect and use Composer's autoloader if it exists in the current directory or a parent directory
2. **Class Aliasing** - If a class is used in the file that doesn't exist, it will attempt to alias it to a class in the autoloader

Installation
------------

[](#installation)

You can install the package via Composer:

```
composer global require futureplc/run-php
```

Usage
-----

[](#usage)

To run a PHP file with the script, just call the command and pass through a file path as a single argument:

```
run-php /path/to/file/to/run.php
```

License
-------

[](#license)

The MIT License (MIT).

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance35

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity40

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

625d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3e8a14b9f997cf85aacea7d39da9dc33c38cc05fe03360578327ea9bcb25f4d9?d=identicon)[ImLiam](/maintainers/ImLiam)

---

Top Contributors

[![imliam](https://avatars.githubusercontent.com/u/4326337?v=4)](https://github.com/imliam "imliam (2 commits)")

---

Tags

futureplcrun-php

### Embed Badge

![Health badge](/badges/futureplc-run-php/health.svg)

```
[![Health](https://phpackages.com/badges/futureplc-run-php/health.svg)](https://phpackages.com/packages/futureplc-run-php)
```

###  Alternatives

[wp-cli/wp-cli

WP-CLI framework

5.0k17.2M320](/packages/wp-cli-wp-cli)[consolidation/annotated-command

Initialize Symfony Console commands from annotated command class methods.

22569.8M19](/packages/consolidation-annotated-command)[chi-teck/drupal-code-generator

Drupal code generator

26947.8M5](/packages/chi-teck-drupal-code-generator)[seld/cli-prompt

Allows you to prompt for user input on the command line, and optionally hide the characters they type

24725.8M17](/packages/seld-cli-prompt)[illuminate/console

The Illuminate Console package.

12944.1M5.1k](/packages/illuminate-console)[php-tui/php-tui

Comprehensive TUI library heavily influenced by Ratatui

589747.0k6](/packages/php-tui-php-tui)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)