dappur / dapp
dApp || The Command line interface for the Dappur PHP Framework
Requires
- php: >=5.6
- illuminate/database: ^5.5
- krlove/code-generator: ^1.0
- robmorgan/phinx: ^0.9.1
- symfony/console: ^2.8|^3.0|^4.0
README
This is the command line interface for the Dappur PHP Framework
Pre-Requisites
Composer - Dependency manager is required in order to use the Dappur PHP Framework. Installation Instructions
Phinx - Phinx is required in order to utilize the database migrations. It is recommended that you install Phinx globally via composer by running:
$ composer global require robmorgan/phinx
Installation
$ composer global require dappur/dapp
Usage
new
This command creates a new Dappur application in the specified folder using the composer create-project
command.
- name - The folder name for your new appliciation.
- --theme -t (Optional) - Install a custom frontend theme from a git repo. Default:
git@github.com:dappur/theme-dappur.git
- --dashboard -d (Optional) - Install a custom dashboard theme from a git repo. Default:
git@github.com:dappur/theme-AdminLTE.git
- --vagrant (Optional) - If set, runs
vagrant up
when installation is complete. Default:false
$ dapp new name (--theme=THEME_REPO --dashboard=THEME_REPO --vagrant)
theme
This command allows you to install official and custom themes from git repositories.
- url (Optional) - Git repo url for the theme that you wish to install. If no url is set, you will be presented a list of official themes to install.
- --download-only (Optional) - If set, the theme will be copied into the view folder, but the database will not be updated.
$ dapp theme (url --download-only)
controller
This command generated a new controller class in app/src/Controller
as well as having the controller automatically added to the container dependencies with an entry in app/src/bootstrap/controllers.php
- name - The name of your controller class in
PascalCase
format. This command also supports generating nested class names, i.e.NewController\SubController
.
$ dapp controller name
app
This command generated a new App class template in app/src/App
using the class name that you specify.
- name - The name of your class in
PascalCase
format. This command also supports generating nested class names, i.e.NewController\SubController
.
$ dapp app name
middleware
This command generated a new App class template in app/src/Middleware
using the class name that you specify.
- name - The name of your class in
PascalCase
format. This command also supports generating nested class names, i.e.MyMiddleware\SubMiddleware
.
$ dapp middleware name
twigex
This command generated a new App class template in app/src/TwigExtensions
using the class name that you specify.
- name - The name of your class in
PascalCase
format. This command also supports generating nested class names, i.e.MainExtension\SubExtension
.
$ dapp twigex name
server
This command launches an instance of PHP's built-in web server, php -S
defaulted to port 8181.
- port (Optional) - Port to run the web server on. Default is 8181.
$ dapp server (port=PORT)