3.10. PHPドライバ

3.10.1. 使用方法

PHP用ドライバはCopper PDF本体とは別に配布されています。 http://sourceforge.jp/projects/copper/releases/?package_id=8743 から cti-php-2.x.x ダウンロードしてください。 アプリケーションは、codeディレクトリをライブラリパスに含め、 require_once ('CTI/DriverManager.php');でドライバを読み込んでください。

// ドライバの読み込み
require_once ('CTI/DriverManager.php');

// セッションの開始
$session = cti_get_session('ctip://localhost:8099/',
	array('user' => 'user',
	'password' => 'kappa'));
	
// 各種操作
...

3.10.2. APIの概要

ここではAPIによるアクセスの概要で説明した各手順に対応する関数を列挙します。 各関数の詳細はapidoc内のAPIドキュメントか、 オンラインのAPIドキュメントを参照してください。

サーバーへの接続・認証

• get_driver($uri)
• get_session($uri, $opts)
• Driver->get_session($uri, $opts)

サーバー情報の取得

• Session->set_server_info($uri)

メッセージハンドラ・プログレスリスナの設定

• Session->set_message_func(&$messageFunc)
• Session->set_progress_func(&$progressFunc)

出力先の設定

• Session->set_results(&$results)
• Session->set_output_as_resource(&$fp)
• Session->set_output_as_file($file)
• Session->set_output_as_directory($dir, [$prefix = ''], [$suffix = ''])
• Session->set_output_as_variable(&$var)

プロパティの設定

• Session->property($name, $value)

ソースリゾルバの設定

• Session->set_resolver_func(&$resolverFunc)

リソースの送信

• Session->start_resource($uri, [$opts = array()])
• Session->end_resource()

本体の送信・変換

• Session->transcode($uri)
• Session->start_main($uri, [$opts = array()])
• Session->end_main()

処理の中断・リセット・通信の終了

• Session->abort($mode)
• Session->reset()
• Session->close()

3.10.3. サンプル

以下は、サーバー側からウェブページへアクセスして変換するサンプルです。

<?php
require_once ('CTI/DriverManager.php');

//セッションの開始
$session = cti_get_session('ctip://localhost:8099/',
	array('user' => 'user',
	'password' => 'kappa'));
	
//ファイル出力
@mkdir($dir, 0777, 'out');
$session->set_output_as_file('out/server-resource.pdf');

//リソースのアクセス許可
$session->property('input.include', 'http://copper-pdf.com/**');
	
//文書の送信
$session->transcode('http://copper-pdf.com/');

//セッションの終了
$session->close();
?>

クライアント側のデータを変換するサンプルを含め、これらのファイルはドライバのsrc/testに収められています。

3.10.4. ソースコード

ドライバのソースコードはSourceForge.JPに公開しています。 ドライバのソースコードが必要な方は、以下のガイドを参考にSVNから取得してください。 http://sourceforge.jp/projects/copper/cvs/

CTI PHPのソースコードのターゲットパスは以下の通りです。 http://svn.sourceforge.jp/svnroot/copper/drivers/php/trunk/