Criando gráficos com a classe JPGraph com PHP

Colaboração: Rodrigo Rosa Fragoso

Data de Publicação: 01 de Dezembro de 2005

O PHP nos oferece diversos recursos para criar e manipular imagens. Entretanto, criar uma imagem de estrutura mais complexa pode ser uma tarefa pouco simples. Para nossa sorte existem classes PHP que facilitam nossa vida. Estaremos apresentando à classe JPGraph do PHP, usada para criar quaisquer tipo de gráfico imaginável.

Antes de mais nada você precisa fazer o download da classe a partir de sua página oficial através da URL: www.aditus.nu/jpgraph. Após feito o download do arquivo - jpgraph-1.19.tar.gz descompacte o seu conteúdo dentro do diretório do Apache. (Ex: C:\Apache\Apache\htdocs\jpgraph-1.19). Para Linux, utilize os seguintes parametros.

  $ tar -zxvf jpgraphx.x.tar.gz

O comando acima criará o diretório jpgraph-x.x com a seguinte estrutura de diretórios:

  ./src arquivos da classe jpgraph
  ./docs manual de uso
  ./README instruções detalhadas sobre instalação
  ./QPL.txt cópia da licença QPL

O diretório ./src, deve estar dentro do diretório do Apache ./htdocs, ou se preferir edite o arquivo php.ini e altere a seguinte linha:

  ;UNIX: "/path1:/path2"
  ;include_path = ".:/php/includes"
  ;Windows: "\path1;\path2"
  ;include_path = ".;c:\php\includes"

Ao reiniciar o Apache a classe jpgraph estará instalada.

Um exemplo simples;

  <?
  header ("Content-type: image/png");
  $imagem = imagecreate (150, 100);
  $corFundo = imagecolorallocate ($imagem, 255, 255, 200);
  $corLinha = imagecolorallocate ($imagem, 0, 0, 0);
  imageline ($imagem, 10, 90, 140, 10, $corLinha);
  imagepng ($imagem);
  ?>

Documentação : http://seuservidor/jpgraph-1.19/docs

Exemplos de gráficos : http://seuservidor/jpgraph-1.19/src/Examples

Ou se preferir : http://www.aditus.nu/jpgraph/documentation.php