PDFlib Text Extraction Toolkit (TET) Manual

3.8 PHP Binding
Installing the TET Edition for PHP. TET is implemented as a C library which can dynamically
be attached to PHP. TET supports several versions of PHP. Depending on the version
of PHP you use you must choose the appropriate TET library from the unpacked
TET archive.
Detailed information about the various flavors and options for using TET with PHP,
including the question of whether or not to use a loadable TET module for PHP, can be
found in the PDFlib-in-PHP-HowTo document which is available on the PDFlib web site.
Although it is mainly targeted at using PDFlib with PHP the discussion applies equally
to using TET with PHP.
You must configure PHP so that it knows about the external TET library. You have
two choices:
> Add one of the following lines in php.ini:
extension=libtet_php.dll
extension=libtet_php.so
extension=libtet_php.sl
extension=libtet_php.dylib
; for Windows
; for Unix
; for HP-UX
; for Mac OS X
PHP will search the library in the directory specified in the extension_dir variable in
php.ini on Unix, and additionally in the standard system directories on Windows.
You can test which version of the PHP TET binding you have installed with the following
one-line PHP script:
This will display a long info page about your current PHP configuration. On this page
check the section titled tet. If this section contains the phrase
PDFlib TET Support
enabled
(plus the TET version number) you have successfully installed TET for PHP.
> Alternatively, you can load TET at runtime with one of the following lines at the start
of your script:
dl("libtet_php.dll");
dl("libtet_php.so");
dl("libtet_php.sl");
dl("libtet_php.dylib");
# for Windows
# for Unix
# for HP-UX
# for Mac OS X
File name handling in PHP. Unqualified file names (without any path component) and
relative file names are handled differently in Unix and Windows versions of PHP:
> PHP on Unix systems will find files without any path component in the directory
where the script is located.
> PHP on Windows will find files without any path component only in the directory
where the PHP DLL is located.
Exception handling. Since PHP 5 supports structured exception handling, TET exceptions
will be propagated as PHP exceptions. You can use the standard try/catch technique
to deal with TET exceptions:
try {
3.8 PHP Binding 29