shawnmccool/jpgraph

jpGraph,用于制作图表和图形的库

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

README

您正在查看版本 ^4 的 README,它需要 PHP v7.0 或更高版本。如果您需要在 PHP 5.6 下运行,请检查 版本 3.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 amenadiel/jpgraph:^4

如何使用

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

示例以与您应使用此库相同的方式进行操作

  • 运行 composer install

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

  • 使用以下片段生成图表

   require_once './vendor/autoload.php';
   use Amenadiel\JpGraph\Graph;
   use Amenadiel\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
  • http://localhost:8000 打开浏览器

更改配置

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

愿望清单

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

jpgraph_logo

许可

FOSSA Status