phpvms/README.md

62 lines
2.3 KiB
Markdown
Raw Normal View History

# phpVMS <sup>7</sup>
2017-06-09 02:28:26 +08:00
2021-01-17 11:15:32 +08:00
[![Build](https://github.com/nabeelio/phpvms/workflows/Build/badge.svg?branch=dev)](https://github.com/nabeelio/phpvms/actions) [![Codacy Badge](https://api.codacy.com/project/badge/Grade/d668bebb0a3c46bda381af16ce3d9450)](https://www.codacy.com/app/nabeelio/phpvms?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=nabeelio/phpvms&amp;utm_campaign=Badge_Grade) [![Latest Stable Version](https://poser.pugx.org/nabeel/phpvms/v/stable)](https://packagist.org/packages/nabeel/phpvms) ![StyleCI](https://github.styleci.io/repos/93688482/shield?branch=dev) [![License](https://poser.pugx.org/nabeel/phpvms/license)](https://packagist.org/packages/nabeel/phpvms)
2017-06-09 02:28:26 +08:00
The next phpvms version built on the laravel framework. work in progress. The latest documentation, with installation instructions is available [on the phpVMS documentation](https://docs.phpvms.net/) page.
2017-06-09 02:28:26 +08:00
## Installation
2017-06-11 21:15:15 +08:00
2017-12-18 01:50:44 +08:00
A full distribution, with all of the composer dependencies, is available at this
2018-02-03 06:18:53 +08:00
[GitHub Releases](https://github.com/nabeelio/phpvms/releases) link.
2017-12-14 10:22:54 +08:00
### Requirements
2017-06-11 21:15:15 +08:00
2020-05-16 06:20:16 +08:00
- PHP 7.3+, extensions:
2018-02-03 06:18:53 +08:00
- cURL
- JSON
- mbstring
- openssl
- pdo
- tokenizer
- Database:
- MySQL 5.5+ (or MySQL variant, including MariaDB and Percona)
2017-06-11 21:15:15 +08:00
[View more details on requirements](https://docs.phpvms.net/requirements)
2017-06-11 21:15:15 +08:00
### Installer
2018-02-03 06:18:53 +08:00
1. Upload to your server
2019-05-11 22:20:05 +08:00
1. Visit the site, and follow the link to the installer
[View installation details](https://docs.phpvms.net/installation/installation)
2019-05-11 22:20:05 +08:00
2021-05-26 03:11:09 +08:00
## Development Environment with Docker
2019-05-11 22:20:05 +08:00
2021-05-26 03:11:09 +08:00
A full development environment can be brought up using Docker, without having to install composer/npm locally
2019-05-11 22:20:05 +08:00
```bash
2021-05-26 03:11:09 +08:00
make docker-test
# **OR** with docker-compose directly
docker-compose -f docker-compose.yml -f docker-compose.local.yml up
2019-05-11 22:20:05 +08:00
```
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
```
2021-05-26 03:11:09 +08:00
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:
```bash
make build-assets
```
This will build all of the assets according to the webpack file.