Albert Lea Data Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
<typo fs:xx-large; fw:bold>wwwrig</typo>
====== Introduction ======
This software provides a simple framework for PHP applications. \\
The framework's focus is on simplicity, performance, and flexibility. \\
The software lives at:  [[https://git.albertleadata.org/rk4n3/wwwrig.git]] \\

==== Features ====
  * Lean footprint with minimalist view model
  * Lean DAO model with //**popo** ("plain ol' PHP object")// classes
  * JSON RPC mechanics for service-level API implementation
  * CSS baseline with minimal approximation of Google's Material Design

====== Concepts ======
===== No MVC, at least not really ... =====
The ''wwwrig'' framework, or "the rig", is far too lean to consider the boundary rigidity of MVC preferrable, and with the increasing relevance of responsive UI elements via ECMAscript + service calls, MVP ends up aligning more often.

That said, the rig does encourage a stripped-down model that borrows from both MVC and MVP, in a way that arguably aligns with most of the significant benefit of each, without any of the baggage (complexity, bloat, etc...).

The approach is oriented around taking care of basic entry points, and handing control over to the application's code as soon as possible.

Separation of concern is aided by the availability of a lean DAO mechanism, an equally-lean service API mechanism, and PHP's native ability to transparently inline static HTML.

The end result is a non-invasive foundation for the application that aligns well with, but also doesn't force, whichever aspects of MVC or MVP the programmer wishes to pursue.

===== DAO ... not DOA =====
The rig provides a unique and particularly lean approach to DAO, utilizing a single foundation class that simple and flexible //**popo**// classes can be derived from.

The programmer simply writes such a class, which programmatically defines a property map using simple foundation calls, and then adds any customization required.

For an overwhelming majority of usage, simply defining the property map is enough to get most DAO functionality "for free".

===== Code ... not Config =====
Have you had your fill of wrangling XML into a state that can be used to generate code ?

Do IoC and AOP trigger your SAD and ADHD ?

If so, then you may appreciate the rig's complete avoidance of any such notions.

====== Technical Details ======
The best way into the technical details is to dive into the code !

That said, here's some basics ...

==== Configuration File ====
Here is a sample of what is expected for local configuration,
as should be placed in the web footprint's ''etc/private/localcfg.php'' ...
<WRAP prewrap>
<code>
$pCfg = array(	'db_host' => 'yourdbserver',
		'db_db' => 'yourdbname',
		'db_uid' => 'yourdblogin',
		'db_pwd' => 'yourdbpassword',
		'path_www' => '/full/path/to/document/root',
		'path_app' => 'yourappfile.php',
		'path_pwd' => '/full/path/to/www/etc/private/htpasswd',
		'path_img' => 'img',
		'url_host' => 'www.yourdomain.com',
		'url_app' => 'http://www.yourdomain.com/yourappfile.php',
		'url_secapp' => 'https://www.yourdomain.com/yourappfile.php',
		'url_home' => 'http://www.yourdomain.com',
		'url_content' => 'http://www.yourdomain.com/img',
		'jwt' => 'yoursupersecretkey',
		'rbac' => 'yourRBACRegFunction',
		'ecmakit' => 'yourECMAkitOrigin',
		'ecma' => 'yourECMAkitRegFunction',
		'api' => 'yourapicontext',
	//	'api_auth' => 'true',
		'app_main' => 'lib/view.php',
		'app_pfx' => 'yourappname',
		'app_title' => 'Your App Title',
		'app_slogan' => 'Your App Slogan',
		'app_site_logo' => 'logo-site.png',
		'app_scope' => 'managed',
		'unix_login' => 'yourunixlogin',
		'unix_path' => '/home/yourunixlogin/bin',
		'ldap_host' => 'yourldap.server.com',
		'ldap_group' => 'yourldapgroupforaccess',
		'ldap_udn' => 'dc=yourdomain,dc=com',
		'ldap_bind' => 'uid=%s,%s',
		'ldap_xia' => 'ou=person,dc=yourdomain,dc=com',
		'ldap_filter' => '(&(objectClass=inetOrgPerson)(uid=%s))',
		'ldap_key' => 'ou',
	//	'app_ssnuid' => 'yourapp_adm',
		'bots' => array('bot1'=>'bot1password','abot'=>'abotpassword'),
		'map_emails' => array(	'default' => array( 'L1' => 'EM1'),
					'phone' => array( 'L1' => 'EM2') ) );

//	These are temporarily here for PhpRbac ...
class CfgRBAC {
	const HOST="yourdbhost";		// $host
	const USER="yourdblogin";		// $user
	const PASS="yourdbpassword";	// $pass
	const DBNAME="yourdbname";		// $dbname
	const ADAPTER="mysqli";			// $adapter
	const TABLEPFX="rbac_";			// $tablePrefix
}
</code>
</WRAP>


==== Don't despair, more to come ... ====
This documentation will evolve as needed and as opportunity allows.
Albert Lea Data Wiki

User Tools

Site Tools

Page Tools
