$hw_modifyobject$connect, $objid, $removearray, $addarray; hw_new_document Syntax int hw_new_document string object record, string document data, int document size, int document size
Trang 1$hw_modifyobject($connect, $objid, $removearray, $addarray);
hw_new_document()
Syntax
int hw_new_document (string object record,
string document data, int document size, int document size)
Description
The hw_new_document() function, which was added in PHP 3.0.3 and PHP 4.0, creates a new Hyperwave document whose data and object record are set to
document_data and object_record , respectively The length of the document_data
has to be specified in the document_size parameter This functions only creates the
document, and does not insert it into the server
hw_objrec2array()
Syntax
array hw_objrec2array (string object record)
Description
The hw_objrec2array() function, which was added in PHP 3.0.3 and PHP 4.0, generates an object array based on the object_record parameter The attribute
names of the object_record are stored as the keys in the array Multiple similar
attributes are placed into a subarray Currently, only the Title, Description,
Group, and Keyword attributes are handled properly
hw_outputdocument()
Syntax
int hw_outputdocument (int hw document)
Description
Trang 2The hw_outputdocument() function, which was added in PHP 3.0.3 and PHP 4.0b1, outputs the document specified by the hw_document parameter excluding the BODY
tag
hw_pconnect()
Syntax
int hw_pconnect (string host, int port, string username, string
password)
Description
The hw_pconnect() function, which was added in PHP 3.0.3 and PHP 4.0, attempts
to make a persistent connection to the specified server using the username and
password parameters for authentication The return value is the connection index if
successful, and FALSE otherwise You can attempt anonymous access by not specifying a username or password Also note that multiple connections can exist at
one time
hw_pipedocument()
Syntax
int hw_pipedocument (int connection, int objectID)
Description
The hw_pipedocument() function, which was added in PHP 3.0.3 and PHP 4.0, returns the Hyperwave document (including anchors) indicated by the objectID parameter The contents will be returned on a special data connection that does not block the control connection
hw_root()
Syntax
int hw_root()
Description
Trang 3The hw_root() function, which was added in PHP 3.0.3 and PHP 4.0, currently always returns 0, which represents the object ID of the hyperroot collection The root collection of the connected server is the child collection of the hyperroot
hw_unlock()
Syntax
int hw_unlock (int connection, int objectID)
Description
The hw_unlock() function, which was added in PHP 3.0.3 and PHP 4.0, releases a lock on the object specified by the objectID parameter so that others may gain
access
hw_who()
Syntax
int hw_who (int connection)
Description
The hw_who() function, which was added in PHP 3.0.3 and PHP 4.0, returns an array listing users currently logged on to the server Each array entry represents a user and contains the elements id, name, system, onSinceDate, onSinceTime,
TotalTime, and self, where self=1 if the entry corresponds to the user who made the hw_who() request
hw_username()
Syntax
string hw_getusername (int connection)
Description
The hw_getusername() function, which was added in PHP 3.0.3 and PHP 4.0, returns the username corresponding to the current connection
Trang 4The PDF library functions enable you to generate PDF documents dynamically from your PHP code The PDF library is available from http://www.pdflib.com It is not freeware, so you should consult the licensing agreement before implementing it in your code To understand the mapping from PHP to the PDF library, you should examine the pdf.c file typically found in the /php-4.x/ext/pdf/ directory Note that the PDF library is not currently available as part of the Windows distribution To include the PDF library, use the following in your configure arguments:
with-pdflib=<directory above /lib/pdflib.so>
with-zlib-dir=<directory above /lib/libz.so
with-jpeg-dir=<directory above /lib/libjpeg.so>
with-png-dir=<directory above /lib/libpng.so
with-tiff-dir=<directory above /lib/libtiff.so>
The PDF library requires the JPEG, PNG, Tiff, and Zlib libraries as indicated by running configure help An alternative to the PDF library is the ClibPDF library documented earlier in this chapter There are licensing differences between the two libraries as well as some feature differences You should consult the documentation that comes with the PDF and ClibPDF libraries for more details
pdf_get_info()
Syntax
info pdf_get_info (string filename)
Description
The pdf_get_info() function, which was added in PHP 3.0.6 and PHP 4.0b1, returns
an empty info structure for a PDF document The info structure can be filled with document details such as subject, author, and so on
pdf_set_info()
Syntax
info pdf_set_info (int pdf_document, string fieldname, string value)
Description
The pdf_set_info() function, which was added in PHP 4.0.1, is used to set the information fields of a PDF document Possible fieldname parameter values include
Trang 5Subject, Title, Creator, Author, Keywords, and one user-defined name This function must be called before pdf_begin_page()
pdf_open()
Syntax
int pdf_open (int file)
Description
The pdf_open() function, which was added in PHP 3.0.6 and PHP 4.0, opens a new PDF document The corresponding file has to be opened with fopen() and the resulting file descriptor passed as the file parameter The return value is used as
an argument to subsequent PDF functions that access the document
pdf_close()
Syntax
void pdf_close (int pdf document)
Description
The pdf_close() function, which was added in PHP 3.0.6 and PHP 4.0, closes the specified pdf_document
pdf_begin_page()
Syntax
void pdf_begin_page (int pdf document, double width, double height)
Description
The pdf_begin_page() function, which was added in PHP 3.0.6 and PHP 4.0, creates
a new page with the dimensions width and height This function must be called at
the beginning of every PDF page
pdf_end_page()