Axis 2400 - PHP3 GUIDE Bedienungsanleitung

PHP3 Guide

2400/2401/2420

PHP3 Guide

Axis Communications AB does not provide support for application development of any kind. The

information here is provided "as is", and there is no guarantee that any of the examples shown

will work in your particular application.

Revision 0.91 June 2001 1

1WHY PHP? 3

1.1 WHAT IS PHP 4

2PHP3 AND THE VIDEO SERVER 5

3PHP3 SCRIPT 6

3.1 LIMITATIONS 6

3.2 REQUIREMENTS FOR GETTING STARTED: 7

3.3 SCRIPTS 8

3.3.1 COMPLETE SCRIPT EXAMPLES 8

3.3.2 SCRIPT GENERATED BY THE APPLICATION WIZARD 9

3.3.2.1 Get the script that the wizard in the Video Server has created 10

3.3.3 THE TASK-SCHEDULER 12

3.3.3.1 Syntax 13

3.3.3.2 Examples 14

3.3.4 PUT A NEW OR CHANGED SCRIPT INSIDE THE VIDEO SERVER: 14

3.3.5 HOW TO ACTIVATE THE SCRIPTS? 16

3.3.5.1 URL 16

3.3.5.2 Telnet 17

3.3.5.2.1 To enable Telnet support 17

4TROUBLESHOOTING 20

4.1 PHP3 SCRIPT RELATED PROBLEMS 20

4.2 PRODUCT RELATED PROBLEMS 20

5APPENDIX A – INCLUDED APPLICATION 21

5.1 INTRODUCTION 21

5.2 THE SHELL - SH 21

5.2.1 BUILT IN COMMANDS 22

5.3 THE IMAGE-BUFFER - BUFFERD 22

5.3.1 OPTIONS 22

5.3.1.1 By Default 23

5.3.2 EXAMPLES 24

5.4 THE PHP-LIBS 25

5.4.1 ALERT.LIB 25

5.4.2 FTP.LIB 26

5.4.3 LOG.LIB 27

5.4.4 MAIL.LIB 27

5.4.5 PPP.LIB 28

5.4.6 EXAMPLES OF USAGE 30

PHP3 Guide

Axis Communications AB does not provide support for application development of any kind. The

information here is provided "as is", and there is no guarantee that any of the examples shown

will work in your particular application.

Revision 0.91 June 2001 2

6APPENDIX B - SHELL COMMANDS 32

6.1 COMMANDS 32

7APPENDIX C - PHP3 SCRIPT EXAMPLES 35

7.1 SCRIPT EXAMPLES 36

PHP3 Guide

Axis Communications AB does not provide support for application development of any kind. The

information here is provided "as is", and there is no guarantee that any of the examples shown

will work in your particular application.

Revision 0.91 June 2001 3

1 Why PHP?

PHP, which stands for "PHP: Hypertext Preprocessor" was chosen as the scripting

language to use in some Axis Video products since:

! PHP is a well-known and widely used scripting language; in Feb 2001 an

estimate of 23% of all Internet web servers used PHP (nearest "competing" script

language was Perl with about 7%).

! The language syntax closely resembles Java, Perl and C, making it easy to learn

for anyone with basic programming skills.

! Version 3, PHP3 could easily be scaled down to a smaller footprint required for

embedded devices.

! PHP enables the creation of dynamic web pages quickly; the PHP code is simply

embedded into the HTML code. At the most basic level PHP can do anything

that any other scripting language or CGI program can do, such as collect html

form data and generate dynamic page content.

! PHP is a complete scripting language with functionality such as file operations,

network sockets, e-mail client (SMTP) and an FTP client. All very useful in

Network Camera applications.

The integration of event handling in Axis Video products, and a powerful scripting

language such as PHP, gives knowledgeable developers endless opportunities to tailor

the functionality of Axis Video products to fit their specific needs.

PHP3 Guide

Axis Communications AB does not provide support for application development of any kind. The

information here is provided "as is", and there is no guarantee that any of the examples shown

will work in your particular application.

Revision 0.91 June 2001 4

1.1 What is PHP

PHP (officially "PHP: Hypertext Preprocessor") is a server-side HTML-embedded

scripting language.

Simple answer, but what does that mean? An example:

Example 1-1. An introductory example

2 <html>

3 <head>

4 <title>Example</title>

5 </head>

6 <body>

7 <?PHP echo "Hi, I'm a PHP script!"; ?>

8 </body>

9 </html>

Notice how this is different from a CGI script written in other languages like Perl or C

-- instead of writing a program with lots of commands to output HTML, you write an

HTML script with some embedded code to do something (in this case, output some

text). The PHP code is enclosed in special start and end tags that allow you to jump

into and out of PHP mode.

What distinguishes PHP from something like client-side JavaScript is that the code is

executed on the server. If you were to have a script similar to the above on your

server, the client would receive the results of running that script, with no way of

determining what the underlying code may be. You can even configure your web

server to process all your HTML files with PHP, and then there's really no way that

users can tell what you have up your sleeve.

A lot of information about PHP can be found on the Internet:

http://www.PHP.net

PHP3 Guide

Axis Communications AB does not provide support for application development of any kind. The

information here is provided "as is", and there is no guarantee that any of the examples shown

will work in your particular application.

Revision 0.91 June 2001 5

2 PHP3 and the Video Server

Axis has removed some functions from the standard PHP3, and created some

additional functions to suit our products. The name of Axis´ modified version of

PHP3 is called PHP3-Lite. The functions among others, that are removed are those

that handle:

! Database functions

! PDF functions

! Mathematic functions

Axis recommends checking that PHP3-Lite supports the functions required before

creating custom scripts. This can be checked by looking in the PHP3-Lite manual on

our Web site: http://www.axis.com

There are some applications that are shipped with the Axis 2400/2401 products;

besides these applications the additional PHP3-scripts that define extra functions are

explained in Appendix A at the end of this document.

PHP3 Guide

Axis Communications AB does not provide support for application development of any kind. The

information here is provided "as is", and there is no guarantee that any of the examples shown

will work in your particular application.

Revision 0.91 June 2001 6

3 PHP3 script

Before making custom scripts Axis recommends looking at our PHP3-Lite manual

(short description about this on the previous page). You can find the manual on the

Axis Web site:

http://www.axis.com

Note: Axis Communications AB provides no guarantee that any of the examples

shown here will work for a particular application.

Axis Communications AB cannot and will not be held liable for any damage

inflicted to any device as a result of the examples or instructions mentioned in this

document.

Axis Communications AB reserves the right to change this document without prior

notice.

!!! WARNING !!!

Please keep in mind that the manufacturer of the flash chips estimates the

number of writes to the flash chips to about 100,000.

Writing a lot of temporary files to flash must thus be avoided.

Use the ram disk mounted on /tmp instead.

3.1 Limitations

For the moment it is not possible to activate more than one script at a time. So if many

scripts need to be running at the same time, then delay upgrading the Video Server

with Linux!

Note: It´s not possible to downgrade to OSYS again, after having

upgraded to Linux

PHP3 Guide

Axis Communications AB does not provide support for application development of any kind. The

information here is provided "as is", and there is no guarantee that any of the examples shown

will work in your particular application.

Revision 0.91 June 2001 7

3.2 Requirements for getting started:

! Web browser

! FTP Client

! Text Editor

Recommended:

! FTP Server

! SMTP Server

PHP3 Guide

Axis Communications AB does not provide support for application development of any kind. The

information here is provided "as is", and there is no guarantee that any of the examples shown

will work in your particular application.

Revision 0.91 June 2001 8

3.3 Scripts

Tip: A very useful program to fetch or upload a script to the product, is Ultra Edit;

This can be downloaded from the following Web site:

http://www.ultraedit.com/

Tip: To log all possible errors, include the row

error_reporting(E_ALL);

in the script.

Turn off this option with the row:

error_reporting(0);

3.3.1 Complete script examples

It´s possible to create scripts and put them inside the video server. In Appendix C of

this document are complete PHP3 scripts that can be used, which are customized for

the most common applications. To run these scripts a task.list file for each script is

attached (read more about task.list in section 3.3.3). Scripts for the following

applications are available:

! A script that will upload specified images buffers via FTP and the Ethernet

interface.

! A script that will upload specified image buffers via FTP and the Ethernet

interface, and also send a mail as specified

! A script that will upload specified sequential images via FTP and the Ethernet

interface. The uploaded images will be named according to the parameter $suffix.

! A script that will upload specified sequential images via FTP and the Ethernet

interface. The uploaded images will be ordered in a structure defined by their

date.

! A script that will upload specified image buffers via SMTP and the Ethernet

interface.

! A script that will upload specified sequential images via FTP and the Ethernet

interface. The uploaded images will be ordered in a structure defined by their

date. Upon alarm event (indicated by an existing file named according to

$alarm_file) images from the alarm buffers will be uploaded and a mail will be

sent as specified by the appropriate parameters.

How to upload a script to the video server and to run it is shown in section 3.3.4 and

3.3.5.

PHP3 Guide

Axis Communications AB does not provide support for application development of any kind. The

information here is provided "as is", and there is no guarantee that any of the examples shown

will work in your particular application.

Revision 0.91 June 2001 9

3.3.2 Script generated by the Application Wizard

The wizard in the video server can generate the most basic scripts, and these can then

be extended and modified to fit a particular applications needs though Axis

recommends creating the scripts from scratch and putting them inside the video

server. How to accomplish the above, follow the instructions on the next page.

Dieses Handbuch passt für folgende Modelle

Inhaltsverzeichnis

Andere Axis Server Handbücher

Axis

Axis Q7900 Rack Bedienungsanleitung

Axis

Axis Camera Station S1216 Tower Bedienungsanleitung

Axis

Axis 2400+ Bedienungsanleitung

Axis

Axis E100 Bedienungsanleitung

Axis

Axis Camera Station S12 Series Bedienungsanleitung

Axis

Axis 243SA Bedienungsanleitung

Axis

Axis Video Server 242S IV Bedienungsanleitung

Axis

Axis AXIS 243Q Blade Bedienungsanleitung

Axis

Axis 7000 Bedienungsanleitung

Axis

Axis Q7424-R Mk II Bedienungsanleitung

Axis

Axis 27756R1 Bedienungsanleitung

Axis

Axis 950 Bedienungsanleitung

Axis

Axis 2411 Bedienungsanleitung

Axis

Axis 7000 Bedienungsanleitung

Axis

Axis 700 Bedienungsanleitung

Axis

Axis Audio Manager Pro C7050 Mk III Bedienungsanleitung

Axis

Axis AXIS 243Q Blade Bedienungsanleitung

Axis

Axis 2490 Bedienungsanleitung

Axis

Axis AXIS 240 Bedienungsanleitung

Axis

Axis Developer Board and Device Server AXIS 82+ Bedienungsanleitung

Axis

Axis 700 Kurzanleitung zur Einrichtung

Axis

Axis 7100 Bedienungsanleitung

Axis

Axis AXIS 243Q Blade Bedienungsanleitung

Axis

Axis 240Q Blade Bedienungsanleitung

Beliebte Server Handbücher anderer Marken

HP AlphaServer ES47 Bedienungsanleitung

Dell

Dell PowerEdge R410 Bedienungsanleitung

PowerNAS

PowerNAS CMA Bedienungsanleitung

Supero

Supero FatTwin F617R3-FT Bedienungsanleitung

MSI

MSI P1-109N-L70 Bedienungsanleitung

Dell

Dell PowerEdge XE9640 Handbuch

Dell

Dell PS4100 Montageanleitung

EtroVISION

EtroVISION EV3151 Bedienungsanleitung

NEC

NEC Express5800/T110j Bedienungsanleitung

HP ProLiant Gen9 Bedienungsanleitung

Compaq

Compaq ProLiant 3000 Handbuch

Dell

Dell PowerEdge 3YPMN Bedienungsanleitung

iRobo

iRobo IPC2U Bedienungsanleitung

Nortel

Nortel 1000 Con?guration guide Bedienungsanleitung

Asus

Asus AP7500 Bedienungs- und Wartungshandbuch

Avid Technology

Avid Technology AirSpeed 5000 Bedienungsanleitung

HP Integrity rx2600 Installationsanleitung

Milestone

Milestone Husky IVO 350T Bedienungsanleitung