This first version of manual is still incomplete and only in HTML format. It may be rewritten using XML DTD language, like PHP manual structure.
I'm searching translators for documentation, because I'm Italian and my english is very poor.
abc, abc_a, _abc are valid names for variables;
Abc, aBc_a, abc_ are allowed, but DEPRECATED, names for variables;Variable names that ends with '_' are RESERVED for language optimizations.
func(), funcOpt() are valid names for functions;
Func(), FuncOpt() are allowed, but DEPRECATED, names for functions;Function names that starts with '_' are RESERVED for language optimizations.
pers_func(), pers_funcOpt() are functions of the pers module;
if, next, var, while etc...
#include, #php, #/php etc...
var varname;
array arrname;
set varname;
Example:Any variable is destroyed at the end of the page.
// this variable is visible globally in the page: var a; if ( ... ) { // this variable is visible only in this block: var b; // 'a' variable is more visible... } // 'b' variable is no more visible...
Example:Only variant variables can be declared globals.
// this variable is valid globally in all the pages of your project: global var a;
Example:Parameters are defined in anoter page and passed to your page via a POST or GET FORM.
// this is a parameter: parameter var x;
function funcName( arg1, arg2, ... )You can't declare a function inner another.
{
function code}
return value;
function funcName( arg1, arg2, ... ) is expression;
if ( condition )The condition is an expression returning a boolean value.
{
...true statements...}
else
{
...conditional false statements...}
<% if ( condition ): %>
...true statements...<% else: %>
...conditional false statements...<% endif; %>
switch ( condition )The condition is an expression returning a value.
{
case fixed-value:}
// this code is executed if condition equals fixed-value...case...:
// another case code...default:
<% switch ( condition ):
case fixed-value: %><% endswitch; %>
...case statements...<% default: %>
...default statements...
while ( condition )The loop statements are executed while condition is TRUE.
{
...loop statements...}
<% while ( condition ): %>
...loop statements...<% endwhile; %>
foreach ( arrayname as varname )The loop statements are executed for every value present in array.
{
...loop statements...}
<% foreach ( arrayname as varname ): %>
...loop statements...<% endforeach; %>
foreach ( setname as varname1, varname2, ..., varnameN )The loop statements are executed for every result set.
{
...loop statements...}
<% foreach ( setname as varname1, varname2, ..., varnameN ): %>
...loop statements...<% endforeach; %>
break;
transactionThe database access statements are executed like a single transaction (when supported by the driver).
{
...database access statements...}
Example:Comments aren't passed to the compiled file.
// this is a single line comment /* this is a multi line comment... ............................... */
#selfRepresent the complete name of the page (with extension) is compiling.
#aspTo include ASP source code directly in your pages.
...asp code...
#/asp
#jspTo include JSP source code directly in your pages.
...jsp code...
#/jsp
#phpTo include PHP source code directly in your pages.
...php code...
#/php
#include "filename"This a Server Side Include directive.
#include <modulename>The modulename MUST be a fixed value (can't be a variable) WITHOUT any extension. The extension will be added later by the lisa compiler.
<db-dsn> data source name </db-dsn>This is the database dsn.
<db-host> host name </db-host>This is the database server hostname. You can specify the full URL name or the static IP address.
Leaving this field blank will automatically set the IP number 127.0.0.1 (localhost).
<db-name> database name </db-name>This is the database name. This field is obligatory.
<db-password> password </db-password>This is the password used connecting to database.
<db-port> port number </db-port>This is the database port whitch the server is waiting connections.
Leaving this field blank will automatically set the default port for the specified database type.
<db-type> database type </db-type>This is the database server type you're using. Just enter any of the follow types:
mySql
<db-username> username </db-username>This is the username used connecting to database.
<jdbc> see the follow tags </jdbc>This block contains the JDBC control tags.
<jdbc-driver> driver name </jdbc-driver>This is the class name of the JDBC driver.
<jdbc-string> connection string </jdbc-string>This is the connection string used by the JDBC driver connecting to database.
lisac --module --php modulename.lisaAs you can see, the --module option (or -m in short form) is the way to inform the compiler that you want generate a module, nor the file generated is standard.
#include <modulename>Note that the modulename is specified WITHOUT any extension.
number = arrSize( array )This function return the number of items contained in an array.
string = page( string )This function will return the complete page name (with extension) of the name specified as argument.
number = dtmDay( timestamp )This function return the day number of the month from a timestamp value.
number = dtmMonth( timestamp )This function return the month number from a timestamp value.
timestamp = dtmTimestamp( )This function will return the current Un*x timestamp.
number = dtmYear( timestamp )This function return the year number from a timestamp value.
echo( string )This function will write the message contained in the string to the generated HTML document.
mthRandom( number )This function return a 'random' integer number between 0 and the number specified - 1.
string = strHTML( string )This function replace all HTML special chars with their equivalents for a correct visualization.
In addiction, '\n' (newline) chars are replaced with a "<BR/>" HTML tag.
string = strTrim( string )This function strip blank characters from the init and the end of a string.
boolean = dbEmpty( set )This is a boolean function. It will return a true value if the set contains no data.
set = dbQuery( string )This function will execute a query (contained into string) on the specified database. It will return a set of the results.
This function will block if an error is occured while the query execution.
dbSql( string )This function is similar to dbQuery, but no values will be returned. This can be useful for SQL update statements, like 'INSERT' or 'UPDATE'.