PHP PhpSpreadsheet ワークシート上にチャート(グラフ)を作成する方法のバグについて（displayBlanksAs）

2023/11/22

以前、以下の記事などで紹介した内容ですが、PHPのバージョンを「7.4」にアップした時についでにPhpSpreadsheetを「1.25」のバージョンにしたのですが、下のプログラムを実行するとエクセルファイルは作成されますが、チャートはエラーが出て表示されません。
⇒PHP PhpSpreadsheet ワークシート上にチャート(グラフ)を作成する方法について（PhpSpreadsheet\Chart）

該当エクセルファイルを開くとエラーが表示される。

■チャートが表示されないソース

<?php
// ライブラリ読込
require '../vendor/autoload.php';
use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Chart\Chart;
use PhpOffice\PhpSpreadsheet\Chart\DataSeries;
use PhpOffice\PhpSpreadsheet\Chart\DataSeriesValues;
use PhpOffice\PhpSpreadsheet\Chart\PlotArea;
use PhpOffice\PhpSpreadsheet\Chart\Title;
use PhpOffice\PhpSpreadsheet\IOFactory;
 
// Spreadsheetオブジェクト生成
$objSpreadsheet = new Spreadsheet();
// ワークシートオブジェクト取得
$objWorksheet = $objSpreadsheet->getActiveSheet();
//  チャート用テストデータ生成
$objWorksheet->fromArray(
    array(
        array('売上' , 2016, 2017, 2018, 2019, 2020),
        array('商品1',   12,   15,   21,   18,   20),
        array('商品2',   18,   19,   23,   14,   21),   //追加
        array('商品3',   15,   10,   20,   12,   23),   //追加
    )
);
 
//  X軸ラベルの指定
$arrCategorysDataSeries = array(
    new DataSeriesValues(DataSeriesValues::DATASERIES_TYPE_STRING, 'Worksheet!$B$1:$F$1', NULL, 5), //  2016 to 2020
);
//  描画データの指定
$arrDataSeriesValues = array(
    new DataSeriesValues(DataSeriesValues::DATASERIES_TYPE_NUMBER, 'Worksheet!$B$2:$F$2', NULL, 5),  //商品1
    new DataSeriesValues(DataSeriesValues::DATASERIES_TYPE_NUMBER, 'Worksheet!$B$3:$F$3', NULL, 5),  //商品2　追加
    new DataSeriesValues(DataSeriesValues::DATASERIES_TYPE_NUMBER, 'Worksheet!$B$4:$F$4', NULL, 5),  //商品3　追加
);
//  チャート・データシリーズの生成
$objSeries = new DataSeries(
    DataSeries::TYPE_LINECHART,                     // plotType
    NULL,                                           // plotGrouping(DataSeries::GROUPING_STANDARD)
    range(0, count($arrDataSeriesValues) - 1),      // plotOrder
    array(),                                        // plotLabel
    $arrCategorysDataSeries,                        // plotCategory
    $arrDataSeriesValues                            // plotValues
);
 
//  プロットエリアにチャート・データシリーズに設定
$objPlotArea = new PlotArea(NULL, array($objSeries));
 
//  チャート・タイトル生成
$objTitle = new Title('売上データ');
//  チャート生成
$objChart = new Chart(
    'chart1',       // name
    $objTitle,      // title
    NULL,           // legend
    $objPlotArea,   // plotArea
    TRUE,           // plotVisibleOnly
    0,              // displayBlanksAs
    NULL,           // xAxisLabel
    NULL            // yAxisLabel
);
//  ワークシート内のチャート位置設定
$objChart->setTopLeftPosition('A6');        // 左上
$objChart->setBottomRightPosition('G18');   // 右下
 
//  ワークシートにチャート追加
$objWorksheet->addChart($objChart);
 
// [test-g-1-2.xlsx]:Excel2007形式で保存する
$objWriter = IOFactory::createWriter($objSpreadsheet, 'Xlsx');
$objWriter->setIncludeCharts(TRUE);
$objWriter->save('test-g-1-2.xlsx');
exit();
?>

このソースでチャートを表示させるには「チャート生成:new Chart」の引数の中の「displayBlanksAs」を「0」ではなく以下のどれかを指定する必要があります。

■PhpOffice\PhpSpreadsheet\Chart\DataSeries.php 内の宣言

const EMPTY_AS_GAP = 'gap';
const EMPTY_AS_ZERO = 'zero';
const EMPTY_AS_SPAN = 'span';

よって「チャート生成:new Chart」部分のソースは以下の様にします。

//  チャート生成
$objChart = new Chart(
    'chart1',       // name
    $objTitle,      // title
    NULL,           // legend
    $objPlotArea,   // plotArea
    TRUE,           // plotVisibleOnly
    DataSeries::EMPTY_AS_GAP,              // displayBlanksAs
    NULL,           // xAxisLabel
    NULL            // yAxisLabel
);

PhpSpreadsheetの記事の中え「チャート生成:new Chart」の引数の中の「displayBlanksAs」を「0」にしているものがほとんどですので、上記の様に読み替えて下さい。

独習PHP 第4版

本の紹介では...
PHP8の基本構文から、クラス、DB連携、セキュリティ対策まで、しっかり習得。
PHPプログラミングの標準教科書『独習PHP』が、最新のPHP8に対応。
PHPでWebページ／アプリケーションを開発する際に必要な基礎的な知識、
PHPの基本構文から、クラス、データベース連携、セキュリティまで、詳細かつ丁寧に解説します。
...

VB.NET-TIPS などプログラミングについて

■チャートが表示されないソース

■PhpOffice\PhpSpreadsheet\Chart\DataSeries.php 内の宣言

関連する記事

コメント