aura / system
A full-stack framework system built from Aura library packages.
Installs: 1 224
Dependents: 0
Suggesters: 0
Security: 0
Stars: 63
Watchers: 11
Forks: 11
Open Issues: 0
Type:project
Requires
- aura/autoload: ~1.0
- aura/cli: ~1.0
- aura/di: ~1.0
- aura/filter: ~1.0
- aura/framework: ~1.0
- aura/framework-demo: ~1.0
- aura/http: ~1.0
- aura/input: ~1.0
- aura/installer-system: ~1.0
- aura/intl: ~1.0
- aura/marshal: ~1.0
- aura/router: ~1.0
- aura/session: ~1.0
- aura/signal: ~1.0
- aura/sql: ~1.0
- aura/uri: ~1.0
- aura/view: ~1.0
- aura/web: ~1.0
This package is auto-updated.
Last update: 2024-10-11 03:48:06 UTC
README
The Aura System provides a full-stack Aura framework built around Aura library packages.
Getting Started
Installation
Install via Composer to a {$PROJECT_PATH}
of
your choosing:
composer create-project aura/system {$PROJECT_PATH}
This will create the system skeleton and install all of the necessary packages.
Once you have installed the Aura system, start the built-in PHP server with an Aura.Framework command:
cd {$PROJECT_PATH}
php package/Aura.Framework/cli/server
You can then open a browser and go to http://0.0.0.0:8000 to see the "Hello World!" demo output.
Press Ctrl-C
to stop the built-in PHP server.
Additionally, you can run a command-line test:
cd {$PROJECT_PATH}
php package/Aura.Framework_Demo/cli/hello
You should see "Hello World!" as the output.
Run The Tests
For testing, you need to have PHPUnit 3.7 or later installed.
To run the integration tests for the system as a whole, change to the tests
directory and issue phpunit
:
cd {$PROJECT_PATH}/tests
phpunit
To run the unit tests for a package, change to that package's tests
directory and issue phpunit
:
cd {$PROJECT_PATH}/package/Aura.Autoload/tests
phpunit
Web Server
To run Aura under Apache or another web server, add a virtual host to your web
server configuration, then point its document root to {$PROJECT_PATH}/web
.
If mod_rewrite
or an equivalent module is installed on the server, you will
be able to browse without needing index.php
in the URL.
Remove the Demo Package
When you are satisifed that the installation is working, edit the
composer.json
file to remove the aura/framework-demo
package requirement
and then run composer update
.
System Organization
The system directory structure is pretty straightforward:
{$PROJECT_PATH}/
config/ # mode-specific config files
_mode # the config mode to use
_packages # load these packages in order
default.php # default config
dev.php # shared development server config
local.php # local development server config
prod.php # production config
stage.php # staging config
test.php # testing config
include/ # application include-path directory
package/ # aura-package libraries
tests/ # system tests
tmp/ # temporary files
vendor/ # composer vendors
web/ # web server document root
.htaccess # mod_rewrite rules
cache/ # public cached files
favicon.ico # favicon to reduce error_log lines
index.php # bootstrap script
Writing A Page Controller
Let's create a package and a page controller, and wire it up for browsing. We will do so in a project-specific way, leaving out the complexities of creating an independent package for distribution.
Warning: If you have not removed the
Framework_Demo
package yet, please do so before continuing. Otherwise, your routes will not work correctly.
Create The Controller
Change to the include/
directory and create a location for the example
package and a space for our first web page ...
cd {$PROJECT_PATH}/include
mkdir -p Example/Package/Web/Home
cd Example/Package/Web/Home
... then create a file called HomePage.php
. Add this code for a bare-bones
index action:
<?php namespace Example\Package\Web\Home; use Aura\Framework\Web\Controller\AbstractPage; class HomePage extends AbstractPage { public function actionIndex() { $this->view = 'index'; } } ?>
Create The View
Next, create a view for the index action in a file called views/index.php
and add the following code to it
<?php echo "This is an example home page."; ?>
At this point your include/
directory should look like this:
include/
Example
Package/
Web/
Home/
HomePage.php
views/
index.php
N.b.: Technically you don't need a directory structure this deep. However, a structure like this makes it easy to add new pages as well as other support libraries without having to change the project organization later.
Configure The System
Now we need to wire up the page controller to the autoloader and the routing system. Change to the system config directory:
$ cd {$PROJECT_PATH}/config
Edit the default.php
file and add this code at the end of the file:
<?php // attach the path for a route named 'home' to the controller and action $di->params['Aura\Router\Map']['attach'][''] = [ // all routes with the '' path prefix (i.e., no prefix) 'routes' => [ // a route named 'home' 'home' => [ 'path' => '/', 'values' => [ 'controller' => 'home', 'action' => 'index', ], ], ] ]; // map the 'home' controller value to the controller class $di->params['Aura\Framework\Web\Controller\Factory']['map']['home'] = 'Example\Package\Web\Home\HomePage'; ?>
Try It Out
You should now be able to browse to the /
URL to see "This is an example
home page."