|Classes of Barton Phillips||>||PHP Site Class||>||examples/EXAMPLES.md||>||Download|
This directory has a number of examples of how to use the framework. I put the 'vendor/bartonlp/site-class/includes' directory in the '/var/www' that Apache2 creates when it is installed on a Ubuntu system. By default the Apache2 install makes '/var/www/html' its DocumentRoot (look at '/etc/apache2/sites-enabled/000-default.conf' the default site configuration file).
The following examples are provided.
The examples require '../vendor/bartonlp/site-class/includes/'.
The next example show insertion and updating of the database and 'dbTables' useage. To have this work you must set the permissions and group on the 'test.sdb' table and on the examples directory:
Now the following examples should work. All of the following examples need to be able to update the 'test.sdb' database.
Using Other Libraries
You can use other frameworks or templeting engines. Here we will use Twig a popular templet engine. Twig is a super powerful templet engine with looping and conditional statements and much more. Here we do just about the minimum just as an example.
There is no 'vendor' directory in the examples directory. You will need to run 'composer' to get Twig and Altorouter installed.
ReST Routing with Altorouter
If you need ReST routing (or pretty routing or SEO friendly routing as it is sometime called) you could use one of the popular routing engines available with Meteor, Laravel, Synfony2 or Silex but then again by that point you might as well just bite the bullet and spend the hours or days trying to figure out those frameworks.
There is a pretty simple router called Altorouter which can be used without too much work.
The file 'example-route.php' would normally be your 'index.php' in a production environment. When using a server with Apache2 you would need a '.htaccess' file in the directory where the 'index.php' lives. The '.htaccess' file would look like this:
This says that if the requested filename does not exist go to the 'index.php' file instead.
To test this without renaming the 'example-route.php' you can use the PHP server like this:
The PHP server uses the 'example-route.php' file and you don't need a '.htaccess' file.
Prefixing the command with 'HOME=...' sets the 'HOME' environment variable. Have it point to your 'vendor/autoload.php' file.
Now you can run the program. It will display a table and a form you can use to insert new records. Also a button lets you reset the database table to its original state. If you click on a number in the 'ID' column of the table you get an edit page where you can change the names.
You can also get to the edit page by entering the URI '/edit/3' for example. That will take you to the edit page for 'ID' three. From that page you and enter the URI '/home' which will take you back to the home page.
The advantage of ReST is you do not actually need a '/edit/3' or a '/home' directory on your system. These are just syntactical links to control logic and as a result are easily modified. Also some people think that '/edit/3' somehow looks cooler then '?edit=3', I am not sure I agree. ReST is syntactical sugar that takes more code and obfuscates what is really going on. But that is just my opinion.
Have fun with my mini framework. Get in there and look at the code, there really isn't that much of it. Try it out and if you have any comments or suggestions please let me know.
You can email me at <a href="mailto://firstname.lastname@example.org">email@example.com</a>. My homepage is http://www.bartonphillips.com.