- Introduction
- License
- History
- Compilation & Hosting
- Configuration File
- Modules:
- FAQ
- Links
- Credits
|
Configuring PSP applications
After PSP application is put on web server with the same platform (CPU type + OS) it is ready to run but one thing. PSP applications that use web unit are configured with external configuration file (by defaults called 'psp.conf'). PSP application will search for it in following order:
- In current directory
- In parent directory
- In system directory. On Windows it is Windows directory, on UNIX it is /etc folder.
For further details on configuration file, its syntax and options please see comments in 'psp.conf' which is distributed with PSP (PSP_ROOT/src/conf/psp.conf).
The PSP Configuration File Layout:
General Notes:
The config parser ignores empty lines and lines that begin
with '#'. Configuration variables are defined as name=value
pairs, where spaces between 'name', '=' and 'value' are
ignored. If a value contains spaces it must be quoted like this:
config_name = "value with spaces"
Please make sure this file is accessible from your PSP
applications. PSP looks for it in current program directory,
then in parent directory and then in system-wide path. On
Windows it is your Windows directory, on UNIX-like systems
it is /etc directory.
Headers
Some default headers configuration.
header_charset
Example:
header_charset = iso-8859-1
Output
This section configures program output.
error_reporting
This option configures error reporting option. Error reporting
outputs error message when some problem is encountered. It is
recommended to keep it on for your program to be more verbose
but you can switch it off when you're sure that everything is
clear and you don't want users to see those messages on your
site.
Example:
error_reporting = on
error_halt
This option defines whether program should be halted just
after some problem occurred.
Example:
error_halt = off
output_buffering
Output buffering allows you to modify both header and body
parts of your program output any time you wish. GZIP output
compression also can be used only if output buffering is on.
But it slows down your programs a bit.
Example:
output_buffering = on
output_compression
GZIP output compression saves bandwidth but slows down your
program. It will work only output_buffering is enabled.
Example:
output_compression = on
format_auto_filter
Automatically replaces all HTML-specific characters with HTML
macros, protects from Cross Site Scripting in user variables
while formatting strings and templates
Example:
format_auto_filter = on
Sessions
This section controls session behavior.
session_path
Sessions are stored in single SDS table. You must specify full
path for your session table here. The file will be created
automatically, you just have to ensure that it: 1) can be
created, 2) can be read, 3) can be written - by your PSP apps.
Otherwise PSP will attempt to create it in your system temp
directory (%WINDIR%\Temp\pspsess.sds on Windows and
/tmp/pspsess.sds on UNIX).
Example:
session_path = "c:\temp\sessions\pspsess.sds"
session_life_time
Here you should specify maximal session life time. On each
operation session time is updated. But when session idleness
exceeds this limit, session is removed by garbage collector.
Time is specified in minutes.
Example:
session_life_time = 10
Uploads
This section sets incoming data parameters.
upload_max_size
This parameter specifies the sum size of data (i.e. uploaded
files and form fields) program will receive with POST method.
Size is specified in megabytes
Example:
upload_max_size = 20
|