Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/azonmedia/guzaba-platform
Web application development platform based on Guzaba 2 framework, Swoole & Vue
https://github.com/azonmedia/guzaba-platform
application-base php74 swoole vue2
Last synced: 11 days ago
JSON representation
Web application development platform based on Guzaba 2 framework, Swoole & Vue
- Host: GitHub
- URL: https://github.com/azonmedia/guzaba-platform
- Owner: AzonMedia
- License: mit
- Created: 2019-10-09T08:56:41.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2023-07-22T18:19:39.000Z (over 1 year ago)
- Last Synced: 2024-11-15T09:05:58.874Z (about 1 month ago)
- Topics: application-base, php74, swoole, vue2
- Language: PHP
- Homepage: https://azonmedia.github.io/guzaba-platform/
- Size: 2.17 MB
- Stars: 1
- Watchers: 5
- Forks: 0
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Guzaba Platform
## Introduction
[GuzabaPlatform](https://github.com/AzonMedia/guzaba-platform) is a plugin based system for building applications ranging from presentational websites to corporate applications.
It is the testbed for the [Guzaba 2 Framework](https://github.com/AzonMedia/guzaba2).
It uses [Vue.js](https://vuejs.org/) for the frontend.
## Deployment in containers
There is a [docker-compose file](https://github.com/AzonMedia/guzaba-platform/blob/master/app/dockerfiles/GuzabaPlatformDev/docker-compose.yml) with preset environment variables available at [./app/dockerfiles/GuzabaPlatformDev/](https://github.com/AzonMedia/guzaba-platform/tree/master/app/dockerfiles/GuzabaPlatformDev).
Before the application is started it needs to be deployed on the host system in an empty directory with:
```
$ echo "{}">composer.json
$ composer config minimum-stability dev
$ composer require guzaba-platform/guzaba-platform:dev-master
```
This will install GuzabaPlatform and run the GuzabaPlatformInstaller package that will create the needed directories & files in the root of the project.
While the GuzabaPlatform depends on PHP 8.0 and Swoole these requirements are not enforced in the composer.json file as it needs to be possible to bootstrap the application from any environment and the applicattion will be always started in a container which already contains everything needed.
To deploy the application in containers execute:
```
$ ./app/bin/start_containers
```
This will start the following containers:
- swoole (in interactive mode) on port 8081
- redis on port 6379 (exported for debug purpose)
- mysql on port 3306 (exported for debug purpose)
- phpmyadmin on port 8085
- phpredisadmin on port 8086
The login for phpmyadmin is "root" : "somerootpass".
The login for phpredisadmin is "admin" : "admin".
**NOTE - on first run:** On the first start of the application the database needs to be imported in MySQL. This can be done through phpmyadmin or directly over the exposed port 3306.
The database dump is available at [./app/database/guzaba2.sql](https://github.com/AzonMedia/guzaba-platform/blob/master/app/database/guzaba2.sql).
After the containers are started there will be no application running yet on port 8081. This needs to be started manually. To get into the container:
```
$ docker exec -it guzabaplatformdev_swoole_1 /bin/bash
```
If the above command produces an error this is most probably related to the container name. It may differ. To find the correct name list all the running containers with:
```
$ docker ps
```
**NOTE - on first run:** The front end needs to be compiled - inside the container execute:
```
$ cd /home/local/app/public_src
$ ./build_prod
```
There is no need to set up local configuration in the ./app/registry because the [environment file](https://github.com/AzonMedia/guzaba-platform/blob/master/app/dockerfiles/GuzabaPlatformDev/guzaba-platform.env) contains all the needed variables.
To start the application inside the container do:
```
$ /home/local/app/bin/start_server
```
## Direct application startup
There is also a [docker-compose file](https://github.com/AzonMedia/guzaba-platform/blob/master/app/dockerfiles/GuzabaPlatform/docker-compose.yml) allowing the application to be started along with the other containers (instead of starting the swoole container in interactive mode):
```
$ /home/local/app/bin/start_server_in_container
```
## Manual install
```
# require GuzabaPlatform
$ composer require guzaba-platform/guzaba-platform
# Create local configuration
$ cp app/registry/local.php.dist app/registry/local.php
# Build the front end
$ app/public_src/build_prod
```
Change the settings in your ```app/registry/local.php``` so you can connect to the MySQL and to the Redis server.
## Documentation
The complete documentation is available at [Guzaba Platform Documentation](https://github.com/AzonMedia/guzaba-platform-docs).
## Directory structure
- [app](./app) - the Guzaba Platform application
- [vendor](./vendor) - Composer dependencies