Download the PHP package spiral/app-keeper without Composer

Rapid Admin Panel Application Skeleton

Spiral Framework is a High-Performance PHP/Go Full-Stack framework and group of over sixty PSR-compatible components. The Framework execution model based on a hybrid runtime where some services (GRPC, Queue, WebSockets, etc.) handled by Application Server RoadRunner and the PHP code of your application stays in memory permanently (anti-memory leak tools included).

App Skeleton (CLI, GRPC) | Documentation | Twitter | Contributing

Server Requirements

Make sure that your server is configured with following PHP version and extensions:

• PHP 8.0+, 64bit
• mb-string extension
• PDO Extension with desired database drivers (default SQLite)
• For FrontEnd build yarn and nodejs are required.

Application Bundle

Application bundle includes the following components:

• High-performance HTTP, HTTP/2 server based on RoadRunner
• Console commands via Symfony/Console
• Translation support by Symfony/Translation
• Queue support for AMQP, Beanstalk, Amazon SQS, in-Memory
• Stempler template engine
• Security, validation, filter models
• PSR-7 HTTP pipeline, session, encrypted cookies
• DBAL and migrations support
• Monolog, Dotenv
• Prometheus metrics
• Cycle DataMapper ORM
• Keeper Admin panel

Demo Screenshot

Installation

Application server will be downloaded automatically (php-curl and php-zip required).

Once the application is installed you can ensure that it was configured properly by executing:

Migrate the database:

Seed user accounts:

Create super admin account:

To start application server execute:

On Windows:

Application will be available on http://localhost:8080. Keeper control panel available at http://localhost:8080/keeper.

Read more about application server configuration here. Make sure to turn DEBUG off in .env to enable view caching.

Testing:

To test an application:

Cloning:

Make sure to properly configure project if you cloned the existing repository.

Make sure to create super-admin account.

Docker:

Requirements: Docker engine 19.03.0+

To launch Keeper in Docker create env file if needed.

Build and run for Linux and MacOS

Build and run for Windows

It will build a local container, configure encryption key and set up Sqlite database.

Docker scenarios

In this repository you can find several docker-compose files, you can use them in combination to handle different scenarios.

You can launch Spiral application with Roadrunner in one container and frontend build with Nginx in another (it will serve static files and proxy dynamic requests to application container). No file sync, no worker reload: will work with the code version you have on the moment of container build on http://localhost:8080

Or just

Docker local development

For local development you would like file changes to appear in a container, and make Roadrunner workers to re-launch with updated code.

Make sure you have vendor directory copied on host machine in this case, otherwise you'll mount code without vendor and autoload into a container and it will not work. You can do it like this:

Custom Frontend Build

For local development add one more docker compose file to sync local files into Nginx container:

In this case you will need to run yarn build locally to create frontend build, otherwise empty directory public/generated will be mounted in nginx container

Frontend local development is supported in 2 modes:

1. Watch mode.

Launch yarn watch to watch ./front directory for changes and recompile them on go. Refresh page to see changes.

2. Hot reload mode.

Set up env variable FRONT_END_PUBLIC_URL to point at local server URL, this package is configured to use http://localhost:3030 Change scripts in webpack and server folders to change that.

After that launch yarn start. This will start dev server at http://localhost:3030

If you are seeing 404 on your scripts, ensure they are included like so

Local development for both frontend and backend

To enable all file sync you'll need all docker-compose files at once:

License:

MIT License (MIT). Please see Spiral Scout.