3.6 インストールのトラブルシューティング

ユーザーのうち 99% の方が、何の問題もなくインストールできています。しかし、一部の環境において JpGraph がうまく動作しないこともございます。

多くの場合は、TTF ライブラリのインストールや、GD ライブラリのバージョンが古いことに起因しています。 以下の通り手段を踏むことで、解決を進めてください。

1. 背景画像が表示されない場合（黒い立体ボックスが表示される代わりに）、可能性は GD 2.x は利用可能ですが、jpg-config.inc.php が変更されたのでトゥルー カラーのイメージが無効になったことです。USE_TRUECOLOR 定数を有効にしてください。
2. 背景画像に問題がある場合、USE_GD2_LIBRARY 定数が間違っている可能性があります。例、GD2をインストールしていない場合、この定数を false に設定する必要があります。
3. Windows 2000 と IIS の環境下で動作させており、"Can't find font" エラーが発生する場合は、UNIX 形式で記述されている TTF フォントへのパスを変更してください。ただし、フォント フォルダへのパスは、htdocs からの相対パスではなく、絶対パスで記述する必要があることに注意してください。
4. 画像が表示されなかったり、エラー メッセージがブラウザに送り返されなかった場合、HTTP サーバー のPHP モジュール（例、Apache PHP）に変更があった可能性があります。 これは、PHP のインストールが不完全だったり、True Type ライブラリに問題がある可能性があります。 これらの種類の問題をトラックする最善の方法は、PHP クラッシュの証拠の HTTP サーバー ログ、またはシステム ログを調査することです。他にも、GD ライブラリの自動検出に失敗する可能性があります。 GD1 ライブラリが利用可能で、JpGraph ライブラリが間違って GD2 を検出する場合、まれなケースで PHP にクラッシュします。これを検証するには、USE_GD2_LIBRARY 定数を false にセットしてください。
5. Windows 版で IIS を使っている場合、TTF フォントを使うと空白のページになることがあります。この場合は、jpg-config.php で TTF_DIR パスを手動でセット (通常は C:\WINDOWS\Fonts) してください。
6. キャッシュが有効な場合、キャッシュ デイレクトリの許可が正しく設定されているので、Apache/PHP を起動している処理がキャッシュ デイレクトリに書き込みできることを確認してください。
7. TTF フォントが黄色に表示される場合は、FreeType フォント ライブラリにバグがあります。この場合は、PHP と GD を再インストールする以外に方法がありません。