'web developpement made easier'   



Introduction

Installation

Using templates

Using php variables

Calling a php function

The 'func' keyword

Loops

Database access

Handling conditions

Authentification

Installation :

Requirements :

bZ requires perl with Net::FTP to be installed on the system, and generates code that needs php and pear to be installed on the server.

installation

For the time being, bZ does come as avery simple set of files to be downloaded once for each website. One day (soon ?), bZ may come with a clean installation script. Considering the size of the required files, it does not appear as an emergency...
After uncompressing the archive in the directory you wish to work in, the only remaining step is to edit the configuration files.

Configuration :

All the onfiguration that is to be made consists in a modification of the bz.conf file. After the changes are made, run bzinit.pl to ensure that a properly initialized bzmain.php file is put into you script directory. Every time the database access is changed, this script has to be ran again.
Every other option is taken into account at compilation time, while running bzmake.
Here is a list of the available options : (comments can be added in the config file while preceded with // or #)

destination_dir = /usr/var/www/html/       # the folder where to put the compiled site
source_dir = site/sources       # where the uncompiled site is located
code_dir = site/scripts        # all php scripts should be here
styles_dir = site/templates/styles       # the full page templates
cards_dir = site/templates/cards        # the cards templates
work_dir = work_dir       # the working directory : this is where the pre-compiled files are stored and a few useful things for bz too.

valid_extensions = php,html,htm,php3,php4,bcard        # extensions of the files scanned by bz (useful to have several versions of the files eg index.bak will not be parsed)
php_extensions = php,php4,php3,phtml        # extensions of the files considered as php => where to add bz's includes
check_case = true        # enable/disable case check for xhtml

disable_xhtml = false        # enable/disable xhtml check : to use carefully


destination_type = local        #this can be either ftp or local => automatic ftp upload on a remote server
ftp_server = ftp.ftpserver.net       #the name of the ftp server
ftp_password = email@me        #the password required to connect
ftp_login = anonymous        #the login used to connect to the ftp server.

database_server = 127.0.0.1      #the database server used by the website
database_login = root      #user login
database_password =       #user password
database_type = mysql       #database type using PEAR format
auth_database = BZ      #name of the database used for authentification
auth_table_name = auth      #name of the table used for authentification

In a nutshell...

A few basic steps to proceed :
  • uncompress the archive
  • edit the configuration file
  • run the "bzinit.pl" script : this creates a bzmain.php file in the code_dir directory
  • run "bzmake.pl" to compile the site : only the newly modified files and their dependencies are recompiled
  • run "bzmake all" to recompile the all site, in case the bz.conf file was modified.
  • to get rid of all temporary files, delete the work_dir directory

 
Thanks to SourceForge.net Logo for hosting.       webmaster : bzsoft@free.fr