| ・ |
ドキュメントセンターを初めてご利用する方や運営方針についての基本的な姿勢をご覧になりたい方へ。
|
| ご利用の皆様から多く寄せられる質問にお答えしています。 |
|
| ・ |
ディーエーオフィスなどが利用する用語に関する解説を行います。
|
|
|
|
 | |
PDFlibのインストール |
| PDFlib.tar.gzをDL
cd pdflib/bind
cp c/include/*.h /usr/local/include/
cp c/lib/libpdf.* /usr/local/lib/
cp php/php-4.2.1/libpdf_php.so /usr/local/lib/php/extensions/
php.iniを編集(/usr/local/lib/php.ini)
extension = libpdf_php.so
===================================
Notes on the PDFlib binding for PHP
===================================
The binary distribution of PDFlib supports using PDFlib as a loadable
module (DSO) in PHP. This implies some restrictions, but simplifies PDFlib
deployment a lot. Using PDFlib as a loadable module is the recommended
way for using PDFlib with PHP.
PHPの中でローダブルモジュール(DSO)としてPDFlibを使用するPDFlib支持物の2進法の分配。これはいくつかの制限を意味するが、PDFlib配備を非常に単純化します。ローダブルモジュールとしてPDFlibを使用することは、PHPを備えたPDFlibを使用するための推奨された方法です
If the loadable module does not fit your needs, the binary distribution
also includes a precompiled PDFlib library (libpdf_php.*), to be used in
your custom build process for PHP. This will allow you to integrate PDFlib
(including the PDI functionality) into your own PHP build process.
ローダブルモジュールがあなたのニーズに適合しない場合、2進法の分配はさらにPHPのためにあなたのカスタム構造プロセスの中で使用されるためにプリコンパイルされたPDFlib図書館(libpdf_php。 *)を含んでいます。これは、あなたが自分のPHP構造プロセスへPDFlib(PDI機能性を含んで)を統合することを可能にするでしょう。
Please note that only PDFlib Lite is available in source form.
PDFlib, PDFlib+PDI, and the PDFlib Personalization Server (PPS) are
available for commercial licensing only, and therefore require a
binary package.
PDFlibだけライトが出所の形で利用可能であることに注意してください。PDFlib、PDFlib+PDIおよびPDFlib擬人化サーバー(PPS)は、コマーシャルに利用可能です、許可、だけ、またしたがって2進法のパッケージを要求します。
If your distribution does not contain the expected binaries, please contact
bindings@pdflib.com. We only include binaries for the most common PHP versions
to not overload the download package. Please include the platform and the
exact PHP version you are looking for.
あなたの分配が予期されたbinariesを含んでいない場合は、bindings@pdflib.comと連絡をとってください。私たちは、ダウンロード・パッケージに過負荷をかけないために最も一般的なPHPバージョン用のbinariesを単に含みます。プラットフォーム、および捜している正確なPHPバージョンを含めてください。
Of course you may also use PDFlib for PHP with the source distribution, but
since there are so many PHP configuration options we will only give a rough
overview how to do this.
もちろん、さらに出所分配を備えたPHPのためにPDFlibを使用してもよい、しかし、非常に多くのPHP配置オプションがあるので、私たちは荒い概観を単に与えるでしょう、これをする方法。
Summary of this document:
- "Loadable Module (DSO)"
The recommended way for using PDFlib with PHP.
If you could not find a DSO for your PHP version/platform in the distribution
please contact bindings@pdflib.com.
- "Rebuild PHP"
If the loadable module does not fit your needs, or if DSO modules are not
supported on your platform, you can rebuild PHP with PDFlib support.
Caution: this requires substantially more effort than the loadable module.
- "Samples"
How to set up the supplied PDFlib examples.
Loadable Module
===============
Use the PDFlib loadable module from the "bind/php/" directory
of the PDFlib binary distribution. The name of the loadable module depends
on the platform:
- Windows: libpdf_php.dll
- Linux: libpdf_php.so
- Other Unix systems: libpdf_php.* with the appropriate shared
library suffix
The following conditions must be met in order to use PDFlib as a loadable module:
- PHP on your platform must support DSOs. This is the case on Windows
and many Unix platforms, but not all. For example, PHP does not support
DSO’s on Mac OS X before PHP-4.3.0.
- PDFlib support must not already have been compiled into your PHP version.
If your PHP already includes PDFlib support (this is the case for
versions of PHP distributed with many Linux distributions) you must
rebuild PHP with the "-with-pdflib=no" configure option.
(*HINT* for maintainers of Linux distributions:
include PDFlib support for PHP as DSO, this allows easier updates)
- Several properties of your PHP version must match the loadable module
of PDFlib. The supplied binary modules for PDFlib have been built as
follows:
- nondebug version
- for supported PHP version numbers see "bind/php/
- thread-safe (only relevant for Windows)
If you get an error message similar to the following your PHP version
number does not match that of the PDFlib module:
Warning: pdf: Unable to initialize module
Module compiled with debug=0, thread-safety=1 module API=20001214
PHP compiled with debug=0, thread-safety=1 module API=20001222
Unfortunately new PHP version simply deny loading a wrong module
whithout any specific error message.
All of these options must match.
If you can’t meet the above conditions you must choose to "Rebuild PHP" as
described below (or ask us whether your combination will be available soon).
Installing the module on Windows:
- Our DLLs have been tested with the binary PHP distribution which is
available from http://www.php.net.
- The PDFlib binary distribution for Windows contains several DLLs
for different versions of PHP. Currently we offer the following
flavors:
- "php-4.1.0libpdf_php.dll" was built for PHP 4.1.0/4.1.1/4.2.0
- "php-4.2.1libpdf_php.dll" was built for PHP 4.2.1-4.3.1
- For the PHP installation please follow the documentation of your
PHP distribution and copy "bind/php//libpdf_php.dll"
to the directory which is specified in the "extension_dir" line in
php.ini.
Installing the module on Unix:
- The PDFlib binary distribution for Unix contains several shared libraries
for different versions of PHP. Currently we offer the following
flavors:
- "php-4.1.0libpdf_php.*" was built for PHP 4.1.0/4.1.1/4.2.0
- "php-4.2.1libpdf_php.*" was built for PHP 4.2.1-4.3.1
- Copy the file libpdf_php.* from the directory "bind/php/"
of the PDFlib binary distribution to the directory which is specified in
the "extension_dir" line in php.ini.
Using the module:
- If you decide to load PDFlib each time PHP starts insert one line in
php.ini:
extension=libpdf_php.dll (on Windows)
or
extension = libpdf_php.so (on Unix)
(Note: this requires PHP 4.0.5 or above)
and restart apache, so that the changes are recognized.
You may check whether the installation did work. If you
don’t find a PDF section please check your logfiles for the reason.
- Without the "extension = ..." line in php.ini you must include the
following line in your PHP scripts:
dl("libpdf_php.dll"); (on Windows)
or
dl("libpdf_php.so"); (on Unix)
In this case your php.ini needs these settings:
- php.ini must include the line "safe_mode=Off".
- php.ini must include the line "enable_dl=On".
Rebuild PHP
===========
If the loadable module does not fit your needs, or if DSO modules are not
supported on your platform, you can rebuild PHP with PDFlib support.
WARNING: this option requires substantial experience with building PHP.
It is not a matter of simply calling "make" and waiting for the result.
If you never built PHP from source code it is strongly recommended to
avoid this option.
When recompiling PHP using the library from the binary PDFlib distribution
you have to use the library located in the "bind/c" directory of the PDFlib
distribution.
Note: Building PDFlib for PHP from the source code of PDFlib is not supported
by PDFlib GmbH since we supply precompiled binaries (although it should work,
and therefore you will find hints how to do it below).
Unix
- Unpack the PDFlib binary distribution to ,
or unpack the PDFlib source distribution to , and
issue the command
$ ./configure; make; make install
- Copy some PDFlib support files for PHP to your PHP source tree (check
the section "Support Files" below to see which files apply to your
PHP version.
$ cp /bind/php/ext/pdf/ /ext/pdf
and rebuild the PHP configure script in the PHP directory (only
neccesary if you decided to use our config.m4 script):
$ ./buildconf
- For rebuilding PHP add the following to your PHP configure options:
--with-pdflib=/bind/c
or if building PDFlib from source:
--with-pdflib[=]
where will typically be something like
/usr/local or similar (the directory where "lib" and "include" for PDFlib
reside).
- Now rebuild PHP as usual, and install it.
Windows
- Create PDFlib.lib from the PDFlib sources. Change the project settings
to create a "Multithreaded DLL" library named pdflib.lib.
- Copy the required PDFlib support files (see below) for PHP to your
PHP source tree.
C:> copy indphpextpdf extpdf
- Now rebuild libpdf_php.dll.
Support files
The following files have to be copied from bind/php/ext/pdf to the ext/pdf
directory of your PHP source tree. Replacing config.m4 is optional, but
the config.m4 supplied by us is much simpler and therefor makes less
troubles if you manage to go through the buildconf process.
Which files are needed depends on the PHP version you use:
PHP-4.1.0/4.1.1
config.php-406+.m4 -> config.m4
pdf.c -> pdf.c
php_pdf.h -> php_pdf.h
PHP-4.2.1/4.2.2/4.2.3
config.php-406+.m4 -> config.m4
pdf.c -> pdf.c
php_pdf.h -> php_pdf.h
PHP-4.3.0/4.3.1
pdf.c -> pdf.c
php_pdf.h -> php_pdf.h
Samples
=======
To use the samples:
- Copy some files:
$ cp bind/php/*.php .../htdocs # (to your htdocs directory)
$ cp bind/data/* .../htdocs/data # (to your htdocs)
- point your browser to the sample files
- enjoy the generated PDFs |
| 文書番号 |
00207 |
| 日付 |
2004.01.04 |
| 参照数 |
2233 |
|
