Skip to content

Jacked-PHP/psy-repl

Repository files navigation

Psy REPL

A Simple and Powerful REPL for Laravel Projects

Psy REPL is an interactive shell for Laravel projects, designed to enhance your development experience. Built on top of Native PHP, it offers a seamless interface for testing and debugging your Laravel code in real time.

Key Features

Native PHP Desktop App: A desktop application built with PHP, no need for PHP installation on your machine to run the app.

Interactive Shell: Execute Laravel commands, run code snippets, and test your applications within a dedicated REPL environment.

Cross-Platform Support: Runs effortlessly on any platform, whether you're using Docker or a bare-metal host environment.

Screenshots

Dashboard screen:

Screenshot

REPL screen:

Screenshot

Installation

At this moment it can be built for all platforms, but it is only tested with Linux. Just download form releases and install it.

Setup Instructions for Building and Running the Application

Prerequisites

While you don't need PHP installed on your machine to run the Psy REPL, you do need PHP available in your environment if you wish to develop or use it as a REPL:

  • Docker Users: Ensure PHP is available within your Docker environment.
  • Bare Metal Users: Ensure PHP is installed on your host machine.

Development Setup

To get started with development:

  1. Clone the repository:
    git clone https://github.com/your-repo/psy-repl.git
  2. Install dependencies:
    composer install
  3. Serve the application:
    php artisan native:serve

Building the Application

To build the application for distribution:

  1. Run the build command: (notice that this is an example for linux x64)
    rm -rf vendor node_modules
    composer install
    npm ci
    npm run build
    php artisan native:build linux x64
  2. Find the installable assets in the ./dist directory.

How to set it up

This is a Native PHP project. In other words, it is a desktop app built with PHP. To run it, you don't need to have PHP installed on your machine, but to develop with it, you do. But, for the app to accomplish its goals, because it is a REPL, you need PHP to be available in the environment where you are running it: if docker, to be available in docker, if bare metal, in the host machine.

Contribution

We welcome contributions to Psy REPL! Whether you want to report bugs, suggest new features, or contribute code, we appreciate your involvement.