PHPackages                             superterran/magento-phpserver - 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. [Utility & Helpers](/categories/utility)
4. /
5. superterran/magento-phpserver

ActiveMagento2-module[Utility & Helpers](/categories/utility)

superterran/magento-phpserver
=============================

A component that provides some useful features for local development

00PHP

Since Jun 4Pushed 3y agoCompare

[ Source](https://github.com/superterran/magento-phpserver)[ Packagist](https://packagist.org/packages/superterran/magento-phpserver)[ RSS](/packages/superterran-magento-phpserver/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

magento-phpserver
=================

[](#magento-phpserver)

This magento2 modules provides a series of `bin/magento` commands to manage php's built in webserver for a high-performance local instance for development. This also provides database and elasticsearch through a docker composition that it tries to manage for you.

The major advantage to this approach for local development is that `php` is not containerized, it is instead running directly on the "bare-metal". This means that Magento runs *natively* on the hardware unlocking the full speed potential, and avoids all the docker volume woes in MacOS which make even simple tasks a real hassle. This setup does not use `mutagen`, nor does it rely on volume mounting of any kind for the codebase.

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

[](#installation)

This works like an ordinary magento module, but it requires `php`, `docker` and `docker-compose`.

The author also uses `direnv` to manage the environment variables required for use, check out `.envrc.sample` for defaults.

```
    brew install php@8.1 direnv
```

You can install the `magento-phpserver` package through composer...

```
    composer require --dev superterran/magento-phpserver
    cp vendor/superterran/magento-phpserver/.envrc.sample .envrc && direnv allow
```

Setting Up Magento
------------------

[](#setting-up-magento)

Once installed, run `bin/magneto` to trigger the database and elasticsearch services. These launch as a background process.

```
    bin/magento configure
```

`configure` will trigger `setup:install`. Magento's `setup:install` and create `config.php` and `env.php`. This process isn't destructive to existing data.

In the future, this step will also request a path to a mysql dump for import.

Usage
-----

[](#usage)

Once configured, you should find that `bin/magento` commands will run in your local session. To open a local webserver for local development, simply do the following:

```
    bin/magento serve
```

This will provide a URL (see the `.envrc`) where you can pull up the site in a browser. As php is running "bare-metal" any file-system changes you make will be immediate. To shutdown the backend, simply run:

```
    bin/magneto down
```

PHP Concurrency
===============

[](#php-concurrency)

With somtething like homebrew or phpbrew, this tool can be used between Magento projects with different php versions.

```
    brew install php@7.4 # let's bring in php 7.4
    brew link php@7.4 # let's use it system-wide, useful for magento-cloud-cli

    brew install php@8.1.6 # we want to build our sites using the latest version of php
    cd path/to/8.1-based-project/webroot
```

set `PHPSERVER_PHP_VERSION=8.1.6` in .envrc and run `direnv allow` to update session variables

```
    composer install && bin/magento # commands run in php 8.1!
```

You can still usee global php services written for older versions, such as:

```
    cd ~
    magento-cloud login # runs without warnings in the system-wide 7.4 version
```

Contributions
=============

[](#contributions)

Contributions are welcome! Open an issue if you have a problem or a suggestion, or feel free to fork and open a PR!

###  Health Score

13

—

LowBetter than 1% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity25

Early-stage or recently created project

 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/76271d7ceaafdd2765e6f4d70cacfc9cb3a02927f173f9aa8ee5dc8e4096f0d6?d=identicon)[superterran](/maintainers/superterran)

---

Top Contributors

[![superterran](https://avatars.githubusercontent.com/u/2163715?v=4)](https://github.com/superterran "superterran (1 commits)")

### Embed Badge

![Health badge](/badges/superterran-magento-phpserver/health.svg)

```
[![Health](https://phpackages.com/badges/superterran-magento-phpserver/health.svg)](https://phpackages.com/packages/superterran-magento-phpserver)
```

PHPackages © 2026

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