docs landing page
This commit is contained in:
Nabeel Shahzad
@@ -1,84 +0,0 @@
|
|||||||
# phpvms <sup>7</sup>
|
|
||||||
|
|
||||||
[](https://travis-ci.org/nabeelio/phpvms) [](https://www.codacy.com/app/nabeelio/phpvms?utm_source=github.com&utm_medium=referral&utm_content=nabeelio/phpvms&utm_campaign=Badge_Grade) [](https://packagist.org/packages/nabeel/phpvms) [](https://packagist.org/packages/nabeel/phpvms) [](https://packagist.org/packages/nabeel/phpvms) [](https://packagist.org/packages/nabeel/phpvms)
|
|
||||||
|
|
||||||
The next phpvms version built on the laravel framework. work in progress. If you're looking for
|
|
||||||
the old, phpVMS classic, it's [available here](https://github.com/nabeelio/phpvms_v2).
|
|
||||||
|
|
||||||
# installation
|
|
||||||
|
|
||||||
A full distribution, with all of the composer dependencies, is available at this
|
|
||||||
[tarball link](http://phpvms.net/downloads/phpvms-7.0.0-master.tar.gz). It's currently
|
|
||||||
updated with every commit
|
|
||||||
|
|
||||||
### Composer Access
|
|
||||||
|
|
||||||
run the following commands. for right now, we're running on sqlite. for mysql, set
|
|
||||||
`DB_CONNECTION` to `mysql` in the `env.php` file.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
cp env.php.example env.php
|
|
||||||
composer install --no-interaction
|
|
||||||
php artisan database:create
|
|
||||||
php artisan migrate:refresh --seed
|
|
||||||
```
|
|
||||||
|
|
||||||
then point your webserver to the `/public` folder.
|
|
||||||
|
|
||||||
By default, the Makefile calls the system-wide `composer`. If your host requires a
|
|
||||||
certain path or name for composer, add `COMPOSER=` to the front of the `make` command, e.g:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
COMPOSER=composer.phar make install
|
|
||||||
```
|
|
||||||
|
|
||||||
## development environment
|
|
||||||
|
|
||||||
For development, copy the included `env.php.example` to `env.php` file. By default, it uses sqlite
|
|
||||||
instead of mysql. This makes it much easier to be able to clear the database and new fixtures.
|
|
||||||
|
|
||||||
The easiest way to load locally is to install [Laravel Valet](https://laravel.com/docs/5.5/valet)
|
|
||||||
(if you're running a Mac). Once you install it, go to your phpvms directory, and run:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
cp env.php.example env.php
|
|
||||||
php artisan key:generate
|
|
||||||
make install # this will install everything
|
|
||||||
valet link phpvms
|
|
||||||
```
|
|
||||||
|
|
||||||
Now going to [http://phpvms.dev](http://phpvms.dev) should work. If you want to use mysql,
|
|
||||||
follow the valet directions on installing mysql (`brew install mysql`) and then update the
|
|
||||||
`env.php` file to point to the mysql.
|
|
||||||
|
|
||||||
The default username and password are "admin@phpvms.net" and "admin".
|
|
||||||
To see the available users in the development environment, [see this file](https://github.com/nabeelio/phpvms/blob/master/database/seeds/dev.yml#L10)
|
|
||||||
|
|
||||||
### creating/resetting the environment
|
|
||||||
|
|
||||||
I use Makefiles to be able to quickly setup the environment.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# to do an initial setup of the composer deps and install the DB
|
|
||||||
make install
|
|
||||||
```
|
|
||||||
|
|
||||||
Then to reset the database/clear cache, use:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
make reset
|
|
||||||
```
|
|
||||||
|
|
||||||
### database seeding
|
|
||||||
|
|
||||||
There is a `database/seeds/dev.yml` which contains the initial seed data that can be used
|
|
||||||
for testing. For production use, there is a `prod.yml` file. The `make reset` handles seeding
|
|
||||||
the database with the data from the `dev.yml`.
|
|
||||||
|
|
||||||
# updating
|
|
||||||
|
|
||||||
extract files and run the migrations:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
php artisan migrate
|
|
||||||
```
|
|
||||||
Executable
+42
@@ -0,0 +1,42 @@
|
|||||||
|
# phpvms <sup>7</sup>
|
||||||
|
|
||||||
|
[](https://travis-ci.org/nabeelio/phpvms) [](https://www.codacy.com/app/nabeelio/phpvms?utm_source=github.com&utm_medium=referral&utm_content=nabeelio/phpvms&utm_campaign=Badge_Grade) [](https://packagist.org/packages/nabeel/phpvms) [](https://packagist.org/packages/nabeel/phpvms) [](https://packagist.org/packages/nabeel/phpvms) [](https://packagist.org/packages/nabeel/phpvms)
|
||||||
|
|
||||||
|
The next phpvms version built on the laravel framework. This is a separate version from the old v2/v5 classic version.
|
||||||
|
|
||||||
|
# installation
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
|
||||||
|
- PHP 7.0+, extensions:
|
||||||
|
- cURL
|
||||||
|
- JSON
|
||||||
|
- mbstring
|
||||||
|
- openssl
|
||||||
|
- pdo
|
||||||
|
- tokenizer
|
||||||
|
- Database:
|
||||||
|
- MySQL (or MySQL variant, including MariaDB, Percona)
|
||||||
|
- SQLite (for testing)
|
||||||
|
- Postgres is supported by Laravel but not enabled/tested for phpVMS, yet
|
||||||
|
- Apache or Nginx
|
||||||
|
- Redis (optional, for job queuing, various optimizations)
|
||||||
|
|
||||||
|
## Download
|
||||||
|
|
||||||
|
A full distribution, with all of the composer dependencies, is available at this
|
||||||
|
[tarball link](http://phpvms.net/downloads/phpvms-7.0.0-master.tar.gz). It's currently
|
||||||
|
updated with every commit
|
||||||
|
|
||||||
|
## Upload the files
|
||||||
|
|
||||||
|
If you're on shared hosting, just upload all of the files. If you have your own server, it's
|
||||||
|
recommended to create a vhost that points to the `/public` directory. ([see laravel's installation docs](https://laravel.com/docs/5.5/installation#web-server-configuration))
|
||||||
|
|
||||||
|
## Browse to the site
|
||||||
|
|
||||||
|
Once you browse to the site, you will be given a link to the installer (`/install`) (Note: there
|
||||||
|
isn't a separate `install` folder). If the installation with the vhost and/or htaccess is working
|
||||||
|
correctly, you'll be able to see the installer.
|
||||||
|
|
||||||
|
Follow the instructions to complete the install.
|
||||||
Reference in New Issue
Block a user