factorenergia/jpgraph

jpGraph,用于制作图表的库

4.1.0-beta.01 2020-01-07 08:18 UTC

README

您正在查看版本 ^4 的 README,它需要 PHP v7.0 或更高版本。如果您需要在 PHP 5.6 下运行,请检查 发布 v3.6

Packagist FOSSA Status

Code Climate Codacy Badge Scrutinizer Code Quality Build Status StyleCI Code Coverage FOSSA Status

长期以来,JpGraph 停滞在版本 3.5.x(见其 README),因此我们决定重构并发布一个具有一些改进的 社区版

  • 该应用程序经过全面重构,增加了命名空间,合理的文件夹层次结构,每个类都单独存放在自己的文件中,并最大限度地减少了 requireinclude 的使用
  • 它需要 PHP 7.0 或更高版本
  • 它提供完整的 composer 兼容性
  • 它具有 PSR-4 自动加载
  • 它进行需求检查,以确保您不会出错
  • 它具有发布标签,这样 composer install 就可以使用您的缓存的包,而不是每次都从 github 拉取
  • 我移除了文档,因为它们在依赖项中是无用的重量。 您可以在这里找到它们
  • 示例文件夹已经上移,尽管它们现在已分类。并非所有示例都能正常工作
  • 指向不在免费工具中存在的功能的示例已被从该文件夹中移除(例如,条形码)
  • 如果找不到选择的字体,则回退到现有字体而不是崩溃
  • 如果您尝试使用当前 GD 安装中不存在的抗锯齿功能,则禁用它而不是崩溃

如何安装

使用 composer

composer require factorenergia/jpgraph:^4

如何使用

请参阅 示例文件夹 以查看工作示例。

这些示例以与您应使用此库相同的方式工作

  • 运行 composer install

  • 在您的脚本顶部 require vendor/autoload.php

  • 使用以下片段生成图表

   require_once './vendor/autoload.php';
   use factorenergia\JpGraph\Graph;
   use factorenergia\JpGraph\Plot;

   // Create the Pie Graph.
   $graph = new Graph\PieGraph(350, 250);
   $graph->title->Set("A Simple Pie Plot");
   $graph->SetBox(true);

   $data = array(40, 21, 17, 14, 23);
   $p1   = new Plot\PiePlot($data);
   $p1->ShowBorder();
   $p1->SetColor('black');
   $p1->SetSliceColors(array('#1E90FF', '#2E8B57', '#ADFF2F', '#DC143C', '#BA55D3'));

   $graph->Add($p1);
   $graph->Stroke();
  • 重要始终在创建内容之前实例化图表(任何类型)。这将加载所有需要的常量到全局作用域。

按照以下步骤查看示例的工作情况

  • 运行 composer install
  • 运行 make startphp -S localhost:8000 -t Examples
  • 在浏览器中打开 https://:8000

更改配置

您可以通过在项目根目录中创建一个 .env 文件来覆盖在 config.inc.php 中设置的某些配置。请参阅 .env.example 作为参考。

愿望清单

  • 使所有示例都工作(其中一半尚未从旧代码转换为新的 PSR-4 格式)
  • 添加更多测试(我们需要测试更多类和方法,以及执行更多当前测试的断言)
  • 添加对 imagick 的替代使用

jpgraph_logo

许可协议

FOSSA Status