phpvms/README.md

phpVMS ⁷

The next phpvms version built on the laravel framework. work in progress. The latest documentation, with installation instructions is available on the phpVMS documentation page.

Installation

A full distribution, with all of the composer dependencies, is available at this GitHub Releases link.

Requirements

• PHP 8.0+, extensions:
  • cURL
  • JSON
  • mbstring
  • openssl
  • pdo
  • tokenizer
• Database:
  • MySQL 5.5+ (or MySQL variant, including MariaDB and Percona)

View more details on requirements

Installer

1. Upload to your server
2. Visit the site, and follow the link to the installer

View installation details

Development Environment with Docker

A full development environment can be brought up using Docker, without having to install composer/npm locally

make docker-test

# **OR** with docker-compose directly

docker-compose -f docker-compose.yml -f docker-compose.local.yml up

Then go to http://localhost. If you're using dnsmasq, the app container is listening on phpvms.test, or you can add to your /etc/hosts file:

127.0.0.1   phpvms.test

The docker-compose.local.yml overrides the app section in docker-compose.yml. The standard docker-compose.yml can be used if you want to deploy from the image, or as a template for your own Dockerized deployments.

Building JS/CSS assets

Yarn is required, run:

make build-assets

This will build all of the assets according to the webpack file.